Method: photos.list

تمام Photos که متعلق به کاربر هستند را فهرست می‌کند.

توجه: عکس‌هایی که اخیراً ایجاد شده‌اند و هنوز در حال ایندکس شدن هستند، در پاسخ بازگردانده نمی‌شوند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای پرس و جو

پارامترها
view

enum ( PhotoView )

الزامی. مشخص می‌کند که آیا باید در پاسخ Photos، یک URL دانلود برای بایت‌های عکس برگردانده شود یا خیر.

pageSize

integer

اختیاری. حداکثر تعداد عکس‌هایی که باید برگردانده شود. pageSize باید غیرمنفی باشد. اگر pageSize صفر باشد یا ارائه نشده باشد، از اندازه پیش‌فرض صفحه ۱۰۰ استفاده می‌شود. اگر تعداد عکس‌های متعلق به کاربر کمتر از 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 مشخص نشده باشد، از ترجیح زبان کاربر برای سرویس‌های گوگل استفاده می‌شود.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

پاسخی برای فهرست کردن تمام عکس‌های متعلق به یک کاربر.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "photos": [
    {
      object (Photo)
    }
  ],
  "nextPageToken": string
}
فیلدها
photos[]

object ( Photo )

فهرست عکس‌ها. فیلد pageSize در درخواست، تعداد موارد برگردانده شده را تعیین می‌کند.

nextPageToken

string

توکن برای بازیابی صفحه بعدی نتایج، یا خالی کردن در صورت عدم وجود نتیجه بیشتر در لیست.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .