REST Resource: sessions

リソース: PickingSession

ユーザーが Google フォトを使用して写真や動画を選択できるユーザー セッションを表します。

JSON 表現
{
  "id": string,
  "pickerUri": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "expireTime": string,
  "mediaItemsSet": boolean
}
フィールド
id

string

出力専用。このセッションの Google 生成 ID。

pickerUri

string

出力専用。ユーザーを Google フォト(ウェブ)にリダイレクトして、現在のセッションの写真や動画を選択できるようにするために使用される URI。

このページを正常に表示するには、ユーザーがウェブブラウザでこのセッションを所有する Google アカウントにログインしている必要があります。

セキュリティ上の理由から、pickerUri を iframe で開くことはできません。

pollingConfig

object (PollingConfig)

出力専用。アプリケーションが sessions.get をポーリングする際に使用することをおすすめする構成。

このフィールドは、このセッションでメディア アイテムがまだ選択されていない場合にのみ入力されます(mediaItemsSet は false です)。

expireTime

string (Timestamp format)

出力専用。このセッション(および選択したメディア アイテム)へのアクセスが期限切れになる日時。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

mediaItemsSet

boolean

出力専用。true に設定されている場合、このセッション用にメディア アイテムが選択されており、アプリは mediaItems.list を介して選択されたメディア アイテムのリストをリクエストできます。

PollingConfig

API のポーリングの構成。

JSON 表現
{
  "pollInterval": string,
  "timeoutIn": string
}
フィールド
pollInterval

string (Duration format)

出力専用。ポーリング リクエスト間の推奨時間。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

timeoutIn

string (Duration format)

出力専用。クライアントがポーリングを停止するまでの時間。

値 0 は、クライアントがまだポーリングを停止していない場合は停止する必要があることを示します。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

メソッド

create

新しいセッションを生成します。このセッション中に、ユーザーはサードパーティによるアクセス対象の写真や動画を選択できます。

delete

指定されたセッションを削除します。

get

指定されたセッションに関する情報を取得します。