Method: photo.update
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Aktualisiert die Metadaten einer Photo, z. B. Pose, Ortsverknüpfung oder Verbindungen. Das Ändern der Pixel eines Fotos wird nicht unterstützt.
Nur die im Feld updateMask angegebenen Felder werden verwendet. Wenn updateMask nicht vorhanden ist, wird die Aktualisierung auf alle Felder angewendet.
Diese Methode gibt die folgenden Fehlercodes zurück:
HTTP-Anfrage
PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
photo.photoId.id |
string
Eine eindeutige Kennung für ein Foto.
|
Abfrageparameter
| Parameter |
updateMask |
string (FieldMask format)
Erforderlich. Maske, die Felder in den Fotometadaten identifiziert, die aktualisiert werden sollen. Falls nicht vorhanden, werden die alten Photo-Metadaten in dieser Anfrage vollständig durch die neuen Photo-Metadaten ersetzt. Die Aktualisierung schlägt fehl, wenn ungültige Felder angegeben sind. In einer durch Kommas getrennten Liste können mehrere Felder angegeben werden. Die folgenden Felder sind gültig:
pose.headingpose.lat_lng_pairpose.pitchpose.rollpose.levelpose.altitudeconnectionsplaces
Hinweis: Wenn updateMask wiederkehrende Felder enthält, wird der gesamte Satz wiederholter Werte durch den neuen Inhalt ersetzt. Wenn updateMask beispielsweise connections enthält und UpdatePhotoRequest.photo.connections leer ist, werden alle Verbindungen entfernt.
|
Anfragetext
Der Anfragetext enthält eine Instanz von Photo.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Photo.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/streetviewpublish
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
