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 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 qui figurent dans la bibliothèque de l'utilisateur peuvent être ajoutés à un album. Pour les albums partagés, l'album doit être détenu par l'utilisateur, ou celui-ci doit avoir rejoint l'album en tant que collaborateur.

Les réussites partielles ne sont pas acceptées. La requête n'aboutira pas 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 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