Method: photos.batchUpdate

자세, 장소 연결, 연결 등 Photos의 메타데이터를 업데이트합니다. 사진의 픽셀 변경은 지원되지 않습니다.

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

updateMask 필드에 지정된 필드만 사용됩니다. updateMask가 없으면 업데이트가 모든 필드에 적용됩니다.

BatchUpdatePhotosRequest의 UpdatePhotoRequest 메시지 수는 20개를 초과할 수 없습니다.

참고: Pose.altitude를 업데이트하려면 Pose.latLngPair도 입력해야 합니다. 그렇지 않으면 요청이 실패합니다.

HTTP 요청

POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate

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

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
필드
updatePhotoRequests[]

object

필수 항목입니다. UpdatePhotoRequests 목록
updatePhotoRequests[].photo

object (Photo)

필수 항목입니다. 새 메타데이터가 포함된 Photo 객체입니다.
updatePhotoRequests[].updateMask

string (FieldMask format)

필수 항목입니다. 업데이트할 사진 메타데이터의 필드를 식별하는 마스크입니다. 이 값이 없으면 이전 Photo 메타데이터가 이 요청의 새 Photo 메타데이터로 완전히 대체됩니다. 잘못된 필드를 지정하면 업데이트가 실패합니다. 쉼표로 구분된 목록으로 여러 필드를 지정할 수 있습니다.

다음 필드는 유효합니다.

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

참고: updateMask에 반복 필드가 포함된 경우 반복되는 전체 값이 새 콘텐츠로 대체됩니다. 예를 들어 updateMask에 connections가 포함되고 UpdatePhotoRequest.photo.connections가 비어 있으면 모든 연결이 삭제됩니다.

응답 본문

하나 이상의 Photos 메타데이터의 일괄 업데이트에 대한 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
필드
results[]

object (PhotoResponse)

업데이트된 각 개별 Photo의 결과 목록으로, 요청과 순서가 동일합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 Overview를 참조하세요.