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 maggiori dettagli sul passaggio 1, relativo al caricamento dei byte non elaborati su un server Google, consulta Caricamento di contenuti multimediali.

Questa chiamata aggiunge l'elemento multimediale alla raccolta. Se un album id è specificato, 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 viene aggiunto alla fine della raccolta o dell'album.

Se id e la posizione di un album sono entrambi definite, 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. Questa operazione genererà un errore di tipo 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 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). Se questo campo è impostato e il valore albumId non è specificato, la richiesta non va a buon fine. La richiesta avrà esito negativo 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 testo scritto dagli utenti. Le descrizioni dovrebbero 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 vario tipo, a seconda del percorso di caricamento. I caricamenti attualmente supportati utilizzano solo il percorso dell'elemento multimediale semplice. new_media_item_type può essere solo uno dei seguenti:
simpleMediaItem

object (SimpleMediaItem)

Un nuovo elemento multimediale che è stato caricato tramite l'elemento 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 media byte caricati su Google.
fileName

string

Nome file con estensione dell'elemento multimediale. Questa informazione viene mostrata all'utente in Google Foto. Se questo campo viene impostato, il nome del file specificato durante il processo di caricamento dei byte viene ignorato. Il nome del file, inclusa l'estensione, non deve contenere più di 255 caratteri. Questo 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). 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 la sezione Stato.
mediaItem

object (MediaItem)

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