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.readonly.appcreateddata