REST Resource: mediaItems

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 (MediaMetadata)
  },
  "contributorInfo": {
    object (ContributorInfo)
  },
  "filename": string
}
Campi
id

string

Identificatore dell'elemento multimediale. Si tratta di un identificatore permanente che può essere utilizzato tra le sessioni per identificare questo elemento multimediale.
description

string

Descrizione dell'elemento multimediale. Questo nome verrà mostrato all'utente nella sezione delle informazioni relativa all'elemento nell'app Google Foto. Deve contenere meno di 1000 caratteri. Includi solo il 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

string

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

string

Un URL che rimanda ai byte dell'elemento multimediale. Questo URL 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, '=w2048-h1024' imposterà le dimensioni di un elemento multimediale di tipo foto su una larghezza di 2048 px e un'altezza di 1024 px.
mimeType

string

Tipo MIME dell'elemento multimediale. Ad esempio, image/jpeg.
mediaMetadata

object (MediaMetadata)

I metadati relativi all'elemento multimediale, ad esempio altezza, larghezza o ora di creazione.
contributorInfo

object (ContributorInfo)

Informazioni sull'utente che ha aggiunto questo elemento multimediale. Tieni presente che questo parametro viene incluso solo quando utilizzi mediaItems.search con l'ID di un album condiviso. L'album deve essere stato creato dalla tua app e devi disporre dell'ambito di condivisione.
filename

string

Nome file dell'elemento multimediale. Viene mostrato all'utente nella sezione delle informazioni dell'elemento nell'app Google Foto.

MediaMetadata

Metadati di un elemento multimediale.

Rappresentazione JSON 
{
  "creationTime": string,
  "width": string,
  "height": string,

  // Union field metadata can be only one of the following:
  "photo": {
    object (Photo)
  },
  "video": {
    object (Video)
  }
  // End of list of possible types for union field metadata.
}
Campi
creationTime

string (Timestamp format)

Ora in cui l'elemento multimediale è stato creato per la prima volta (non quando è stato caricato su Google Foto).

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

string (int64 format)

Larghezza originale (in pixel) dell'elemento multimediale.
height

string (int64 format)

Altezza originale (in pixel) dell'elemento multimediale.
Campo unione metadata. Metadati dell'elemento multimediale specifici per il tipo di media sottostante che rappresenta. metadata può essere solo uno dei seguenti:
photo

object (Photo)

Metadati per un tipo di contenuto multimediale di foto.
video

object (Video)

Metadati per un tipo di media video.

Foto

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

string

Marca della fotocamera con cui è stata scattata la foto.
cameraModel

string

Modello della fotocamera con cui è stata scattata la foto.
focalLength

number

Lunghezza focale dell'obiettivo della fotocamera con cui è stata scattata la foto.
apertureFNumber

number

Il numero f dell'apertura dell'obiettivo della fotocamera con cui è stata scattata la foto.
isoEquivalent

integer

ISO della fotocamera con cui è stata scattata la foto.
exposureTime

string (Duration format)

Tempo di esposizione dell'apertura della fotocamera al momento dello scatto.

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

Video

Metadati specifici di un video, ad esempio FPS e stato di elaborazione. Alcuni di questi campi potrebbero essere nulli o non inclusi.

Rappresentazione JSON 
{
  "cameraMake": string,
  "cameraModel": string,
  "fps": number,
  "status": enum (VideoProcessingStatus)
}
Campi
cameraMake

string

Marca della videocamera con cui è stato registrato il video.
cameraModel

string

Modello della videocamera con cui è stato registrato il video.
fps

number

Frequenza fotogrammi del video.
status

enum (VideoProcessingStatus)

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 Il video è in fase di elaborazione. L'utente vede un'icona per questo video nell'app Google Foto, ma non può ancora riprodurlo.
READY L'elaborazione del video è stata completata e ora è pronto per essere visualizzato. 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 disponi dell'ambito di condivisione.

Rappresentazione JSON 
{
  "profilePictureBaseUrl": string,
  "displayName": string
}
Campi
profilePictureBaseUrl

string

URL dell'immagine del profilo del collaboratore.
displayName

string

Nome visualizzato del collaboratore.

Metodi

batchCreate

 Crea uno o più elementi multimediali nella raccolta di Google Foto di un utente.

batchGet

 Restituisce l'elenco di elementi multimediali per gli identificatori di elementi multimediali specificati.

get

 Restituisce l'elemento multimediale per l'identificatore dell'elemento multimediale specificato.

list

 Elencare tutti gli elementi multimediali dalla raccolta di Google Foto di un utente.

patch

 Aggiorna l'elemento multimediale con il valore id specificato.
Cerca elementi multimediali nella raccolta di Google Foto di un utente.