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.