Method: chromeosdevices.list

يستردّ هذا الإجراء قائمة مقسّمة إلى صفحات بأجهزة ChromeOS ضمن حساب.

طلب 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

سلسلة البحث بالتنسيق المحدّد في عوامل تشغيل طلب البحث chromeosdevices.list
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 تتضمّن حقول البيانات الوصفية الأساسية فقط (مثل deviceId وserialNumber وstatus وuser)
FULL تتضمّن جميع حقول البيانات الوصفية

SortOrder

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

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