Method: chromeosdevices.action

En su lugar, usa BatchChangeChromeOsDeviceStatus. Realiza una acción que afecta a un dispositivo con Sistema operativo Chrome. Esto incluye desaprovisionar, inhabilitar y volver a habilitar dispositivos.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

El ID único de la cuenta de Google Workspace del cliente. Como administrador de la cuenta, también puedes usar el alias my_customer para representar el customerId de tu cuenta. customerId también se muestra como parte del Recurso de usuarios.

resourceId

string

El ID único del dispositivo. Los objetos resourceId se muestran en la respuesta del método chromeosdevices.list.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de ChromeOsDeviceAction.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, la respuesta es una respuesta HTTP genérica, y el método define su formato.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Guía de autorización.

ChromeOsDeviceAction

Datos sobre una actualización del estado de un dispositivo con ChromeOS.

Representación JSON
{
  "action": string,
  "deprovisionReason": string
}
Campos
action

string

chromeosdevices.action a realizar en el dispositivo con Sistema operativo Chrome.

Los valores aceptables son:

  • deprovision: Quita de la administración un dispositivo que ya no esté activo, que se revenda o que se envíe para su devolución o reparación. Usa la acción de desaprovisionamiento para desvincularlo de la administración.
  • disable: Si crees que un dispositivo de tu organización se perdió o fue robado, puedes inhabilitarlo para que nadie más pueda usarlo. Cuando un dispositivo está inhabilitado, todo lo que el usuario puede ver cuando enciende el dispositivo Chrome es una pantalla que le informa que se inhabilitó y la información de contacto deseada para saber dónde devolver el dispositivo.
  • reenable: Vuelve a habilitar un dispositivo inhabilitado cuando se encuentra uno extraviado o se devuelve uno perdido. También puedes usar esta función si marcas accidentalmente un dispositivo Chrome como inhabilitado.
  • pre_provisioned_disable: Es un dispositivo aprovisionado de forma previa que no se puede inscribir. Un administrador puede volver a habilitar el dispositivo para permitir la inscripción automática cambiando el estado a "pre_provision_reenable". Nota: En este estado, es posible desaprovisionar el dispositivo.
  • pre_provisioned_reenable: Los OEM aprovisionan el dispositivo previamente. Los dispositivos en este estado son aptos para la inscripción automática.
deprovisionReason

string

Solo se usa cuando se desaprovisiona la acción. Con la acción de desaprovisionamiento, este campo es obligatorio.

Los valores aceptables son:

  • different_model_replacement: Úsalo si quieres actualizar o reemplazar tu dispositivo por un modelo más reciente del mismo.
  • retiring_device: Úsalo si revendes, donas o quitas el dispositivo de forma permanente.
  • same_model_replacement: Úsalo si se encontró un problema de hardware en un dispositivo y se reemplaza por el mismo modelo o un reemplazo a un modelo similar de un proveedor o fabricante de reparaciones.
  • upgrade_transfer: Úsalo si reemplazas tus dispositivos listos para la nube por Chromebooks en el plazo de un año.