Method: photos.list

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

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

طلب HTTP

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

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

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

المَعلمات
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، مثل "ar-AE" أو "sr-Latn". للمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. وفي حال عدم تحديد codeCode، سيتم استخدام الإعدادات المفضّلة للغة لدى خدمات Google.

نص الطلب

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

نص الاستجابة

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

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

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

object (Photo)

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

nextPageToken

string

الرمز المميز لاسترداد الصفحة التالية من النتائج، أو فارغ في حال عدم ظهور المزيد من النتائج في القائمة

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

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

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

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