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 Overview。