لاسترداد قائمة مقسّمة على صفحات لجميع أجهزة الجوّال التي يملكها المستخدم لحساب ما. لاسترداد قائمة تتضمن الأجهزة المملوكة للشركة، يمكنك استخدام Devices API على Cloud Identity بدلاً من ذلك. تنتهي مهلة هذه الطريقة بعد 60 دقيقة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تحديد مشاكل رموز الخطأ وحلّها.
طلب HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
customerId |
المعرّف الفريد لحساب العميل على Google Workspace بصفتك مشرفًا للحساب، يمكنك أيضًا استخدام العنوان البديل للبريد الإلكتروني |
معلمات طلب البحث
المَعلمات | |
---|---|
maxResults |
الحد الأقصى لعدد النتائج المطلوب عرضها. الحد الأقصى للقيمة المسموح به هو 100. |
orderBy |
خاصية الجهاز المطلوب استخدامها لترتيب النتائج |
pageToken |
الرمز المميز لتحديد الصفحة التالية في القائمة |
projection |
تقييد المعلومات المعروضة على مجموعة من الحقول المحددة |
query |
سلسلة بحث بالتنسيق الموضّح في https://developers.google.com/admin-sdk/directory/v1/search-operators |
sortOrder |
ما إذا كان سيتم عرض النتائج بترتيب تصاعدي أم تنازلي. ويجب استخدامه مع المعلَمة |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"kind": string,
"etag": string,
"mobiledevices": [
{
object ( |
الحقول | |
---|---|
kind |
هذا هو مصدر هذا المرجع. |
etag |
علامة ETag للمورد. |
mobiledevices[] |
قائمة بكائنات الأجهزة الجوّالة. |
nextPageToken |
الرمز المميّز المُستخدَم للوصول إلى الصفحة التالية من هذه النتيجة |
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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 |
ترتيب تنازلي. |