Method: photo.update

• طلب HTTP
• مَعلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

يعدّل البيانات الوصفية لـ Photo، مثل الوضع وربط المكان والروابط وما إلى ذلك. ولا يمكن تغيير وحدات البكسل في الصورة.

يتم استخدام الحقول المحددة في الحقل updateMask فقط. في حال عدم توفّر updateMask، ينطبق التعديل على جميع الحقول.

تعرض هذه الطريقة رموز الخطأ التالية:

• google.rpc.Code.PERMISSION_DENIED إذا لم ينشئ المستخدم الذي قدّم الطلب الصورة المطلوبة.
• google.rpc.Code.INVALID_ARGUMENT إذا كان الطلب مكتوبًا بشكلٍ غير صحيح.
• google.rpc.Code.NOT_FOUND إذا لم تكن الصورة المطلوبة موجودة.
• google.rpc.Code.UNAVAILABLE إذا كانت قيمة Photo المطلوبة لا تزال قيد الفهرسة.

طلب HTTP

PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
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.