Method: devices.list

يسرد الأجهزة في وضع الاستراحة المرتبطة بحساب المستخدم الذي تمت مصادقته. لا يعرض سوى الأجهزة التي تم إنشاؤها بواسطة تطبيق الاتصال.

طلب HTTP

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

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

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

المعلمات
pageSize

integer

اختياريّ. الحدّ الأقصى لعدد الأجهزة المطلوب عرضها.

قد تعرض الخدمة عددًا أقل من هذه القيمة (بما في ذلك صفر نتائج). في حال عدم تحديد القيمة أو ضبطها على 0، سيتم إرجاع 50 جهازًا كحدّ أقصى. الحد الأقصى للقيمة هو 100؛ سيتم فرض القيم الأكبر من 100 على 100. ستؤدي القيم السلبية إلى خطأ INVALID_ARGUMENT.
pageToken

string

اختياريّ. رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "devices.list". يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.

نص الطلب

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

نص الاستجابة

تمثّل هذه السمة ردًا على استدعاء الإجراءات عن بُعد devices.list.

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

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

object (AmbientDevice)

صفحة من الأجهزة المحيطة المتصلة بحساب المستخدم على "صور Google"
nextPageToken

string

رمز مميّز يمكن إرساله على أنّه pageToken لاسترداد الصفحة التالية في طلب devices.list.

في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.

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

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

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