REST Resource: sessions

リソース: PickingSession

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

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

string

出力専用。Google が生成した、このセッションの識別子。

pickerUri

string

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

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

セキュリティ上の理由により、iframe 内で pickerUri を開くことができません。

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

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