Method: chromeosdevices.action

Вместо этого используйте BatchChangeChromeOsDeviceStatus . Выполняет действие, которое влияет на устройство Chrome OS. Сюда входит деинициализация, отключение и повторное включение устройств.

HTTP-запрос

POST https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos/{resourceId}/action

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
customerId

string

Уникальный идентификатор аккаунта Google Workspace клиента. Как администратор учетной записи вы также можете использовать псевдоним my_customer для представления customerId вашей учетной записи. customerId также возвращается как часть ресурса Users .

resourceId

string

Уникальный идентификатор устройства. resourceId возвращаются в ответе метода chromeosdevices.list .

Тело запроса

Тело запроса содержит экземпляр ChromeOsDeviceAction .

Тело ответа

В случае успеха ответ представляет собой общий ответ HTTP, формат которого определяется методом.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в руководстве по авторизации .

ChromeOsDeviceAction

Данные об обновлении статуса устройства Chrome OS.

JSON-представление
{
  "action": string,
  "deprovisionReason": string
}
Поля
action

string

chromeosdevices.action, которое необходимо выполнить на устройстве Chrome OS.

Приемлемые значения:

  • deprovision : удалите из управления устройство, которое больше не активно, перепродается или отправляется на возврат/ремонт; используйте действие деинициализации, чтобы отделить его от управления.
  • disable : если вы считаете, что устройство в вашей организации было потеряно или украдено, вы можете отключить его, чтобы никто другой не смог его использовать. Когда устройство отключено, все, что пользователь может видеть при включении устройства Chrome, — это экран с сообщением о том, что оно отключено, и желаемую контактную информацию о том, куда вернуть устройство.
  • reenable : повторное включение отключенного устройства при обнаружении потерянного устройства или возврате потерянного устройства. Вы также можете использовать эту функцию, если случайно пометили устройство Chrome как отключенное.
  • pre_provisioned_disable : предварительно подготовленное устройство, которое не может зарегистрироваться. Администратор может повторно включить устройство, чтобы разрешить автоматическую регистрацию, изменив статус на «pre_provisioned_reenable». Примечание . В этом состоянии устройство можно деинициализировать.
  • pre_provisioned_reenable : устройство предварительно подготовлено OEM-производителями. Устройства в этом состоянии имеют право на автоматическую регистрацию.
deprovisionReason

string

Используется только в том случае, если действие — деинициализация. При действии деинициализации это поле является обязательным.

Приемлемые значения:

  • different_model_replacement : используйте, если вы обновляете или заменяете свое устройство более новой моделью того же устройства.
  • retiring_device : используйте, если вы перепродаете, жертвуете или навсегда удаляете устройство из использования.
  • same_model_replacement : используйте, если на устройстве возникла аппаратная проблема и оно заменяется на ту же модель или аналогичную модель от поставщика/производителя ремонта.
  • upgrade_transfer : используйте, если вы заменяете свои устройства Cloud Ready на Chromebook в течение одного года.