Method: customer.devices.chromeos.batchChangeStatus

Cambia el estado de un lote de dispositivos ChromeOS. Si quieres obtener más información para cambiar el estado de un dispositivo ChromeOS, consulta Cómo reparar, reutilizar 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. 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 realiza en el dispositivo ChromeOS para cambiar su estado.
deprovisionReason

enum (DeprovisionReason)

Opcional. El motivo por el que se desaprovisiona 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

La respuesta al 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 para 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.

Enumeradores
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_UNSPECIFIED Valor predeterminado El valor no está en uso.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION Desaprovisiona 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 capacidad de usarlo como un kiosco. Según la actualización asociada con el dispositivo, esta acción podría volver a liberar la licencia en el conjunto de licencias, lo que te permite usarla en un dispositivo diferente.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE Inhabilita un dispositivo ChromeOS. Usa esta acción si un usuario pierde su dispositivo o lo roban. De esta forma, el dispositivo seguirá siendo administrado y recibirá políticas, pero nadie podrá usarlo. Según la actualización asociada con el dispositivo, esta acción podría volver a liberar la licencia en el conjunto de licencias, lo que te permite usarla en un dispositivo diferente.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Vuelve a habilitar un dispositivo ChromeOS para usarlo después de inhabilitarse. Vuelve a habilitar el dispositivo una vez que ya no se pierde o se recupera. De esta manera, podrás volver a usar el dispositivo. Según la actualización asociada con el dispositivo, esto podría consumir 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 podría 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.

Respuesta a un cambio de estado correcto de un dispositivo ChromeOS.