Method: chromeosdevices.list

استرداد قائمة مقسّمة على صفحات للأجهزة التي تعمل بنظام التشغيل Chrome ضمن حساب

طلب HTTP

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

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

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

المَعلمات
customerId

string

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

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

المَعلمات
maxResults

integer

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

enum (OrderBy)

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

string

تشير هذه السمة إلى المسار الكامل للوحدة التنظيمية (بدون علامة / البادئة) أو رقم تعريفها الفريد.
pageToken

string

تُستخدم معلمة طلب البحث pageToken لطلب الصفحة التالية من نتائج طلب البحث. معلمة طلب المتابعة pageToken لطلب المتابعة هي nextPageToken من ردك السابق.
projection

enum (Projection)

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

string

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

enum (SortOrder)

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

boolean

عرض الأجهزة من جميع الوحدات التنظيمية الفرعية، وكذلك من الوحدة التنظيمية المحددة. إذا تم ضبط السياسة على "صحيح"، يجب تقديم "orgUnitPath".

نص الطلب

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

نص الاستجابة

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

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

string

هذا هو مصدر هذا المرجع.
etag

string

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

object (ChromeOsDevice)

قائمة بكائنات الأجهزة التي تعمل بنظام التشغيل ChromeOS
nextPageToken

string

الرمز المميّز المُستخدَم للوصول إلى الصفحة التالية من هذه النتيجة للوصول إلى الصفحة التالية، استخدِم قيمة هذا الرمز المميّز في سلسلة طلب البحث pageToken لهذا الطلب.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

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

OrderBy

عمليات التعداد
ANNOTATED_LOCATION موقع جهاز Chrome كما وضّحه المشرف
ANNOTATED_USER مستخدم Chromebook كما تمت إضافة تعليق توضيحي من المشرف.
LAST_SYNC تاريخ ووقت آخر مزامنة لجهاز Chrome مع إعدادات السياسة في وحدة تحكم المشرف.
NOTES ملاحظات جهاز Chrome كما علَّق المشرف
SERIAL_NUMBER الرقم التسلسلي لجهاز Chrome الذي تم إدخاله عند تفعيل الجهاز.
STATUS حالة جهاز Chrome. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على <a chromeosdevices.

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

نوع العرض الذي سيتم عرضه للأجهزة

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

SortOrder

تمثّل هذه السمة ترتيب الترتيب الذي يجب تطبيقه على قائمة الأجهزة.

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