REST Resource: mediaItems

Risorsa: PickedMediaItem

Rappresentazione di una foto o di un video scelto da un 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 una sessione e l'altra per identificare questo elemento multimediale.

createTime

string (Timestamp format)

Data e ora di creazione dell'elemento multimediale (non di caricamento 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".

type

enum (Type)

Il tipo di questo elemento multimediale.

mediaFile

object (MediaFile)

Il file multimediale che costituisce l'elemento multimediale.

Tipo

Il tipo di elemento multimediale.

Enum
TYPE_UNSPECIFIED Il tipo non è specificato per impostazione predefinita.
PHOTO L'elemento multimediale rappresenta un fermo immagine.
VIDEO L'elemento multimediale rappresenta un video.

MediaFile

Rappresentazione di un singolo file di media byte.

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

string

Un URL che rimanda ai 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 in modo che abbiano larghezza di 2048 px e altezza di 1024 px.

mimeType

string

Tipo MIME del file multimediale. Ad esempio, image/jpeg.

mediaFileMetadata

object (MediaFileMetadata)

I metadati relativi al file multimediale, ad esempio altezza, larghezza o ora di creazione.

MediaFileMetadata

I 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 fotocamera con cui è stata scattata la foto.

cameraModel

string

Modello della fotocamera con cui è stata scattata la foto.

Campo unione metadata. I metadati del file multimediale specifici del tipo di supporto sottostante che rappresenta. metadata può essere solo uno dei seguenti:
photoMetadata

object (PhotoMetadata)

Metadati per un tipo di contenuto multimediale di foto.

videoMetadata

object (VideoMetadata)

Metadati per un tipo di contenuto multimediale video.

PhotoMetadata

I metadati specifici di una foto, ad esempio l'ISO, la lunghezza focale e il tempo di esposizione. Alcuni di questi campi potrebbero essere nulli o non inclusi.

Rappresentazione JSON
{
  "focalLength": number,
  "apertureFNumber": number,
  "isoEquivalent": integer,
  "exposureTime": string,
  "printMetadata": {
    object (PrintMetadata)
  }
}
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.

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".

printMetadata

object (PrintMetadata)

I metadati relativi alla stampa della foto.

PrintMetadata

I metadati che descrivono le proprietà relative alla stampa di una foto, ad esempio il punteggio di qualità di stampa.

Rappresentazione JSON
{
  "qualityScore": enum (Score)
}
Campi
qualityScore

enum (Score)

Il punteggio di qualità di stampa di una foto, che determina se è valida per la stampa.

Il punteggio non deve essere utilizzato per sconsigliare agli utenti la stampa. Il punteggio è impostato su HIGH se la foto è di alta qualità e l'utente potrebbe volerla stampare. Un punteggio NORMAL indica che la foto potrebbe non essere di alta qualità. SCORE_UNSPECIFIED indica che non è disponibile alcun punteggio.

Punteggio

Un punteggio che descrive l'idoneità alla stampa di una foto.

Enum
SCORE_UNSPECIFIED Il punteggio non è specificato per impostazione predefinita.
HIGH La foto ha un miglior punteggio.
NORMAL La foto ha un punteggio normale.

VideoMetadata

I metadati specifici di un video, ad esempio i fotogrammi al secondo.

Rappresentazione JSON
{
  "fps": number
}
Campi
fps

number

Frequenza fotogrammi del video.

Metodi

list

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