- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- NewMediaItem
- SimpleMediaItem
- NewMediaItemResult
- Prova!
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 stai creando un elemento multimediale in un album condiviso di cui non sei il proprietario, non sei autorizzato a posizionare l'elemento multimediale. 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 ( |
Campi | |
---|---|
albumId |
Identificatore dell'album in cui vengono aggiunti gli elementi multimediali. Inoltre, gli elementi multimediali vengono aggiunti alla raccolta dell'utente. Questo campo è facoltativo. |
newMediaItems[] |
Obbligatorio. Elenco di elementi multimediali da creare. Massimo 50 elementi multimediali per chiamata. |
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 |
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 ( |
Campi | |
---|---|
newMediaItemResults[] |
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 |
Campi | |
---|---|
description |
Descrizione dell'elemento multimediale. Questo nome verrà mostrato all'utente nella sezione delle informazioni relativa all'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 |
Un nuovo elemento multimediale che è stato caricato tramite l'elemento |
SimpleMediaItem
Un semplice elemento multimediale da creare in Google Foto tramite un token di caricamento.
Rappresentazione JSON |
---|
{ "uploadToken": string, "fileName": string } |
Campi | |
---|---|
uploadToken |
Token che identifica i media byte caricati su Google. |
fileName |
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 superare i 255 caratteri. Questo campo è facoltativo. |
NewMediaItemResult
Risultato della creazione di un nuovo elemento multimediale.
Rappresentazione JSON |
---|
{ "uploadToken": string, "status": { object ( |
Campi | |
---|---|
uploadToken |
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 |
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 |
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. |