Method: chromeosdevices.action

En su lugar, usa BatchChangeChromeOsDeviceStatus. Realiza una acción que afecta a un dispositivo con 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 cuentas, también puedes usar el alias my_customer para representar el customerId de tu cuenta. También se muestra customerId como parte del recurso Usuarios.

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.

Permisos 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 de estado de un dispositivo ChromeOS.

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

string

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

Los valores aceptables son:

  • deprovision: Quita un dispositivo de la administración que ya no está activo, se revende o se envía 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 robaron un dispositivo de tu organización, 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 indica 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 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 preaprovisionado que no se puede inscribir. Un administrador puede cambiar el estado a "pre_provision_reenable" para volver a habilitar el dispositivo a fin de permitir la inscripción automática. Nota: Desde este estado, se puede desaprovisionar el dispositivo.
  • pre_provisioned_reenable: Los OEM preaprovisionan el dispositivo. 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: Úsala si quieres actualizar o reemplazar tu dispositivo por un modelo más reciente del mismo dispositivo.
  • retiring_device: Úsalo si revendes, donas o quitas de forma permanente el uso del dispositivo.
  • same_model_replacement: Úsala si se encontró un problema de hardware en un dispositivo y se está reemplazando por el mismo modelo o por un reemplazo de modelo similar de un proveedor o fabricante de reparaciones.
  • upgrade_transfer: Úsala si reemplazas tus dispositivos listos para la nube por Chromebooks en el plazo de un año.