Method: mediaItems.batchGet

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

HTTP リクエスト

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

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

クエリ パラメータ

パラメータ
mediaItemIds[]

string

必須。リクエストするメディア アイテムの 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)

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