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

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل 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.