Method: mediaItems.list

ユーザーの Google フォト ライブラリにあるすべてのメディア アイテムを一覧表示します。

HTTP リクエスト

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

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

クエリ パラメータ

パラメータ
pageSize

integer

レスポンスで返すメディア アイテムの最大数。返されるメディア アイテムの数が、指定した数より少なくなる場合があります。デフォルトの pageSize は 25、最大値は 100 です。
pageToken

string

結果の次のページを取得するための連続トークン。これをリクエストに追加すると、pageToken の後に行が返されます。pageToken は、listMediaItems リクエストに対するレスポンスの nextPageToken パラメータで返される値です。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

ユーザーの Google フォト ライブラリにあるすべてのメディア アイテムのリスト。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "mediaItems": [
    {
      object (MediaItem)
    }
  ],
  "nextPageToken": string
}
フィールド
mediaItems[]

object (MediaItem)

出力のみ。ユーザーのライブラリ内にあるメディア アイテムのリストです。
nextPageToken

string

出力のみ。メディア アイテムの次のセットを取得するために使用するトークン。その存在が、次のリクエストで使用できるメディア アイテムが多いことを示す唯一の信頼できる指標となります。

承認スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/photoslibrary
  • https://www.googleapis.com/auth/photoslibrary.readonly
  • https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata