Method: devices.list

列出連結至已驗證使用者帳戶的環境裝置。僅傳回由呼叫應用程式建立的裝置。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
pageSize

integer

選用設定。傳回的裝置數量上限。

服務傳回的結果可能會少於這個值 (包括零結果)。如果未指定或設為 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

可做為 pageToken 傳送的權杖，用於擷取 devices.list 要求中的下一頁。

如果省略這個欄位，就不會有後續頁面。

授權範圍

需要下列 OAuth 範圍：

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