Method: photos.list

يسرد جميع Photos التي تنتمي إلى المستخدم.

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

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

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

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

نص الطلب

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

نص الاستجابة

رد لإدراج جميع الصور التي تخص أحد المستخدمين.

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

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

object (Photo)

قائمة بالصور يحدّد الحقل pageSize في الطلب عدد السلع التي تم إرجاعها.
nextPageToken

string

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

نطاقات التفويض

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

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.