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.

Con questa chiamata, l'elemento multimediale viene aggiunto alla raccolta. Se è specificato un album id, la chiamata aggiunge all'album anche l'elemento multimediale. 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 elemento id sia una posizione per l'album, l'elemento multimediale viene aggiunto all'album nella posizione specificata.

Se la chiamata contiene più elementi multimediali, questi vengono aggiunti nella posizione specificata. Se stai creando un elemento multimediale in un album condiviso di cui non sei il proprietario, non hai l'autorizzazione per posizionare l'elemento. Questa operazione comporterà un errore di 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 all'interno dell'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 viene impostato e il valore albumId non viene specificato, la richiesta non riesce. 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. Questo nome 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 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 di 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 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. Il nome file specificato durante il processo di caricamento byte viene ignorato se questo campo viene impostato. Il nome del file, inclusa l'estensione, non deve superare i 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). 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 dell'elemento multimediale, in questo campo vengono visualizzate 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.