Method: albums.batchAddMediaItems

Ajoute à un album un ou plusieurs éléments multimédias de la bibliothèque Google Photos d'un utilisateur. 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 fournis, 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 figurant dans 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.

Les succès partiels ne sont pas acceptés. L'intégralité de la requête échoue si un élément multimédia ou un album spécifié n'est pas valide.

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 du 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. Vous ne pouvez pas ajouter plus de 50 éléments multimédias par appel.

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