Method: mobiledevices.list

يسترجع هذه الوظيفة قائمة مفصّلة بجميع الأجهزة الجوّالة التي يملكها المستخدمون لحساب معيّن. لاسترداد قائمة تتضمّن الأجهزة المملوكة للشركة، استخدِم Devices 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/workspace/admin/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

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

OrderBy

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

الإسقاط

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

SortOrder

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