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 總覽。