Method: mediaItems.batchCreate

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

Questo è il secondo passaggio per la creazione di un elemento multimediale. Per informazioni dettagliate sul passaggio 1, ovvero il caricamento dei byte non elaborati su un server Google, vedi Caricare contenuti multimediali.

Questa chiamata aggiunge l'elemento multimediale alla raccolta. Se viene specificato un album id, la chiamata aggiunge anche l'elemento multimediale all'album. Ogni album può contenere fino a 20.000 elementi multimediali. Per impostazione predefinita, l'elemento multimediale verrà aggiunto alla fine della raccolta o dell'album.

Se sono definiti sia un album id sia la posizione, l'elemento multimediale viene aggiunto all'album nella posizione specificata.

Se la chiamata contiene più elementi multimediali, questi vengono aggiunti nella posizione specificata. Se crei un elemento multimediale in un album condiviso di cui non sei il proprietario, non puoi posizionarlo. In caso contrario, verrà visualizzato un errore BAD REQUEST.

Richiesta HTTP

POST https://photoslibrary.googleapis.com/v1/mediaItems:batchCreate

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "albumId": string,
  "newMediaItems": [
    {
      object (NewMediaItem)
    }
  ],
  "albumPosition": {
    object (AlbumPosition)
  }
}
Campi
albumId

string

Identificatore dell'album in cui vengono aggiunti gli elementi multimediali. Gli elementi multimediali vengono aggiunti anche alla raccolta dell'utente. Questo è un campo facoltativo.
newMediaItems[]

object (NewMediaItem)

Obbligatorio. Elenco di elementi multimediali da creare. Massimo 50 elementi multimediali per chiamata.
albumPosition

object (AlbumPosition)

Posizione nell'album in cui vengono aggiunti gli elementi multimediali. Se non specificato, gli elementi multimediali vengono aggiunti alla fine dell'album (in base al valore predefinito, ovvero LAST_IN_ALBUM). La richiesta non va a buon fine se questo campo è impostato e albumId non è specificato. La richiesta non andrà a buon fine anche se imposti il campo e non sei il proprietario dell'album condiviso.

Corpo della risposta

Elenco di elementi multimediali creati.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "newMediaItemResults": [
    {
      object (NewMediaItemResult)
    }
  ]
}
Campi
newMediaItemResults[]

object (NewMediaItemResult)

Solo output. Elenco di elementi multimediali creati.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing

NewMediaItem

Nuovo elemento multimediale creato nell'account Google Foto di un utente.

Rappresentazione JSON 
{
  "description": string,

  // Union field new_media_item_type can be only one of the following:
  "simpleMediaItem": {
    object (SimpleMediaItem)
  }
  // End of list of possible types for union field new_media_item_type.
}
Campi
description

string

Descrizione dell'elemento multimediale. Viene mostrato all'utente nella sezione delle informazioni dell'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.
Campo unione new_media_item_type. Il nuovo elemento multimediale può essere di vari tipi, a seconda del percorso di caricamento. I caricamenti attualmente supportati utilizzano solo il percorso semplice dell'elemento multimediale. new_media_item_type può essere solo uno dei seguenti:
simpleMediaItem

object (SimpleMediaItem)

Un nuovo elemento multimediale che è stato caricato tramite il uploadToken incluso.

SimpleMediaItem

Un semplice elemento multimediale da creare in Google Foto tramite un token di caricamento.

Rappresentazione JSON 
{
  "uploadToken": string,
  "fileName": string
}
Campi
uploadToken

string

Token che identifica i byte multimediali caricati su Google.
fileName

string

Nome del file con estensione dell'elemento multimediale. Viene mostrato all'utente in Google Foto. Il nome del file specificato durante la procedura di caricamento dei byte viene ignorato se questo campo è impostato. Il nome del file, inclusa l'estensione, non deve contenere più di 255 caratteri. Questo è un campo facoltativo.

NewMediaItemResult

Risultato della creazione di un nuovo elemento multimediale.

Rappresentazione JSON 
{
  "uploadToken": string,
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
Campi
uploadToken

string

Il token di caricamento utilizzato per creare questo nuovo elemento multimediale (semplice). Viene compilato solo se l'elemento multimediale è semplice e richiede un singolo token di caricamento.
status

object (Status)

Se si è verificato un errore durante la creazione di questo elemento multimediale, questo campo viene compilato con le informazioni relative all'errore. Per maggiori dettagli su questo campo, consulta Stato.
mediaItem

object (MediaItem)

Elemento multimediale creato con il token di caricamento. Viene compilato se non si sono verificati errori e l'elemento multimediale è stato creato correttamente.