Method: albums.batchRemoveMediaItems

從指定相簿中移除一或多個媒體項目。媒體項目和相簿必須由開發人員透過 API 建立。

對於共享的相簿，只有使用者新增至相簿的媒體項目，或使用者建立的相簿中的所有媒體項目，才支援這項操作。

系統不支援部分成功。如果指定無效的媒體項目或相簿，整個要求將會失敗，且系統不會對專輯執行任何動作。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
albumId

string

必要欄位。要移除媒體項目的 Album 識別碼。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "mediaItemIds": [
    string
  ]
}
欄位
mediaItemIds[]

string

必要欄位。要移除的 MediaItem 的 ID。

不得包含重複的 ID，也不能為空白。一次呼叫中可移除的媒體項目數量上限為 50 個。

回應主體

如果成功，回應主體會是空白的。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata