將使用者的 Google 相簿相片庫的一或多個媒體項目加入相簿。媒體項目和相簿必須由開發人員透過 API 建立。
媒體項目會新增到相簿的結尾。如果提供多個媒體項目,系統會按照此呼叫中指定的順序加入這些項目。
每本相簿最多可包含 20,000 個媒體項目。
只有使用者媒體庫中的媒體項目可以新增至相簿。如果是共享的相簿,相簿必須是使用者擁有,或是使用者必須是以協作者身分加入相簿。
不支援部分成功。如果指定的媒體項目或相簿無效,整個要求都會失敗。
HTTP 要求
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchAddMediaItems
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
albumId |
必要欄位。媒體項目所新增的 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "mediaItemIds": [ string ] } |
欄位 | |
---|---|
mediaItemIds[] |
必要欄位。要新增的 |
回應主體
如果成功,回應主體會是空白的。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.appendonly
https://www.googleapis.com/auth/photoslibrary.sharing