Method: photos.list

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يعرض كل Photos التي تخص المستخدم.

ملاحظة: لا يتم عرض الصور التي تم إنشاؤها مؤخرًا والتي لا تزال قيد الفهرسة في الرد.

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcoding.

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

المَعلمات
view

enum (PhotoView)

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

pageSize

integer

اختياريّ. الحد الأقصى لعدد الصور المطلوب إرجاعها. يجب أن يكون pageSize غير سالب. إذا كان pageSize صفرًا أو لم يتم تقديمه، يتم استخدام الحجم التلقائي للصفحة 100. قد يكون عدد الصور التي يتم عرضها في الرد أقل من pageSize إذا كان عدد الصور التي تخص المستخدم أقل من pageSize.

pageToken

string

اختياريّ. القيمة nextPageToken التي تم عرضها من طلب photos.list سابق، إن توفّرت.

filter

string

اختياريّ. تعبير الفلتر مثلاً: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw

الفلاتر المتاحة هي: placeId وmin_latitude وmax_latitude وmin_longitude وmax_longitude. لمزيد من المعلومات، يمكنك الاطّلاع على https://google.aip.dev/160.

languageCode

string

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

نص الطلب

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

نص الاستجابة

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

إدراج قائمة بجميع الصور التي تخص مستخدمًا.

تمثيل JSON
{
  "photos": [
    {
      object (Photo)
    }
  ],
  "nextPageToken": string
}
الحقول
photos[]

object (Photo)

قائمة الصور يحدِّد الحقل pageSize في الطلب عدد السلع المعروضة.

nextPageToken

string

الرمز المميز لاسترداد الصفحة التالية من النتائج، أو فارغ إذا لم يكن هناك أي نتائج أخرى في القائمة.

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

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

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

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