從指定相簿移除一或多個媒體項目。媒體項目和專輯必須由開發人員透過 API 建立。
如果是共享的相簿,只有這位使用者新增至相簿的媒體項目,或是由這位使用者建立的相簿,才能對所有媒體項目執行這項操作。
不支援部分成功。如果指定的媒體項目或相簿無效,整個要求將無法對相簿執行任何動作,
HTTP 要求
POST https://photoslibrary.googleapis.com/v1/albums/{albumId}:batchRemoveMediaItems
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
albumId |
必要欄位。要從媒體項目中移除的 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "mediaItemIds": [ string ] } |
欄位 | |
---|---|
mediaItemIds[] |
必要欄位。要移除的 不得包含重複 ID,且不得留空。一次呼叫最多只能移除 50 個媒體項目。 |
回應主體
如果成功,回應主體會是空白的。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/photoslibrary