Method: mediaItems.batchGet

指定したメディア アイテム ID に対応するメディア アイテムのリストを返します。アイテムは、指定した ID と同じ順序で返されます。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
mediaItemIds[]

string

必須。リクエストするメディア アイテムの ID。同じ ID を複数含めることはできません。また、この項目を空にすることはできません。1 回の呼び出しで取得できるメディア アイテムの最大数は 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)

ユーザーのライブラリから取得したメディア アイテム。エラーが発生せず、メディア アイテムが正常に取得された場合に入力されます。