指定したアルバムから 1 つ以上のメディア アイテムを削除します。メディア アイテムとアルバムは、デベロッパーが API を使用して作成したものである必要があります。
共有しているアルバムの場合、このユーザーがアルバムに追加したメディア アイテムに対してのみこの操作を実行できます。このユーザーが作成したアルバムの場合はすべてのメディア アイテムに対してこの操作を実行できます。
部分的な成功はサポートされていません。無効なメディア アイテムまたはアルバムが指定されている場合、リクエスト全体が失敗し、アルバムに対するアクションは実行されません。
HTTP リクエスト
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchRemoveMediaItems
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
albumId |
必須。メディア アイテムを削除する |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "mediaItemIds": [ string ] } |
フィールド | |
---|---|
mediaItemIds[] |
必須。削除する 繰り返し ID を含めることはできません。また、空白にすることもできません。1 回の呼び出しで削除できるメディア アイテムの最大数は 50 です。 |
レスポンスの本文
成功すると、レスポンスの本文は空になります。
承認スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/photoslibrary