Method: albums.batchAddMediaItems

將使用者的 Google 相簿相片庫中的一或多個媒體項目新增至相簿。媒體項目與相簿必須由開發人員透過 API 建立。

媒體項目會新增到相簿結尾。如果提供多個媒體項目，系統會依照此呼叫中指定的順序新增這些項目。

每個相簿最多可包含 20,000 個媒體項目。

只有使用者相片庫中的媒體項目才能新增至相簿。若是共享相簿，相簿必須由使用者所擁有，或者使用者必須以協作者的身分加入相簿。

請注意，系統不支援部分成功。如果指定無效的媒體項目或相簿，整個要求都會失敗。

HTTP 要求

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

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

路徑參數

參數
albumId

string

必要欄位。要新增媒體項目的 Album ID。

要求主體

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

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

string

必要欄位。要新增的 MediaItem 的 ID。一次呼叫最多只能加入 50 個媒體項目。

回應主體

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

授權範圍

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

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