Method: chromeosdevices.list

فهرست صفحه بندی شده ای از دستگاه های سیستم عامل Chrome را در یک حساب بازیابی می کند.

درخواست HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
customerId

string

شناسه منحصر به فرد برای حساب Google Workspace مشتری. به‌عنوان مدیر حساب، می‌توانید از نام مستعار my_customer نیز برای نشان دادن customerId حساب خود استفاده کنید. customerId نیز به عنوان بخشی از منبع کاربران بازگردانده می شود.

پارامترهای پرس و جو

پارامترها
maxResults

integer

حداکثر تعداد نتایج برای بازگشت. ارزش نباید بیشتر از 300 باشد.

orderBy

enum ( OrderBy )

ویژگی دستگاه برای استفاده برای مرتب سازی نتایج.

orgUnitPath

string

مسیر کامل واحد سازمانی (منهای پیشرو / ) یا شناسه منحصر به فرد آن.

pageToken

string

پارامتر پرس و جو pageToken برای درخواست صفحه بعدی نتایج پرس و جو استفاده می شود. پارامتر query 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 )

فهرستی از اشیاء دستگاه سیستم عامل Chrome.

nextPageToken

string

رمز برای دسترسی به صفحه بعدی این نتیجه استفاده می شود. برای دسترسی به صفحه بعدی، از مقدار این نشانه در رشته query pageToken این درخواست استفاده کنید.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos
  • https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.

سفارش توسط

Enums
ANNOTATED_LOCATION مکان دستگاه Chrome همانطور که توسط سرپرست شرح داده شده است.
ANNOTATED_USER کاربر Chromebook همانطور که توسط سرپرست شرح داده شده است.
LAST_SYNC تاریخ و ساعت آخرین همگام سازی دستگاه Chrome با تنظیمات خط مشی در کنسول مدیریت.
NOTES یادداشت‌های دستگاه Chrome همانطور که توسط سرپرست شرح داده شده است.
SERIAL_NUMBER شماره سریال دستگاه Chrome که هنگام فعال شدن دستگاه وارد شده است.
STATUS وضعیت دستگاه کروم. برای اطلاعات بیشتر، <a chromeosdevices را ببینید.

فرافکنی

نوع پروجکشن برای نمایش دستگاه ها.

Enums
BASIC فقط شامل فیلدهای ابرداده اصلی (به عنوان مثال، شناسه دستگاه، شماره سریال، وضعیت، و کاربر) است.
FULL شامل تمام فیلدهای ابرداده است

مرتب سازی

ترتیب مرتب سازی که باید در لیست دستگاه اعمال شود.

Enums
ASCENDING ترتیب صعودی
DESCENDING ترتیب نزولی