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

نص الطلب

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

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