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.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 Overview.