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/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

لمزيد من المعلومات، راجِع دليل التفويض.

OrderBy

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

توقّعات الميزانية

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

SortOrder

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