Method: chromeosdevices.action

En su lugar, usa BatchChangeChromeOsDeviceStatus. Realiza una acción que afecta a un dispositivo ChromeOS. 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. El customerId también se muestra como parte del recurso Usuarios.

resourceId

string

Es el ID único del dispositivo. Los 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 ChromeOS.

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

string

chromeosdevices.action que se realizará en el dispositivo ChromeOS.

Los valores aceptables son:

  • deprovision: Para quitar de la administración un dispositivo que ya no está activo, se está revendiendo o se enviará para su devolución o reparación, usa la acción de desaprovisionamiento para desvincularlo de la administración.
  • disable: Si crees que se perdió o se robó un dispositivo de tu organización, puedes inhabilitarlo para que nadie más pueda usarlo. Cuando un dispositivo Chrome está inhabilitado, lo único que el usuario puede ver cuando lo enciende es una pantalla que le indica que está inhabilitado y la información de contacto que deseas para devolverlo.
  • 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 sin intervención manual cambiando el estado a "pre_provisioned_reenable". Nota: Desde este estado, se puede 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 la acción es deprovisionar. Con la acción de baja, este campo es obligatorio.

Los valores aceptables son:

  • different_model_replacement: Úsalo si actualizas o reemplazas tu dispositivo por un modelo más reciente.
  • retiring_device: Úsalo si vas a revender, donar o quitar de uso el dispositivo de forma permanente.
  • same_model_replacement: Se usa si se encontró un problema de hardware en un dispositivo y se reemplaza por el mismo modelo o un modelo similar de un proveedor o fabricante de reparaciones.
  • upgrade_transfer: Úsalo si reemplazas tus dispositivos CloudReady por Chromebooks en el plazo de un año.