Method: mobiledevices.list

لاسترداد قائمة مقسّمة إلى صفحات تضم جميع الأجهزة الجوّالة المملوكة للمستخدم للحساب. لاسترداد قائمة تتضمن الأجهزة المملوكة للشركة، يمكنك استخدام Device API في Cloud Identity بدلاً من ذلك. تنتهي مهلة هذه الطريقة بعد 60 دقيقة. لمزيد من المعلومات، يُرجى الاطّلاع على تحديد مشاكل رموز الخطأ وحلّها.

طلب HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile

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

مَعلمات المسار

المعلمات
customerId

string

المعرّف الفريد لحساب العميل على Google Workspace. بصفتك مشرفًا للحساب، يمكنك أيضًا استخدام العنوان البديل للبريد الإلكتروني my_customer لتمثيل customerId في حسابك. ويتم عرض customerId أيضًا كجزء من مورد "المستخدمون".

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

المعلمات
maxResults

integer

الحد الأقصى لعدد النتائج المطلوب عرضها. الحدّ الأقصى المسموح به للقيمة هو 100.
orderBy

enum (OrderBy)

سمة الجهاز المطلوب استخدامها لترتيب النتائج.
pageToken

string

رمز مميّز لتحديد الصفحة التالية في القائمة
projection

enum (Projection)

تقييد المعلومات التي يتم عرضها على مجموعة من الحقول المحدّدة.
query

string

سلسلة البحث بالتنسيق الموضّح في https://developers.google.com/admin-sdk/directory/v1/search-operators
sortOrder

enum (SortOrder)

ما إذا كان سيتم عرض النتائج بترتيب تصاعدي أم تنازلي. ويجب استخدامه مع مَعلمة orderBy.

نص الطلب

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

نص الاستجابة

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

تمثيل JSON 
{
  "kind": string,
  "etag": string,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
الحقول
kind

string

هذا نوع من الموارد.
etag

string

علامة ETag للمورد.
mobiledevices[]

object (MobileDevice)

قائمة بعناصر الجهاز الجوّال
nextPageToken

string

يتم استخدام الرمز المميّز للوصول إلى الصفحة التالية من هذه النتيجة.

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

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/admin.directory.device.mobile
  • https://www.googleapis.com/auth/admin.directory.device.mobile.action
  • https://www.googleapis.com/auth/admin.directory.device.mobile.readonly

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

ترتيب

عمليات التعداد
DEVICE_ID الرقم التسلسلي لجهاز الجوال "مزامنة Google". بالنسبة إلى الأجهزة التي تعمل بنظام التشغيل Android، هذا هو معرّف فريد ينشئه البرنامج.
EMAIL عنوان البريد الإلكتروني لمالك الجهاز.
LAST_SYNC تاريخ آخر مزامنة لإعدادات السياسة على الجهاز
MODEL طراز الجهاز الجوّال
NAME اسم المستخدم لمالك الجهاز
OS نظام تشغيل الجهاز
STATUS حالة الجهاز.
TYPE نوع الجهاز

الإسقاط

عمليات التعداد
BASIC تضمين حقول البيانات الوصفية الأساسية فقط (مثل رقم تعريف الجهاز والطراز والحالة والنوع والحالة)
FULL تتضمّن كل حقول البيانات الوصفية

SortOrder

عمليات التعداد
ASCENDING ترتيب تصاعدي
DESCENDING ترتيب تنازلي.