photo

PUT /v1/photo/{id}

Changed on

Updates the metadata of a Photo, such as pose, place association, connections, etc. Changing the pixels of a photo is not supported. Only the fields specified in the updateMask field are used. If updateMask is not present, the update applies to all fields. This method returns the following error codes: * google.rpc.Code.PERMISSION_DENIED if the requesting user did not create the requested photo. * google.rpc.Code.INVALID_ARGUMENT if the request is malformed. * google.rpc.Code.NOT_FOUND if the requested photo does not exist. * google.rpc.Code.UNAVAILABLE if the requested Photo is still being indexed.

Request

  • Base URL
    https://streetviewpublish.googleapis.com
  • Auth
    OAuth 2 and OAuth 2
    Implicithttps://accounts.google.com/o/oauth2/auth
    Scopeshttps://www.googleapis.com/auth/streetviewpublish
    Authorization codehttps://accounts.google.com/o/oauth2/auth
    Token URLhttps://accounts.google.com/o/oauth2/token
    Scopeshttps://www.googleapis.com/auth/streetviewpublish

Path parameters

idstring required

A unique identifier for a photo.

Query parameters

updateMaskstring

Required. Mask that identifies fields on the photo metadata to update. If not present, the old Photo metadata is entirely replaced with the new Photo metadata in this request. The update fails if invalid fields are specified. Multiple fields can be specified in a comma-delimited list. The following fields are valid: * pose.heading * pose.lat_lng_pair * pose.pitch * pose.roll * pose.level * pose.altitude * connections * places > Note: When updateMask contains repeated fields, the entire set of repeated values get replaced with the new contents. For example, if updateMask contains connections and UpdatePhotoRequest.photo.connections is empty, all connections are removed.

Request body

captureTimestring google-datetime

Optional. Absolute time when the photo was captured. When the photo has no exif timestamp, this is used to set a timestamp in the photo metadata.

downloadUrlstring

Output only. The download URL for the photo bytes. This field is set only when GetPhotoRequest.view is set to PhotoView.INCLUDE_DOWNLOAD_URL.

mapsPublishStatus'UNSPECIFIED_MAPS_PUBLISH_STATUS' | 'PUBLISHED' | 'REJECTED_UNKNOWN'

Output only. Status in Google Maps, whether this photo was published or rejected.

shareLinkstring

Output only. The share link for the photo.

thumbnailUrlstring

Output only. The thumbnail URL for showing a preview of the given photo.

transferStatus'TRANSFER_STATUS_UNKNOWN' | 'NEVER_TRANSFERRED' | 'PENDING' | 'COMPLETED' | 'REJECTED' | 'EXPIRED' | 'CANCELLED' | 'RECEIVED_VIA_TRANSFER'

Output only. Status of rights transfer on this photo.

uploadTimestring google-datetime

Output only. Time when the image was uploaded.

viewCountstring int64

Output only. View count of the photo.

Response

Successful response

captureTimestring google-datetime

Optional. Absolute time when the photo was captured. When the photo has no exif timestamp, this is used to set a timestamp in the photo metadata.

downloadUrlstring

Output only. The download URL for the photo bytes. This field is set only when GetPhotoRequest.view is set to PhotoView.INCLUDE_DOWNLOAD_URL.

mapsPublishStatus'UNSPECIFIED_MAPS_PUBLISH_STATUS' | 'PUBLISHED' | 'REJECTED_UNKNOWN'

Output only. Status in Google Maps, whether this photo was published or rejected.

shareLinkstring

Output only. The share link for the photo.

thumbnailUrlstring

Output only. The thumbnail URL for showing a preview of the given photo.

transferStatus'TRANSFER_STATUS_UNKNOWN' | 'NEVER_TRANSFERRED' | 'PENDING' | 'COMPLETED' | 'REJECTED' | 'EXPIRED' | 'CANCELLED' | 'RECEIVED_VIA_TRANSFER'

Output only. Status of rights transfer on this photo.

uploadTimestring google-datetime

Output only. Time when the image was uploaded.

viewCountstring int64

Output only. View count of the photo.

Changes

    • breaking

      removed the request body

    • breaking

      removed the media type */* for the response with the status