傳回指定媒體項目 ID 的媒體項目清單。商品的退貨順序與提供 ID 的順序相同。
HTTP 要求
GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 | |
---|---|
mediaItemIds[] |
必要欄位。要請求的媒體項目 ID。不得包含重複 ID,且不得留空。一次呼叫最多只能擷取 50 個媒體項目。 |
要求主體
要求主體必須為空白。
回應主體
回應擷取媒體項目清單的回應。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"mediaItemResults": [
{
object ( |
欄位 | |
---|---|
mediaItemResults[] |
僅供輸出。已擷取媒體項目清單。請注意,即使呼叫 mediaItems.batchGet 成功,批次中某些媒體項目也可能會失敗。這些失敗情形會顯示在每個 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/photoslibrary
https://www.googleapis.com/auth/photoslibrary.readonly
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata
MediaItemResult
擷取媒體項目的結果。
JSON 表示法 |
---|
{ "status": { object ( |
欄位 | |
---|---|
status |
如果存取這個媒體項目時發生錯誤,系統會在這個欄位填入錯誤相關資訊。如需這個欄位的詳細資訊,請參閱 |
mediaItem |
擷取自使用者媒體庫的媒體項目。如果未發生錯誤且系統成功擷取媒體項目,系統就會填入這個欄位。 |