Method: customer.devices.chromeos.batchChangeStatus

Cambia el estado de un lote de dispositivos ChromeOS. Para obtener más información sobre cómo cambiar el estado de un dispositivo ChromeOS, consulta Cómo reparar, rediseñar o retirar dispositivos ChromeOS.

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. Es el ID inmutable de la cuenta de Google Workspace.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "deviceIds": [
    string
  ],
  "changeChromeOsDeviceStatusAction": enum (ChangeChromeOsDeviceStatusAction),
  "deprovisionReason": enum (DeprovisionReason)
}
Campos
deviceIds[]

string

Obligatorio. Es la lista de los IDs de los dispositivos ChromeOS que se cambiarán. Máximo 50.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

Obligatorio. Es la acción que se debe realizar en el dispositivo ChromeOS para cambiar su estado.
deprovisionReason

enum (DeprovisionReason)

Opcional. Es el motivo por el que se desaprovisionó un dispositivo. Se debe proporcionar si "changeChromeOsDeviceStatusAction" está configurado como "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION". De lo contrario, omite este campo.

Cuerpo de la respuesta

Es la respuesta de cambiar el estado de un lote de dispositivos ChromeOS.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "changeChromeOsDeviceStatusResults": [
    {
      object (ChangeChromeOsDeviceStatusResult)
    }
  ]
}
Campos
changeChromeOsDeviceStatusResults[]

object (ChangeChromeOsDeviceStatusResult)

Los resultados de cada uno de los dispositivos ChromeOS proporcionados en la solicitud

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.

ChangeChromeOsDeviceStatusAction

Es la acción que se debe realizar para cambiar el estado de un dispositivo ChromeOS.

Enumeraciones
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED Valor predeterminado El valor no se usa.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION Deaprovisiona un dispositivo ChromeOS. Si tienes dispositivos ChromeOS que ya no se usan en tu organización, debes desaprovisionarlos para dejar de administrarlos. Si desaprovisionas el dispositivo, se quitarán todas las políticas que estaban en él, así como las impresoras a nivel del dispositivo y la posibilidad de usarlo como un kiosco. Según la actualización que esté asociada al dispositivo, esta acción podría devolver la licencia al grupo de licencias, lo que te permite usarla en otro dispositivo.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE Inhabilita un dispositivo ChromeOS. Usa esta acción si un usuario pierde su dispositivo o se lo roban. De esta manera, el dispositivo seguirá administrándose, por lo que seguirá recibiendo políticas, pero nadie podrá usarlo. Según la actualización que esté asociada al dispositivo, esta acción podría devolver la licencia al grupo de licencias, lo que te permite usarla en otro dispositivo.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Vuelve a habilitar un dispositivo ChromeOS para que se use después de inhabilitarlo. Vuelve a habilitar el dispositivo una vez que ya no esté perdido o se haya recuperado. Esto permite que el dispositivo se vuelva a usar. Según la actualización asociada con el dispositivo, es posible que se consuma una licencia del grupo de licencias, lo que significa que, si no hay suficientes licencias disponibles, la operación fallará.

ChangeChromeOsDeviceStatusResult

El resultado de un solo dispositivo ChromeOS para una operación de cambio de estado.

Representación JSON 
{
  "deviceId": string,

  // Union field result can be only one of the following:
  "error": {
    object (Status)
  },
  "response": {
    object (ChangeChromeOsDeviceStatusSucceeded)
  }
  // End of list of possible types for union field result.
}
Campos
deviceId

string

El ID único del dispositivo ChromeOS.

Campo de unión result.

result puede ser una de las siguientes opciones:
error

object (Status)

El resultado de error de la operación en caso de falla.
response

object (ChangeChromeOsDeviceStatusSucceeded)

El dispositivo pudo cambiar su estado correctamente.

Estado

El tipo de Status define un modelo de error lógico que es adecuado para entornos de programación diferentes, incluidas las API de REST y las API de RPC. Lo usa gRPC. Cada mensaje Status contiene tres datos: código de error, mensaje de error y detalles del error.

Puedes obtener más información sobre este modelo de error y cómo trabajar con él en la guía de diseño de API.

Representación JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Campos
code

integer

El código de estado, que debe ser un valor enum de google.rpc.Code.
message

string

Un mensaje de error dirigido al desarrollador, que debe estar en inglés. Cualquier mensaje de error dirigido al usuario debe localizarse y enviarse al campo google.rpc.Status.details; o el cliente debe localizarlo.
details[]

object

Una lista de mensajes que contienen los detalles del error. Hay un conjunto común de tipos de mensajes para que usen las API.

Un objeto que contiene campos de un tipo arbitrario. Un campo adicional "@type" contiene una URI que identifica el tipo. Ejemplo: { "id": 1234, "@type": "types.example.com/standard/id" }.

ChangeChromeOsDeviceStatusSucceeded

Este tipo no tiene campos.

Es la respuesta de un cambio de estado correcto del dispositivo ChromeOS.