Method: chromeosdevices.list

يستردّ هذه الدالة قائمة مفصّلة بأجهزة Chrome OS ضمن حساب معيّن.

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

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

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 ترتيب تنازلي