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.