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

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

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

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

ترتيب

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

الإسقاط

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

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

SortOrder

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

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