Method: chromeosdevices.list

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
customerId

string

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

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

پارامترها
maxResults

integer

حداکثر تعداد نتایج برای برگرداندن. مقدار نباید از ۳۰۰ تجاوز کند.

orderBy

enum ( OrderBy )

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

orgUnitPath

string

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

pageToken

string

پارامتر پرس‌وجوی pageToken برای درخواست صفحه بعدی نتایج پرس‌وجو استفاده می‌شود. پارامتر پرس‌وجوی pageToken مربوط به درخواست بعدی، nextPageToken از پاسخ قبلی شما است.

projection

enum ( Projection )

تعیین می‌کند که آیا پاسخ شامل لیست کامل ویژگی‌ها است یا فقط زیرمجموعه‌ای از آن‌ها را شامل می‌شود.

query

string

رشته جستجو در قالب داده شده در عملگرهای پرس و جوی chromeosdevices.list .

sortOrder

enum ( SortOrder )

اینکه نتایج به ترتیب صعودی یا نزولی برگردانده شوند. باید با پارامتر orderBy استفاده شود.

includeChildOrgunits

boolean

دستگاه‌های مربوط به همه واحدهای سازمانی فرزند و همچنین واحد سازمانی مشخص شده را برمی‌گرداند. اگر این مقدار روی true تنظیم شده باشد، باید 'orgUnitPath' ارائه شود.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "kind": string,
  "etag": string,
  "chromeosdevices": [
    {
      object (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
فیلدها
kind

string

این یه جورایی منبعه.

etag

string

برچسب منبع (ETag).

chromeosdevices[]

object ( ChromeOsDevice )

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

nextPageToken

string

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

دامنه‌های مجوز

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

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

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

سفارش توسط

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

طرح ریزی

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

انوم‌ها
BASIC فقط شامل فیلدهای فراداده اولیه (مثلاً deviceId، serialNumber، status و user) می‌شود.
FULL شامل تمام فیلدهای فراداده می‌شود

مرتب‌سازی

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

انوم‌ها
ASCENDING ترتیب صعودی.
DESCENDING ترتیب نزولی.