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

سلسلة البحث بالتنسيق الوارد في https://developers.google.com/workspace/admin/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 ترتيب تنازلي