Risorsa: MediaItem
Rappresentazione di un elemento multimediale (come una foto o un video) in Google Foto.
Rappresentazione JSON |
---|
{ "id": string, "description": string, "productUrl": string, "baseUrl": string, "mimeType": string, "mediaMetadata": { object ( |
Campi | |
---|---|
id |
Identificatore dell'elemento multimediale. Si tratta di un identificatore permanente che può essere utilizzato tra una sessione e l'altra per identificare l'elemento multimediale. |
description |
Descrizione dell'elemento multimediale. Questo nome viene mostrato all'utente nella sezione delle informazioni dell'elemento nell'app Google Foto. Deve contenere meno di 1000 caratteri. Includi solo testo scritto dagli utenti. Le descrizioni devono aggiungere contesto e aiutare gli utenti a comprendere i contenuti multimediali. Non includere stringhe generate automaticamente come nomi file, tag e altri metadati. |
productUrl |
URL di Google Foto per l'elemento multimediale. Questo link è disponibile per l'utente solo se ha eseguito l'accesso. Quando viene recuperato da una ricerca di album, l'URL rimanda all'elemento all'interno dell'album. |
baseUrl |
Un URL che rimanda ai byte dell'elemento multimediale. Non deve essere utilizzato così com'è. I parametri devono essere aggiunti a questo URL prima dell'uso. Per un elenco completo dei parametri supportati, consulta la documentazione per gli sviluppatori. Ad esempio, |
mimeType |
Tipo MIME dell'elemento multimediale. Ad esempio, |
mediaMetadata |
I metadati relativi all'elemento multimediale, ad esempio altezza, larghezza o ora di creazione. |
contributorInfo |
Informazioni sull'utente che ha aggiunto questo elemento multimediale. Tieni presente che è incluso solo quando utilizzi |
filename |
Nome file dell'elemento multimediale. Questa informazione viene mostrata all'utente nella sezione delle informazioni dell'elemento nell'app Google Foto. |
MediaMetadata
Metadati per un elemento multimediale.
Rappresentazione JSON |
---|
{ "creationTime": string, "width": string, "height": string, // Union field |
Campi | |
---|---|
creationTime |
La data e l'ora in cui l'elemento multimediale è stato creato per la prima volta (non quando è stato caricato su Google Foto). Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
width |
Larghezza originale (in pixel) dell'elemento multimediale. |
height |
Altezza originale (in pixel) dell'elemento multimediale. |
Campo di unione metadata . Metadati relativi all'elemento multimediale specifici per il tipo di elemento multimediale sottostante che rappresenta. metadata può essere solo uno dei seguenti: |
|
photo |
Metadati per un tipo di supporto foto. |
video |
Metadati per un tipo di media video. |
Foto
I metadati specifici di una foto, ad esempio ISO, lunghezza focale e tempo di esposizione. Alcuni di questi campi potrebbero essere nulli o non inclusi.
Rappresentazione JSON |
---|
{ "cameraMake": string, "cameraModel": string, "focalLength": number, "apertureFNumber": number, "isoEquivalent": integer, "exposureTime": string } |
Campi | |
---|---|
cameraMake |
Marca della fotocamera con cui è stata scattata la foto. |
cameraModel |
Modello della fotocamera con cui è stata scattata la foto. |
focalLength |
Lunghezza focale dell'obiettivo della fotocamera con cui è stata scattata la foto. |
apertureFNumber |
Numero di apertura dell'obiettivo della fotocamera con cui è stata scattata la foto. |
isoEquivalent |
ISO della fotocamera con cui è stata scattata la foto. |
exposureTime |
Tempo di esposizione dell'apertura della fotocamera al momento dello scatto della foto. Una durata in secondi con un massimo di nove cifre frazionarie, che termina con " |
Video
I metadati specifici di un video, ad esempio f/s e stato di elaborazione. Alcuni di questi campi potrebbero essere nulli o non inclusi.
Rappresentazione JSON |
---|
{
"cameraMake": string,
"cameraModel": string,
"fps": number,
"status": enum ( |
Campi | |
---|---|
cameraMake |
Marca della videocamera con cui è stato registrato il video. |
cameraModel |
Modello della fotocamera con cui è stato registrato il video. |
fps |
Frequenza fotogrammi del video. |
status |
Stato di elaborazione del video. |
VideoProcessingStatus
Stato di elaborazione di un video in fase di caricamento su Google Foto.
Enum | |
---|---|
UNSPECIFIED |
Lo stato di elaborazione del video è sconosciuto. |
PROCESSING |
Elaborazione video in corso. L'utente vede un'icona per questo video nell'app Google Foto, ma il video non può ancora essere riprodotto. |
READY |
L'elaborazione del video è stata completata ed è pronto per la visualizzazione. Importante: il tentativo di scaricare un video non nello stato PRONTO potrebbe non riuscire. |
FAILED |
Si è verificato un problema e l'elaborazione del video non è riuscita. |
ContributorInfo
Informazioni sull'utente che ha aggiunto l'elemento multimediale. Tieni presente che queste informazioni vengono incluse solo se l'elemento multimediale si trova in un album condiviso creato dalla tua app e hai l'ambito di condivisione.
Rappresentazione JSON |
---|
{ "profilePictureBaseUrl": string, "displayName": string } |
Campi | |
---|---|
profilePictureBaseUrl |
URL dell'immagine del profilo del collaboratore. |
displayName |
Nome visualizzato del collaboratore. |
Metodi |
|
---|---|
|
Crea uno o più elementi multimediali nella raccolta di Google Foto di un utente. |
|
Restituisce l'elenco di elementi multimediali per gli identificatori degli elementi multimediali specificati. |
|
Restituisce l'elemento multimediale per l'identificatore dell'elemento multimediale specificato. |
|
Elencare tutti gli elementi multimediali della raccolta Google Foto di un utente. |
|
Aggiorna l'elemento multimediale con il valore id specificato. |
|
Cerca elementi multimediali nella raccolta Google Foto di un utente. |