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
  • https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata