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
  • https://www.googleapis.com/auth/photoslibrary.readonly.originals