Updates the metadata of Photos
, such as pose, place association, connections, etc. Changing the pixels of photos is not supported.
Note that if photos.batchUpdate
fails, either critical fields are missing or there is an authentication error. Even if photos.batchUpdate
succeeds, individual photos in the batch may have failures. These failures are specified in each PhotoResponse.status
in BatchUpdatePhotosResponse.results
. See photo.update
for specific failures that can occur per photo.
Only the fields specified in updateMask
field are used. If updateMask
is not present, the update applies to all fields.
The number of UpdatePhotoRequest
messages in a BatchUpdatePhotosRequest
must not exceed 20.
Note: To update
Pose.altitude
,Pose.latLngPair
has to be filled as well. Otherwise, the request will fail.
HTTP request
POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate
The URL uses gRPC Transcoding syntax.
Request body
The request body contains data with the following structure:
JSON representation |
---|
{
"updatePhotoRequests": [
{
"photo": {
object ( |
Fields | |
---|---|
updatePhotoRequests[] |
Required. List of |
updatePhotoRequests[].photo |
Required. |
updatePhotoRequests[].updateMask |
Required. Mask that identifies fields on the photo metadata to update. If not present, the old The following fields are valid:
|
Response body
Response to batch update of metadata of one or more Photos
.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"results": [
{
object ( |
Fields | |
---|---|
results[] |
List of results for each individual |
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/streetviewpublish
For more information, see the OAuth 2.0 Overview.