Method: photos.batchGet

지정된 Photo 배치의 메타데이터를 가져옵니다.

photos.batchGet가 실패하면 중요한 필드가 누락되거나 인증 오류가 있는 것입니다. photos.batchGet가 성공하더라도 배치의 개별 사진에 실패가 있을 수 있습니다. 이러한 실패는 BatchGetPhotosResponse.results의 각 PhotoResponse.status에 지정됩니다. 사진당 발생할 수 있는 구체적인 오류는 photo.get를 참고하세요.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
photoIds[]

string

필수 항목입니다. Photos의 ID입니다. HTTP GET 요청의 경우 URL 쿼리 매개변수는 photoIds=<id1>&photoIds=<id2>&...여야 합니다.

view

enum (PhotoView)

필수 항목입니다. 사진 응답에서 사진 바이트의 다운로드 URL을 반환해야 하는지 여부를 지정합니다.

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 개요를 참고하세요.