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을 Photo 응답에 반환할지 여부를 지정합니다.

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