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

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

المَعلمات
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. إذا لم يتم تحديد LanguageCode، يتم استخدام تفضيل اللغة للمستخدم على خدمات Google.

نص الطلب

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

نص الاستجابة

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

استجابة مجمّعة للحصول على Photos.

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

object (PhotoResponse)

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

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

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

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

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