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

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

المَعلمات
photoIds[]

string

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

view

enum (PhotoView)

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

languageCode

string

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

نص الطلب

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

نص الاستجابة

الردّ على استلام دُفعة واحدة (Photos)

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

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

object (PhotoResponse)

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

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

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

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

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