Method: photos.batchUpdate

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

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

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

BatchUpdatePhotosRequestUpdatePhotoRequest 메시지 수는 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에 반복되는 필드가 있으면 반복되는 값 집합 전체가 새 콘텐츠로 바뀝니다. 예를 들어 updateMaskconnections이 포함되어 있고 UpdatePhotoRequest.photo.connections가 비어 있으면 모든 연결이 삭제됩니다.

응답 본문

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

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

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

object (PhotoResponse)

개별 Photo의 결과 목록이 요청과 동일한 순서로 업데이트되었습니다.

승인 범위

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

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.