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)

從使用者的媒體庫中擷取媒體項目。如果未發生任何錯誤，且成功擷取媒體項目，則會填入資料。