Method: albums.batchAddMediaItems

Ajoute un ou plusieurs éléments multimédias de la bibliothèque Google Photos d'un utilisateur à un album. Les éléments multimédias et les albums doivent avoir été créés par le développeur via l'API.

Les éléments multimédias sont ajoutés à la fin de l'album. Si plusieurs éléments multimédias sont indiqués, ils sont ajoutés dans l'ordre spécifié dans cet appel.

Chaque album peut contenir jusqu'à 20 000 éléments multimédias.

Seuls les éléments multimédias de la bibliothèque de l'utilisateur peuvent être ajoutés à un album. Pour les albums partagés, l'utilisateur doit en être le propriétaire ou y avoir participé en tant que collaborateur.

Le succès partiel n'est pas accepté. L'ensemble de la requête échoue si un élément multimédia ou un album non valide est spécifié.

Requête HTTP

POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
albumId

string

Obligatoire. Identifiant de l'Album auquel les éléments multimédias sont ajoutés.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "mediaItemIds": [
    string
  ]
}
Champs
mediaItemIds[]

string

Obligatoire. Identifiants des MediaItem à ajouter. Le nombre maximal d'éléments multimédias pouvant être ajoutés en un seul appel est de 50.

Corps de la réponse

Si la requête aboutit, le corps de la réponse est vide.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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