Method: albums.batchRemoveMediaItems

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

如果是共享的相簿，只有這位使用者新增至相簿的媒體項目，或是由這位使用者建立的相簿，才能對所有媒體項目執行這項操作。

不支援部分成功。如果指定的媒體項目或相簿無效，整個要求將無法對相簿執行任何動作，

HTTP 要求

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

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

路徑參數

參數
albumId

string

必要欄位。要從媒體項目中移除的 Album ID。

要求主體

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

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

string

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

不得包含重複 ID，且不得留空。一次呼叫最多只能移除 50 個媒體項目。

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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