Method: photos.batchGet

取得指定 Photo 批次的中繼資料。

請注意,如果 photos.batchGet 失敗,就表示缺少重要欄位或驗證錯誤。即使 photos.batchGet 成功,批次中的個別相片也可能會發生錯誤。這些失敗次數已指定於 BatchGetPhotosResponse.results 中的每個 PhotoResponse.status。如要瞭解每張相片可能發生的特定失敗問題,請參閱 photo.get

HTTP 要求

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

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

查詢參數

參數
photoIds[]

string

必要欄位。Photos 的 ID。如果是 HTTP GET 要求,網址查詢參數應為 photoIds=<id1>&photoIds=<id2>&...

view

enum (PhotoView)

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

languageCode

string

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

要求主體

要求主體必須為空白。

回應主體

對批次取得 Photos 的回應。

如果成功,回應主體會含有以下結構的資料:

JSON 表示法
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
欄位
results[]

object (PhotoResponse)

個別要求 Photo 的結果清單,順序與 photos.batchGet 中的要求順序相同。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱 OAuth 2.0 總覽