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

Максимальное количество возвращаемых результатов. Значение не должно превышать 300.

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 )

Список объектов устройств 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 Включает только основные поля метаданных (например, deviceId, serialNumber, status и user).
FULL Включает все поля метаданных.

SortOrder

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

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