Method: photos.batchUpdate
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
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
메타데이터 일괄 업데이트에 대한 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
필드 |
results[] |
object (PhotoResponse )
개별 Photo 의 결과 목록이 요청과 동일한 순서로 업데이트되었습니다.
|
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/streetviewpublish
자세한 내용은 OAuth 2.0 개요를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-09-10(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-09-10(UTC)"],[[["The API updates metadata of photos, such as pose, connections, and place association, but does not change pixel data."],["Requests are submitted as a batch of up to 20 `UpdatePhotoRequest` messages specifying the photo and fields to update."],["If the `updateMask` is not provided, all fields of the Photo resource will be updated with the values provided in the request."],["When updating `Pose.altitude`, `Pose.latLngPair` must also be specified, or the request will fail."],["This API requires the `https://www.googleapis.com/auth/streetviewpublish` OAuth scope for authorization."]]],["This document details the process of updating photo metadata via the `photos:batchUpdate` method. It outlines that you can update fields like pose, place association, and connections, but not photo pixels. The request involves sending `UpdatePhotoRequests` within a `BatchUpdatePhotosRequest` to `POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate`. An `updateMask` specifies which fields to modify. The response contains a list of `PhotoResponse` objects, indicating the success or failure of each photo update. A maximum of 20 `UpdatePhotoRequest` messages are allowed.\n"]]