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 также возвращается как часть ресурса Users .

Параметры запроса

Параметры
maxResults

integer

Максимальное количество возвращаемых результатов.

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

Возврат устройств из всех дочерних подразделений, а также из указанного организационного подразделения. Если для этого параметра установлено значение true, необходимо указать «orgUnitPath».

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "kind": string,
  "etag": string,
  "chromeosdevices": [
    {
      object (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
Поля
kind

string

Это такой ресурс.

etag

string

ETag ресурса.

chromeosdevices[]

object ( ChromeOsDevice )

Список объектов устройств Chrome OS.

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 Пользователь Chromebook, указанный администратором.
LAST_SYNC Дата и время последней синхронизации устройства Chrome с настройками политики в консоли администратора.
NOTES Заметки об устройстве Chrome с комментариями администратора.
SERIAL_NUMBER Серийный номер устройства Chrome, введенный при включении устройства.
STATUS Статус устройства Chrome. Дополнительную информацию см. в разделе <a chromeosdevices .

Проекция

Тип проекции, отображаемой для устройств.

Перечисления
BASIC Включает только основные поля метаданных (например, идентификатор устройства, серийный номер, статус и пользователь).
FULL Включает все поля метаданных

Порядок сортировки

Порядок сортировки, который следует применять к списку устройств.

Перечисления
ASCENDING Восходящий порядок.
DESCENDING В порядке убывания.