Method: photos.list

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

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
view

enum ( PhotoView )

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

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 مراجعه کنید.