Method: photo.update
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يعدّل البيانات الوصفية لـ Photo، مثل الوضع وربط المكان والروابط وما إلى ذلك. ولا يمكن تغيير وحدات البكسل في الصورة.
يتم استخدام الحقول المحددة في الحقل updateMask فقط. في حال عدم توفّر updateMask، ينطبق التعديل على جميع الحقول.
تعرض هذه الطريقة رموز الخطأ التالية:
طلب HTTP
PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المَعلمات |
photo.photoId.id |
string
معرّف فريد للصورة
|
معلمات طلب البحث
| المَعلمات |
updateMask |
string (FieldMask format)
مطلوبة. قناع يحدد الحقول في البيانات الوصفية للصورة المطلوب تعديلها. وفي حال عدم توفّر هذه البيانات، يتم استبدال بيانات Photo الوصفية القديمة بالكامل ببيانات وصفية Photo الجديدة في هذا الطلب. يتعذّر التعديل في حال تحديد حقول غير صالحة. يمكن تحديد حقول متعددة في قائمة مفصولة بفواصل. الحقول التالية صالحة:
pose.headingpose.lat_lng_pairpose.pitchpose.rollpose.levelpose.altitudeconnectionsplaces
ملاحظة: عندما يحتوي updateMask على حقول متكرّرة، يتم استبدال مجموعة القيم المتكرّرة بالمحتوى الجديد. على سبيل المثال، إذا كانت السمة updateMask تحتوي على connections وكان الحقل UpdatePhotoRequest.photo.connections فارغًا، ستتم إزالة جميع عمليات الربط.
|
نص الطلب
يحتوي نص الطلب على مثال Photo.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Photo.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/streetviewpublish
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2023-12-01 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2023-12-01 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Updates a Photo's metadata, such as pose, connections, and places, but not the image pixels themselves."],["Uses an `updateMask` to specify which fields to update; if omitted, all fields are updated."],["Requires the `https://www.googleapis.com/auth/streetviewpublish` OAuth scope for authorization."],["Returns the updated Photo object if successful."],["May return errors if permissions are lacking, the request is invalid, the Photo doesn't exist, or is still being indexed."]]],["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"]]
