Method: photos.batchGet

توفر هذه الطريقة البيانات الوصفية لدُفعة Photo المحدّدة.

يُرجى العِلم أنّه في حال تعذّر تنفيذ photos.batchGet، هذا يعني أن الحقول المهمة غير متوفرة أو هناك خطأ في المصادقة. حتى في حال نجاح "photos.batchGet"، قد تتعذّر الصور الفردية في المجموعة. ويتم تحديد أعطال التطبيق هذه في كل PhotoResponse.status في BatchGetPhotosResponse.results. راجِع photo.get للتعرّف على أخطاء معيّنة يمكن أن تحدث لكل صورة.

طلب HTTP

GET https://streetviewpublish.googleapis.com/v1/photos:batchGet

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

معامِلات طلب البحث

المعلمات
photoIds[]

string

مطلوب. أرقام تعريف Photos بالنسبة إلى طلبات HTTP GET، يجب أن تكون معلمة طلب البحث لعنوان URL هي photoIds=<id1>&photoIds=<id2>&....
view

enum (PhotoView)

مطلوب. تحدِّد هذه السياسة ما إذا كان يجب عرض عنوان URL للتنزيل لوحدات البايت الخاصة بالصور في الردّ على الصورة.
languageCode

string

اختياريّ. رمز اللغة BCP-47، مثل en-US أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. إذا لم يتم تحديد رمز اللغة، يتم استخدام إعدادات اللغة المفضّلة للمستخدم لخدمات Google.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

الرد على طلب الحصول على مُجمَّع بقيمة Photos.

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

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

object (PhotoResponse)

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

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

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

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

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