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، يجب أن تكون مَعلمة طلب البحث لعنوان 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.