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 Repara, reaprovecha o retira 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. 50 como máximo.
changeChromeOsDeviceStatusAction

enum (ChangeChromeOsDeviceStatusAction)

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

enum (DeprovisionReason)

Opcional. Es el motivo del desaprovisionamiento de 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 cuando se cambia 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.

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.

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 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 se desaprovisiona 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 con el dispositivo, esta acción podría volver a liberar la licencia en el conjunto de licencias. lo que te permite usar la licencia en otro dispositivo.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE Inhabilita un dispositivo ChromeOS. Realiza esta acción si un usuario pierde su dispositivo o se lo roban. De esta forma, el dispositivo seguirá administrado y seguirá recibiendo políticas, pero nadie podrá usarlo. Según la actualización que esté asociada con el dispositivo, esta acción podría volver a liberar la licencia en el conjunto de licencias. lo que te permite usar la licencia en otro dispositivo.
CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_REENABLE Vuelve a habilitar un dispositivo ChromeOS para usarlo después de haber sido inhabilitado. Vuelve a habilitar el dispositivo una vez que ya no se pierde o se recupera. De esta manera, se podrá volver a usar el dispositivo. Según la actualización asociada al dispositivo, es posible que se consuma una licencia del conjunto de licencias, lo que significa que, si no hay suficientes licencias disponibles, la operación fallará.

ChangeChromeOsDeviceStatusResult

Es 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 por un cambio exitoso de estado en el dispositivo ChromeOS.