REST Resource: files

Risorsa: file

Un file caricato nell'API.

Rappresentazione JSON
{
  "name": string,
  "displayName": string,
  "mimeType": string,
  "sizeBytes": string,
  "createTime": string,
  "updateTime": string,
  "expirationTime": string,
  "sha256Hash": string,
  "uri": string,
  "state": enum (State),
  "error": {
    object (Status)
  },

  // Union field metadata can be only one of the following:
  "videoMetadata": {
    object (VideoMetadata)
  }
  // End of list of possible types for union field metadata.
}
Campi
name

string

Immutabile. Identificatore. Il nome della risorsa File. L'ID (nome senza il prefisso "files/") può contenere fino a 40 caratteri alfanumerici minuscoli o trattini (-). L'ID non può iniziare o terminare con un trattino. Se al momento della creazione il nome risulta vuoto, ne verrà generato un nome univoco. Esempio: files/123-456

displayName

string

Campo facoltativo. Il nome visualizzato leggibile per File. Il nome visualizzato non deve superare i 512 caratteri, spazi inclusi. Esempio: "Immagine di benvenuto"

mimeType

string

Solo output. Tipo MIME del file.

sizeBytes

string (int64 format)

Solo output. Dimensioni del file in byte.

createTime

string (Timestamp format)

Solo output. Il timestamp della creazione di File.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo output. Il timestamp dell'ultimo aggiornamento di File.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

expirationTime

string (Timestamp format)

Solo output. Il timestamp di quando File verrà eliminato. Da impostare solo se la scadenza di File è programmata.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

sha256Hash

string (bytes format)

Solo output. Hash SHA-256 dei byte caricati.

Una stringa con codifica Base64.

uri

string

Solo output. L'URI di File.

state

enum (State)

Solo output. Stato di elaborazione del file.

error

object (Status)

Solo output. Stato di errore se l'elaborazione del file non è riuscita.

Campo di unione metadata. Metadati del file. metadata può essere solo uno dei seguenti:
videoMetadata

object (VideoMetadata)

Solo output. I metadati di un video.

VideoMetadata

Metadati di un video: File.

Rappresentazione JSON
{
  "videoDuration": string
}
Campi
videoDuration

string (Duration format)

Durata del video.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

Stato

Stati per il ciclo di vita di un file.

Enum
STATE_UNSPECIFIED Il valore predefinito. Questo valore viene utilizzato se lo stato viene omesso.
PROCESSING Il file è in fase di elaborazione e non può ancora essere utilizzato per l'inferenza.
ACTIVE Il file viene elaborato ed è disponibile per l'inferenza.
FAILED Elaborazione del file non riuscita.

Metodi

delete

Elimina File.

get

Recupera i metadati per l'elemento File specificato.

list

Elenca i metadati per i File di proprietà del progetto richiedente.