REST Resource: mediaItems

Risorsa: PickedMediaItem

Rappresentazione di una foto o un video scelto dall'utente.

Rappresentazione JSON 
{
  "id": string,
  "createTime": string,
  "type": enum (Type),
  "mediaFile": {
    object (MediaFile)
  }
}
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.
createTime

string (Timestamp format)

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

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

enum (Type)

Il tipo di questo elemento multimediale.
mediaFile

object (MediaFile)

Il file multimediale che costituisce questo elemento multimediale.

Tipo

Il tipo di un elemento multimediale.

Enum
TYPE_UNSPECIFIED Il tipo non è specificato.
PHOTO L'elemento multimediale rappresenta una foto.
VIDEO L'elemento multimediale rappresenta un video.

MediaFile

Rappresentazione di un file multimediale.

Rappresentazione JSON 
{
  "baseUrl": string,
  "mimeType": string,
  "filename": string,
  "mediaFileMetadata": {
    object (MediaFileMetadata)
  }
}
Campi
baseUrl

string

Un URL per recuperare i byte del file multimediale.

Per scaricare un file multimediale, il client API deve aggiungere a questo URL i parametri specificati nella 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 del file multimediale. Ad esempio, image/jpeg.
filename

string

Nome del file multimediale.
mediaFileMetadata

object (MediaFileMetadata)

Metadati relativi al file multimediale, ad esempio altezza e larghezza.

MediaFileMetadata

Metadati relativi a un file multimediale.

Rappresentazione JSON 
{
  "width": integer,
  "height": integer,
  "cameraMake": string,
  "cameraModel": string,

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

integer

Larghezza originale (in pixel) del file multimediale.
height

integer

Altezza originale (in pixel) del file multimediale.
cameraMake

string

Brand della fotocamera con cui sono stati acquisiti i contenuti multimediali.
cameraModel

string

Modello della fotocamera con cui sono stati acquisiti i contenuti multimediali.
Campo unione metadata. Metadati del file multimediale specifici per il relativo tipo di media. metadata può essere solo uno dei seguenti:
photoMetadata

object (PhotoMetadata)

Metadati per un tipo di media foto.
videoMetadata

object (VideoMetadata)

Metadati per un tipo di media video.

PhotoMetadata

Metadati specifici di una foto, ad esempio ISO, lunghezza focale e tempo di esposizione.

Alcuni di questi campi potrebbero non essere impostati.

Rappresentazione JSON 
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string
}
Campi
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".

VideoMetadata

Metadati specifici di un video. Ad esempio, fps.

Rappresentazione JSON 
{
  "fps": number,
  "processingStatus": enum (VideoProcessingStatus)
}
Campi
fps

number

Frequenza fotogrammi del video.
processingStatus

enum (VideoProcessingStatus)

Stato di elaborazione del video.

VideoProcessingStatus

Stato di elaborazione di un video archiviato in Google Foto.

Enum
UNSPECIFIED Lo stato di elaborazione del video non è specificato.
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 il video è ora pronto per essere visualizzato.

Il tentativo di scaricare un video non in stato READY potrebbe non riuscire.
FAILED Si è verificato un problema e l'elaborazione del video non è riuscita.

Metodi

list

 Restituisce un elenco di elementi multimediali selezionati dall'utente durante la sessione specificata.