Method: photos.batchUpdate

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

يُرجى العِلم أنّه في حال تعذُّر تنفيذ photos.batchUpdate، يعني ذلك أنّ الحقول الأساسية مفقودة أو أنّ هناك خطأ في المصادقة. حتى إذا نجحت عملية photos.batchUpdate، قد تحدث أخطاء في الصور الفردية ضمن المجموعة. يتم تحديد حالات التعذّر هذه في كل PhotoResponse.status في BatchUpdatePhotosResponse.results. اطّلِع على photo.update لمعرفة حالات الفشل المحدّدة التي يمكن أن تحدث لكل صورة.

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

يجب ألا يتجاوز عدد الرسائل في UpdatePhotoRequest BatchUpdatePhotosRequest 20 رسالة.

ملاحظة: لتعديل Pose.altitude، يجب ملء الحقل Pose.latLngPair أيضًا. وفي حال عدم توفّرها، سيتعذّر تنفيذ الطلب.

طلب HTTP

POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate

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

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
الحقول
updatePhotoRequests[]

object

الحقل مطلوب. تمثّل هذه السمة قائمة UpdatePhotoRequests.
updatePhotoRequests[].photo

object (Photo)

الحقل مطلوب. Photo عنصر يحتوي على البيانات الوصفية الجديدة
updatePhotoRequests[].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 فارغًا، تتم إزالة جميع عمليات الربط.

نص الاستجابة

ردّ على تعديل مجمّع للبيانات الوصفية الخاصة بـ Photos واحد أو أكثر

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
الحقول
results[]

object (PhotoResponse)

تم تعديل قائمة النتائج لكل فرد Photo، بالترتيب نفسه الذي تم به تقديم الطلب.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.