Method: albums.batchAddMediaItems

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

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

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

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

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

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

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

參數

參數
`albumId`	`string` 必要欄位。要新增媒體項目的 `Album` ID。

albumId

string

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

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

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

欄位

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

mediaItemIds[]

string

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

如果成功，回應主體會留白。

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

Method: albums.batchAddMediaItems 透過集合功能整理內容 你可以依據偏好儲存及分類內容。