Method: mediaItems.list

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

セッションでまだメディア アイテムが選択されておらず、メディア コンテンツを返せない場合は、FAILED_PRECONDITION エラーが返されます。このシナリオでは、入力が制限されたデバイスで実行されるアプリケーションで、セッションの pickerUri をエンコードする QR コードをレンダリングし、Google フォト選択ツール UI でコードをスキャンしてメディア アイテムを選択するようユーザーに促します。ユーザーがアイテムを選択するのを待つ間、クライアントは sessions.get レスポンスの pickedItemsSet = true まで、pollingConfig.pollInterval ごとに 1 回 sessions.get をポーリングする必要があります。その時点で、クライアントは mediaItems.list の呼び出しを再開し、正常なレスポンスを受け取る可能性があります。

HTTP リクエスト

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

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

クエリ パラメータ

パラメータ
sessionId

string

必須。Google が生成した、このセッションの識別子。
pageSize

integer

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

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

string

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

リクエスト本文

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

レスポンスの本文

mediaItems.list RPC に対するレスポンス。

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

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

object (PickedMediaItem)

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

string

mediaItems.list リクエストで次のページを取得するために pageToken として送信できるトークン。

認可スコープ

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

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