Method: devices.list

認証されたユーザーのアカウントに接続されているアンビエント デバイスを一覧表示します。呼び出し元のアプリケーションによって作成されたデバイスのみを返します。

HTTP リクエスト

GET https://photosambient.googleapis.com/v1/devices

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

クエリ パラメータ

パラメータ
pageSize

integer

省略可。返されるデバイスの最大数。

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

pageToken

string

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

リクエスト本文

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

レスポンスの本文

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

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

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

object (AmbientDevice)

ユーザーの Google フォト アカウントに接続されているアンビエント デバイスのページ。

nextPageToken

string

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

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

認可スコープ

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

  • https://www.googleapis.com/auth/photosambient.mediaitems