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