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

支援的篩選器包括:placeIdmin_latitudemax_latitudemin_longitudemax_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 總覽