Method: mediaItems.batchGet

傳回指定媒體項目 ID 的媒體項目清單。商品的退貨順序與提供 ID 的順序相同。

HTTP 要求

GET https://photoslibrary.googleapis.com/v1/mediaItems:batchGet

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

查詢參數

參數
mediaItemIds[]

string

必要欄位。要請求的媒體項目 ID。不得包含重複 ID，且不得留空。一次呼叫最多只能擷取 50 個媒體項目。

要求主體

要求主體必須為空白。

回應主體

回應擷取媒體項目清單的回應。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "mediaItemResults": [
    {
      object (MediaItemResult)
    }
  ]
}
欄位
mediaItemResults[]

object (MediaItemResult)

僅供輸出。已擷取媒體項目清單。請注意，即使呼叫 mediaItems.batchGet 成功，批次中某些媒體項目也可能會失敗。這些失敗情形會顯示在每個 MediaItemResult.status 中。

授權範圍

需要下列其中一種 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": {
    object (MediaItem)
  }
}
欄位
status

object (Status)

如果存取這個媒體項目時發生錯誤，系統會在這個欄位填入錯誤相關資訊。如需這個欄位的詳細資訊，請參閱 Status。
mediaItem

object (MediaItem)

擷取自使用者媒體庫的媒體項目。如果未發生錯誤且系統成功擷取媒體項目，系統就會填入這個欄位。