Method: chromeosdevices.action

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Realiza una acción que afecta a un dispositivo con Sistema operativo Chrome. Esto incluye el desaprovisionamiento, la inhabilitación y la rehabilitación de 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 tu customerId. El customerId también se muestra como parte del recurso Users.

resourceId

string

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 incluye 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 la 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 Descripción general de OAuth 2.0.

Acción del dispositivo Chrome OS

Datos sobre una actualización del estado de un dispositivo con Sistema operativo Chrome.

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

string

chromeosdevices.action en el dispositivo con Sistema operativo Chrome.

Los valores aceptables son:

  • deprovision: Quita un dispositivo de la administración que ya no esté activo, se venda o se envíe para su devolución o reparación, y usa la acción de desaprovisionamiento para desvincularlo de la administración.
  • disable: Si crees que perdiste o te robaron un dispositivo de la organización, puedes inhabilitarlo para que nadie más pueda usarlo. Cuando un dispositivo está inhabilitado, todo lo que el usuario puede ver al encender el dispositivo Chrome es una pantalla que le informa que se inhabilitó, y la información de contacto deseada sobre dónde devolver el dispositivo.
  • reenable: Vuelve a habilitar un dispositivo inhabilitado cuando se encuentra un dispositivo perdido o se muestra un dispositivo perdido. También puedes usar esta función si marcas un dispositivo Chrome como inhabilitado por accidente.
  • pre_provisioned_disable: Un dispositivo aprovisionado previamente que no se puede inscribir. Un administrador puede volver a habilitar el dispositivo para permitir la inscripción automática cambiando el estado a &pret-pre_provision_reenable". Nota: Desde este estado, se puede desaprovisionar el dispositivo.
  • pre_provisioned_reenable: Los dispositivos están aprovisionados previamente por los OEM. Los dispositivos en este estado son aptos para la inscripción automática.
deprovisionReason

string

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

Los valores aceptables son:

  • different_model_replacement: úsalo si deseas actualizar o reemplazar tu dispositivo con un modelo más nuevo del mismo dispositivo.
  • retiring_device: Úselo si desea revender, donar o quitar de forma permanente el dispositivo.
  • same_model_replacement: Usa esta opción si se encontró un problema de hardware en un dispositivo y se reemplaza por uno del mismo fabricante o por uno del fabricante correspondiente.
  • upgrade_transfer: Úsalo si reemplazas tus dispositivos listos para la nube con Chromebooks en el plazo de un año.