Method: photo.update
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ابرداده های یک Photo مانند ژست، ارتباط مکان، اتصالات و غیره را به روز می کند. تغییر پیکسل های یک عکس پشتیبانی نمی شود.
فقط از فیلدهای مشخص شده در قسمت updateMask استفاده می شود. اگر updateMask وجود نداشته باشد، به روز رسانی برای همه فیلدها اعمال می شود.
این روش کدهای خطای زیر را برمی گرداند:
درخواست HTTP
PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| مولفه های |
|---|
photo.photoId.id | string یک شناسه منحصر به فرد برای یک عکس. |
پارامترهای پرس و جو
| مولفه های |
|---|
updateMask | string ( FieldMask format) ضروری. ماسکی که فیلدهای فراداده عکس را برای به‌روزرسانی شناسایی می‌کند. در صورت عدم وجود، متادیتای قدیمی Photo به طور کامل با متادیتای جدید Photo در این درخواست جایگزین می‌شود. اگر فیلدهای نامعتبر مشخص شوند، به روز رسانی انجام نمی شود. چندین فیلد را می توان در یک لیست با کاما مشخص کرد. فیلدهای زیر معتبر هستند: -
pose.heading -
pose.lat_lng_pair -
pose.pitch -
pose.roll -
pose.level -
pose.altitude -
connections -
places
توجه: هنگامی که updateMask حاوی فیلدهای مکرر است، کل مجموعه مقادیر تکرار شده با محتویات جدید جایگزین می شود. به عنوان مثال، اگر updateMask حاوی connections باشد و UpdatePhotoRequest.photo.connections خالی باشد، همه اتصالات حذف می شوند.
|
درخواست بدن
بدنه درخواست شامل نمونه ای از Photo است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Photo است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/streetviewpublish
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]
