استرداد قائمة مقسّمة على صفحات للأجهزة التي تعمل بنظام التشغيل Chrome ضمن حساب
طلب HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
customerId |
المعرّف الفريد لحساب العميل على Google Workspace بصفتك مشرفًا للحساب، يمكنك أيضًا استخدام العنوان البديل للبريد الإلكتروني |
معلمات طلب البحث
المَعلمات | |
---|---|
maxResults |
الحد الأقصى لعدد النتائج المطلوب عرضها. |
orderBy |
خاصية الجهاز المطلوب استخدامها لترتيب النتائج |
orgUnitPath |
تشير هذه السمة إلى المسار الكامل للوحدة التنظيمية (بدون علامة |
pageToken |
تُستخدم معلمة طلب البحث |
projection |
تقييد المعلومات المعروضة على مجموعة من الحقول المحددة |
query |
سلسلة البحث بالتنسيق الموضح في https://developers.google.com/admin-sdk/directory/v1/list-query-operators |
sortOrder |
ما إذا كان سيتم عرض النتائج بترتيب تصاعدي أم تنازلي. ويجب استخدامه مع المعلَمة |
includeChildOrgunits |
عرض الأجهزة من جميع الوحدات التنظيمية الفرعية، وكذلك من الوحدة التنظيمية المحددة. إذا تم ضبط السياسة على "صحيح"، يجب تقديم "orgUnitPath". |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"kind": string,
"etag": string,
"chromeosdevices": [
{
object ( |
الحقول | |
---|---|
kind |
هذا هو مصدر هذا المرجع. |
etag |
علامة ETag للمورد. |
chromeosdevices[] |
قائمة بكائنات الأجهزة التي تعمل بنظام التشغيل ChromeOS |
nextPageToken |
الرمز المميّز المُستخدَم للوصول إلى الصفحة التالية من هذه النتيجة للوصول إلى الصفحة التالية، استخدِم قيمة هذا الرمز المميّز في سلسلة طلب البحث |
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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 |
ترتيب تنازلي. |