Method: photos.list

列出使用者的所有 Photos。

注意：如果最近建立的相片仍在建立索引，回應中就不會傳回。

HTTP 要求

GET https://streetviewpublish.googleapis.com/v1/photos

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

查詢參數

參數
view

enum (PhotoView)

必要欄位。指定是否應在 Google 相簿回應中傳回相片位元組的下載網址。
pageSize

integer

選用設定。要傳回的相片數量上限。pageSize 不得為負數。如果 pageSize 為零或未提供，則使用預設頁面大小 100。如果使用者的相片數量少於 pageSize，回應中傳回的相片數量可能少於 pageSize 張。
pageToken

string

選用設定。先前的 photos.list 要求 (如果有的話) 傳回的 nextPageToken 值。
filter

string

選用設定。篩選運算式。例如 placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw。

支援的篩選器如下：placeId、min_latitude、max_latitude、min_longitude、max_longitude。詳情請參閱 https://google.aip.dev/160。
languageCode

string

選用設定。BCP-47 語言代碼，例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如未指定 languageCode，系統會採用使用者在 Google 服務的語言偏好設定。

要求主體

要求主體必須為空白。

回應主體

回應至清單，列出使用者的所有相片。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "photos": [
    {
      object (Photo)
    }
  ],
  "nextPageToken": string
}
欄位
photos[]

object (Photo)

相片清單。要求中的 pageSize 欄位會決定傳回的項目數量。
nextPageToken

string

用來擷取下一頁結果的符記；如果清單中沒有其他結果，這一欄就會留空。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽。