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

Les succès partiels ne sont pas acceptés. La requête entière échouera 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 dans un 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