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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals

MediaItemResult

擷取媒體項目的結果。

JSON 表示法 
{
  "status": {
    object (Status)
  },
  "mediaItem": {
    object (MediaItem)
  }
}
欄位
status

object (Status)

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

object (MediaItem)

從使用者程式庫中擷取的媒體項目。如果沒有發生錯誤且媒體項目已成功擷取，系統就會填入這個值。