Method: photo.update
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Actualiza los metadatos de una Photo, como la pose, la asociación del lugar, las conexiones, etc. No se pueden cambiar los píxeles de las fotos.
Solo se usan los campos especificados en el campo updateMask. Si updateMask no está presente, la actualización se aplica a todos los campos.
Este método muestra los siguientes códigos de error:
Solicitud HTTP
PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
photo.photoId.id |
string
Es un identificador único para una foto.
|
Parámetros de consulta
| Parámetros |
updateMask |
string (FieldMask format)
Obligatorio. Máscara que identifica los campos de los metadatos de la foto que se actualizarán. Si no están presentes, los metadatos Photo anteriores se reemplazan por completo con los metadatos nuevos de Photo en esta solicitud. La actualización falla si se especifican campos no válidos. Se pueden especificar varios campos en una lista de valores delimitados con comas. Los siguientes campos son válidos:
pose.headingpose.lat_lng_pairpose.pitchpose.rollpose.levelpose.altitudeconnectionsplaces
Nota: Cuando updateMask contiene campos repetidos, todo el conjunto de valores repetidos se reemplaza por el contenido nuevo. Por ejemplo, si updateMask contiene connections y UpdatePhotoRequest.photo.connections está vacío, se quitarán todas las conexiones.
|
Cuerpo de la solicitud
El cuerpo de la solicitud incluye una instancia de Photo.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Photo.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/streetviewpublish
Para obtener más información, consulta la Descripción general de OAuth 2.0.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eUpdates a Photo's metadata, such as pose, connections, and places, but not the image pixels themselves.\u003c/p\u003e\n"],["\u003cp\u003eUses an \u003ccode\u003eupdateMask\u003c/code\u003e to specify which fields to update; if omitted, all fields are updated.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/streetviewpublish\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eReturns the updated Photo object if successful.\u003c/p\u003e\n"],["\u003cp\u003eMay return errors if permissions are lacking, the request is invalid, the Photo doesn't exist, or is still being indexed.\u003c/p\u003e\n"]]],["This describes how to update a photo's metadata using the Street View Publish API. It uses a `PUT` request to a specific URL with a photo ID in the path. The `updateMask` query parameter specifies which metadata fields to modify. The request body contains the new metadata, and the response body returns the updated photo. Key metadata includes pose, connections, and places. Authorization requires a specific OAuth scope. Possible errors include permission, invalid argument, not found, or unavailability.\n"],null,["# Method: photo.update\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates the metadata of a [Photo](/streetview/publish/reference/rest/v1/photo#Photo), such as pose, place association, connections, etc. Changing the pixels of a photo is not supported.\n\nOnly the fields specified in the `updateMask` field are used. If `updateMask` is not present, the update applies to all fields.\n\nThis method returns the following error codes:\n\n- [google.rpc.Code.PERMISSION_DENIED](/streetview/publish/reference/rest/v1/Code#ENUM_VALUES.PERMISSION_DENIED) if the requesting user did not create the requested photo.\n- [google.rpc.Code.INVALID_ARGUMENT](/streetview/publish/reference/rest/v1/Code#ENUM_VALUES.INVALID_ARGUMENT) if the request is malformed.\n- [google.rpc.Code.NOT_FOUND](/streetview/publish/reference/rest/v1/Code#ENUM_VALUES.NOT_FOUND) if the requested photo does not exist.\n- [google.rpc.Code.UNAVAILABLE](/streetview/publish/reference/rest/v1/Code#ENUM_VALUES.UNAVAILABLE) if the requested [Photo](/streetview/publish/reference/rest/v1/photo#Photo) is still being indexed.\n\n### HTTP request\n\n`PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------------------|-------------------------------------------|\n| `photo.photoId.id` | `string` A unique identifier for a photo. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Required. Mask that identifies fields on the photo metadata to update. If not present, the old [Photo](/streetview/publish/reference/rest/v1/photo#Photo) metadata is entirely replaced with the new [Photo](/streetview/publish/reference/rest/v1/photo#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` \u003e 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. |\n\n### Request body\n\nThe request body contains an instance of [Photo](/streetview/publish/reference/rest/v1/photo#Photo).\n\n### Response body\n\nIf successful, the response body contains an instance of [Photo](/streetview/publish/reference/rest/v1/photo#Photo).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/streetviewpublish`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
