Method: albums.batchRemoveMediaItems

Supprime un ou plusieurs éléments multimédias d'un album spécifié. Les éléments multimédias et l'album doivent avoir été créés par le développeur via l'API.

Pour les albums partagés, cette action n'est disponible que pour les éléments multimédias ajoutés à l'album par cet utilisateur ou pour tous les éléments multimédias si l'album a été créé par cet utilisateur.

Les succès partiels ne sont pas acceptés. Si un élément multimédia ou un album non valide est spécifié, la requête entière échoue et aucune action n'est effectuée sur l'album.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
albumId

string

Obligatoire. Identifiant du Album duquel les éléments multimédias doivent être supprimé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 à supprimer.

Ne doit pas contenir d'identifiants répétés et ne peut pas être vide. Vous ne pouvez pas supprimer 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.edit.appcreateddata