Method: photos.batchDelete

  • The photos.batchDelete API allows for deleting multiple photos and their metadata within Street View Publish.

  • The request body requires a list of photoIds for the photos to be deleted.

  • The response provides individual status updates for each photo deletion attempt.

  • Authorization with the https://www.googleapis.com/auth/streetviewpublish scope is necessary.

  • Failures may occur for individual photos even if the overall batch deletion request is successful, details of which can be found in the response.

Deletes a list of Photos and their metadata.

Note that if photos.batchDelete fails, either critical fields are missing or there is an authentication error. Even if photos.batchDelete succeeds, individual photos in the batch may have failures. These failures are specified in each PhotoResponse.status in BatchDeletePhotosResponse.results. See photo.delete for specific failures that can occur per photo.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "photoIds": [
    string
  ]
}
Fields
photoIds[]

string

Required. IDs of the Photos. HTTP GET requests require the following syntax for the URL query parameter: photoIds=<id1>&photoIds=<id2>&....

Response body

Response to batch delete of one or more Photos.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "status": [
    {
      object (Status)
    }
  ]
}
Fields
status[]

object (Status)

The status for the operation to delete a single Photo in the batch request.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.