REST Resource: mediaItems

Risorsa: PickedMediaItem

Rappresentazione di una foto o di 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 persistente che può essere utilizzato tra le sessioni per identificare questo elemento multimediale.
createTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
type

enum (Type)

Il tipo di questo elemento multimediale.
mediaFile

object (MediaFile)

Il file multimediale che costituisce questo elemento multimediale.

Tipo

Il tipo di 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 sviluppatori.

Ad esempio, '=w2048-h1024' imposterà le dimensioni di un elemento multimediale di tipo foto in modo che abbia una larghezza di 2048 px e un'altezza di 1024 px.
mimeType

string

Il tipo MIME del file multimediale. Ad esempio, image/jpeg.
filename

string

Nome del file multimediale.
mediaFileMetadata

object (MediaFileMetadata)

Metadati relativi al file multimediale, come 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

Marca della videocamera con cui sono stati acquisiti i contenuti multimediali.
cameraModel

string

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

object (PhotoMetadata)

Metadati per un tipo di media fotografico.
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

Numero f di 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 della foto.

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 memorizzato 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 è ancora riproducibile.
READY

L'elaborazione del video è terminata e ora è pronto per essere visualizzato.

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

Metodi

list

 Restituisce un elenco degli elementi multimediali scelti dall'utente durante la sessione specificata.