Method: photos.list

تعرض هذه السمة جميع Photos التي يملكها المستخدم.

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

طلب HTTP

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

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

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

المعلمات
view

enum (PhotoView)

الحقل مطلوب. تحدّد هذه السمة ما إذا كان يجب عرض عنوان URL لتنزيل وحدات البايت الخاصة بالصور في استجابة Photos.
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 Overview.