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)

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