Method: mediaItems.list

指定されたセッション中にユーザーが選択したメディア アイテムのリストを返します。

ユーザーが指定されたセッションのメディア アイテムの選択をまだ完了していない場合、FAILED_PRECONDITION エラーが返されます。このシナリオでは、セッションの準備が整うまで sessions.get をポーリングしてから、このメソッドを再試行する必要があります。

HTTP リクエスト

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

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

クエリ パラメータ

パラメータ
sessionId

string

必須。このセッションの Google 生成 ID。
pageSize

integer

省略可。返されるメディア アイテムの最大数。

サービスが返す値はこれよりも少ないことがあります（結果がゼロの場合を含む）。指定しない場合や 0 に設定した場合は、最大で 50 個のメディア アイテムが返されます。最大値は 100 です。100 を超える値は 100 に強制変換されます。負の値を指定すると、INVALID_ARGUMENT エラーが発生します。
pageToken

string

省略可。前回の mediaItems.list 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

リクエスト本文

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

レスポンスの本文

mediaItems.list メソッドに対するレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

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

object (PickedMediaItem)

選択したメディア アイテムのページ。
nextPageToken

string

設定されている場合、このフィールドは、選択したメディア アイテムの次のページを取得するために、後続の mediaItems.list 呼び出しで pageToken として使用できます。

このフィールドを省略すると、後続のページはなくなります。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/photospicker.mediaitems.readonly