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 لتنزيل وحدات البايت الخاصة بالصورة في استجابة Photo.
languageCode

string

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

نص الطلب

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

نص الاستجابة

ردّ على عملية الحصول على مجموعة من Photos.

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

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

object (PhotoResponse)

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

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

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

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

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