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.