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