Method: devices.list

دستگاه های محیطی متصل به حساب کاربری تأیید شده را فهرست می کند. فقط دستگاه های ایجاد شده توسط برنامه تماس را برمی گرداند.

درخواست HTTP

GET https://photosambient.googleapis.com/v1/devices

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

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

پارامترها
pageSize

integer

اختیاری. حداکثر تعداد دستگاه برای بازگشت.

ممکن است سرویس کمتر از این مقدار (شامل نتایج صفر) برگرداند. اگر مشخص نشده باشد یا روی 0 تنظیم شود، حداکثر 50 دستگاه برگردانده می شود. حداکثر مقدار 100 است. مقادیر بالای 100 به 100 تبدیل می شوند. مقادیر منفی منجر به خطای INVALID_ARGUMENT می شود.

pageToken

string

اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی devices.list . این را برای بازیابی صفحه بعدی ارائه کنید.

درخواست بدن

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

بدن پاسخگو

پاسخی به RPC devices.list .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "devices": [
    {
      object (AmbientDevice)
    }
  ],
  "nextPageToken": string
}
فیلدها
devices[]

object ( AmbientDevice )

صفحه‌ای از دستگاه‌های محیطی متصل به حساب Google Photos کاربر.

nextPageToken

string

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

اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

محدوده مجوز

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

  • https://www.googleapis.com/auth/photosambient.mediaitems