Configurar Gestión en la nube del navegador Chrome

Usar la API de Chrome Enterprise Core

Siguiente: Primeros pasos con la integración de la plataforma de APIs de Postman y Chrome Enterpriese Core

Temas

Authorización

Antes de usar todas las APIs de Chrome Enterprise Core, tendrás que habilitar la API de SDK de administrador (si aún no lo has hecho) en la consola para desarrolladores de Google siguiendo este enlace y seleccionando el proyecto en el que quieras habilitar la API.

A continuación, tienes dos opciones para obtener un token con el que acceder a la API:

OAuth2.0 con suplantación de identidad mediante una cuenta de servicio (lee la sección "Autorizar con suplantación de identidad") que aparece debajo.
Oauth2.0 de triple vía sin suplantación de identidad (puedes autorizar tus solicitudes siguiendo las directrices de OAuth2).

Para autorizar el acceso a la API de Chrome Enterprise Core, se necesitan los siguientes permisos:

https://www.googleapis.com/auth/admin.directory.device.chromebrowsers.readonly

https://www.googleapis.com/auth/admin.directory.device.chromebrowsers

Autorizar con suplantación de identidad

Para enviarnos una cuenta de servicio por suplantación de identidad, debes:

Crea una cuenta de servicio y obtén las claves necesarias para esta cuenta de servicio. Puedes seguir este procedimiento para crear una cuenta de servicio y obtener sus claves.
El ID de cliente de esta cuenta de servicio deberá estar autorizado para los ámbitos de OAuth indicados más arriba. Para hacerlo, ve a la consola de administración, en Seguridad -> Controles de APIs -> Gestionar delegación de todo el dominio. A continuación, deberás añadir un nuevo cliente.En este cuadro de diálogo, el ID de cliente corresponde al ID único de tu cuenta de servicio.

Con las claves de la cuenta de servicio, deberás usar las bibliotecas de cliente de las API de Google del lenguaje que prefieras para solicitar un token de acceso de OAuth para tu cuenta de servicio.

Además, la solicitud del token de OAuth también tendrá que suplantar la identidad de un administrador de tu dominio cuando solicite el token de OAuth.

A continuación, se muestra un ejemplo de código que utiliza las bibliotecas de cliente del API Java para recuperar el token de OAuth.

package takeout.api.credentials;

import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import java.io.FileInputStream;
import java.io.IOException;

 
import java.io.InputStream;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;

public final class ApiRequestHelper
 {

 public static String getAccessToken(
 String serviceAccountKeyPathPath, String adminUserToImpersonate, Collection<String> scope)
 throws IOException {
 InputStream is = new FileInputStream(serviceAccountKeyFilePath);
{101
 } GoogleCredential credential
 = GoogleCredential.fromStream(is).toBuilder()
 .setServiceAccountScopes(scopes)
 .setServiceAccountUser(adminUserToImpersonate)
 .build();

 if (! credential.refreshToken()) {
 tiro a un nuevo RuntimeException
 + "ámbitos '%s'",{10 1} serviceAccountKeyFilePath, adminUserToImpersonate, String.join(",", scope)));
 }
 return credential.getAccessToken();
 }

 public static void printUsage() {

 
 System.out.println(
 "Uso: get_access_token <archivo de clave de cuenta de servicio> <usuario administrador> [<scope,scope>]");
 }

 public static void main (String[] args) throws Exception {
 if if (args.length < 2) {
 printUsage();
 return;
 }

 String scope =
 " https://www.googleapis.com/auth/admin.directory.device.chromebrowsers"; si (args.length >= 3) { scope = args[2]; }{101 } System.out.println(
 getAccessToken(args[0], args[1], new ArrayList<String>(Arrays.asList(scopes.split(",")))));
 }{
 101}
 ApiRequestHelper() {}
}

Con este código de ejemplo, podrás recuperar un token de acceso que puedes utilizar para llamar al API. Por ejemplo, si tu archivo de clave está almacenado en /home/private_key.json y la cuenta de administrador que quieres usar para hacer la solicitud es admin@domain.com, deberás ejecutar el ejecutable con los siguientes argumentos:

ApiRequestHelper /home/private_key.json admin@domain.com

es el correo electrónico de su cuenta de servicio (cuyo formato es <nombre-proyecto>-<id>@<nombre-proyecto>.iam.gserviceaccount.com).

Navegador Chrome

Navegadores Chrome registrados en Chrome Enterprise Core.

Representación de recursos

La siguiente plantilla JSON se utiliza para los recursos del navegador Chrome en la API de Directory:

{

"kind": "admin#directory#browserdevice",

"deviceId": string,

"osPlatform": string,

"osPlatformVersion": string,

"osArchitecture":string,

"osVersion": string,

"machineName": string,

"annotatedLocation": string,

"annotatedUser": string,

"annotatedAssetId": string,

"annotatedNotes": string,

"lastPolicyFetchTime": dateTime,

"lastRegistrationTime": dateTime,

"lastActivityTime":dateTime,

"lastStatusReportTime":dateTime,

"virtualDeviceId": string,

"serialNumber": string,

"orgUnitPath": string,

"extensionCount":int,

"policyCount": int,

"safeBrowsingClickThroughCount": int,

"lastDeviceUser": string,

"browserVersions": [string],

"lastDeviceUsers":[

"userName": strin,

"lastStatusReportTime":dateTime,

]

"machinePolicies": [

"source": string,

"name": string,

"value": string,

"error": string,

]

"browsers": [

"browserVersion": string,

"channel": string,

"lastStatusReportTime": dateTime,

"lastPolicyFetchTime": dateTime,

"executablePath": string,

"installedBrowserVersion": string,

"plugins":[

"name": string,

"description": string,

"fileame" string,

]

"profiles": [

"name": string,

"id": string,

"lastStatusReportTime": dateTime,

"lastPolicyFectchTime": dateTime,

"safeBrowsingWarnings": int,

"safeBrowsingWarningsClickThrough": int,

"chromeSignedinUserEmail": string,

"extensionPolicies": [

"extensionId": string,

"extensionName": string,

"policies": [

"source": string,

"name": string,

"value": string,

"error": string,

]

"extensions": [

"extensionId": string,

"version": string,

"permissions": [string],

"name": string,

"description":string,

"appType": string,

"homepageUrl": string,

"installType": string,

"configuredAppPolicy": string,

"disabled": boolean,

"icons": [

"size": int,

"url": string,

]

"userPolicies": [

"source": string,

"name": string,

"value": string,

"error": string,

]

"safeBrowsingWarningsResetTime": string

]

}

Llamar a la API

Retrieve all Chrome browser devices for an account

Limitación: el valor de nextPageToken que devuelve la solicitud de ficha tiene una duración de 1 hora. Si tu solicitud de ficha incluye un gran número de dispositivos del navegador Chrome, es posible que tu token de página caduque antes de que puedas terminar de mostrar todos los dispositivos. En este caso, puedes aplicar un filtro a la solicitud de ficha para reducir el número de dispositivos que devuelve la consulta. Normalmente, filtrar por unidad organizativa es una buena forma de reducir el número de resultados.

Para ver una lista con todos los dispositivos del navegador Chrome asignados a una cuenta, usa la siguiente solicitud GET e incluye la autorización que se describe en el apartado Autorización. Nota: Para facilitar su lectura, el código de ejemplo incluye retornos de carro.

GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId} /devices/chromebrowsers?projection= {COMPLETA|BÁSICA}&consulta= {cadena de consulta}&orderBy= {orderBy
category}

&ordenOrden= {ASCENDING|DESCENDING}

&paginaToken= {token de la siguiente página de resultados, si corresponde &maxResults=número máximo de resultados por página}

El parámetro customerId es un identificador único de la cuenta de Google del cliente.
En caso de iniciar sesión como administrador de una cuenta, también puedes usar la cadena my_customer que representa el customerId de tu cuenta. Otra manera de obtener el valor de customerId es recuperar un usuario. Usa la dirección de correo electrónico o el valor del ID de usuario único de tu administrador en el parámetro de ruta userKey para hacerlo.

A continuación se muestra una referencia de todos los parámetros de cadena de consulta que se pueden utilizar en la solicitud:

Parámetro	Tipo	Descripción
maxResults	entero	Número máximo de resultados que se devolverán. El valor predeterminado y el máximo son 100.
orderBy	string	Propiedad del dispositivo del navegador Chrome que se usará para ordenar los resultados.
		Los valores aceptables para son
		"id": ID del dispositivo que tiene instalado el navegador Chrome.
		"last_sync": indica la fecha y la hora en que el dispositivo Chrome se registró por última vez, se sincronizó por última vez con la configuración de la política o se subió un informe.
		"machine_name": nombre del equipo asociado al dispositivo.
		"extension_count": número total de extensiones denunciadas por el dispositivo Chrome.
		"policy_count": número total de políticas denunciadas por el dispositivo Chrome.
		"os_version": sistema operativo del dispositivo en el que está instalado el navegador Chrome.
		"last_signed_in_user": último usuario que inició sesión en su dispositivo Chrome.
		"annotated_user": usuario del dispositivo Chrome tal y como lo anotó el administrador.
		"annotated_location": ubicación del dispositivo del navegador Chrome anotada por el administrador.
		"annotated_asset_id": ID de recurso del dispositivo del navegador Chrome tal y como lo anotó el administrador.
		"notes": notas del dispositivo del navegador Chrome según las anotaciones del administrador.
		"browser_version_channel": la última versión de Chrome y el último canal que ha registrado el dispositivo.
		"org_unit": unidad organizativa a la que pertenece el dispositivo.
		"enrollment_date": fecha de registro del dispositivo.
		"save_browsing_clickthrough": número de clics de navegación segura registrados por este dispositivo.
		"platform_major_version": tipo de SO y versión principal (por ejemplo, Windows 10).
		"last_activity" (última actividad): el tiempo de la última actividad del dispositivo.
		"browser_version_sortable": la versión más antigua del navegador instalada en el dispositivo:
		"os_version_sortable": tipo de SO y versión completa:
orgUnitPath	string	La ruta completa de la unidad organizativa o su ID único.
groupId	string	El nombre completo del recurso del grupo con el formato `groups/{group}` o su ID único.
pageToken	string	El parámetro de consulta pageToken se usa para solicitar la siguiente página de resultados de una consulta. El parámetro de consulta pageToken de la solicitud posterior es el parámetro nextPageToken de la respuesta previa.
proyección	string	Restringir la información devuelta a un conjunto de campos seleccionados
		Los valores que se aceptan son:
		"BASIC": incluye solo los campos de metadatos básicos (es decir, los que se encuentran en las columnas de la lista de navegadores de la Consola de Administración, como se ha enumerado anteriormente).
		"FULL": incluye todos los campos de metadatos (tal como se ha enumerado anteriormente).
query	string	Cadena de búsqueda que utiliza el lenguaje de consulta de página de lista descrito en la sección siguiente (Filtrar lenguaje de consulta).
sortOrder	string	Indica si los resultados se muestran en orden ascendente o descendente. Se debe utilizar con el parámetro orderBy.
		Los valores que se aceptan son:
		"ASCENDING" (Orden ascendente).
		"DESCENDING": orden descendente.

Ejemplo: Filtrar dispositivos por nombre de máquina

En este primer ejemplo se busca el nombre de una máquina específica mediante el parámetro query=machine_name:CLIENT2012. La respuesta contiene un único recurso de navegadores Chrome en el que "machineName" se corresponde con el centro de asistencia:

Solicitud JSON

GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers?projection=BASIC&query=machine_name:CLIENT2012&orderBy=status
&sortOrder=ASCENDING&maxResults=100

Respuesta en JSON

Una solicitud correcta devuelve un código de estado HTTP 200. Junto con una lista de dispositivos de navegador que coinciden con los parámetros de consulta:

{
  "kind": "directory#browserdevices",
  "browsers": [
     {
      "deviceId": "device_id_value",
      "kind": "admin#directory#browserdevice",
      "osPlatform": "Windows",
      "osVersion": "6.3.9600.19505",
      "machineName": "CLIENT2012",
      "lastRegistrationTime": "2019-11-04T00:29:17.484Z",
      "lastActivityTime": "2019-11-04T00:29:17.484Z",
      "virtualDeviceId": "virtual_device_id",
      "orgUnitPath": "/Org-unit path",
    },
  ],
  "nextPageToken": "abcdefghijkl123"
}

Recuperar un dispositivos de navegador Chrome

Para recuperar las propiedades de un dispositivo Chrome, utiliza la siguiente solicitud GET e incluye la autorización que se describe en Autorizar solicitudes. Nota: Para facilitar su lectura, el código de ejemplo incluye retornos de carro.

GET
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/deviceId?projection={COMPLETA|BÁSICA}

El parámetro customerId es un identificador único de la cuenta de Google del cliente.
En caso de iniciar sesión como administrador de una cuenta, también puedes usar la cadena my_customer que representa el customerId de tu cuenta. Otra manera de obtener el valor de customerId es recuperar un usuario. Usa la dirección de correo electrónico o el valor del ID de usuario único de tu administrador en el parámetro de ruta userKey para hacerlo.
El valor deviceId es un identificador único de un dispositivo y se encuentra en la respuesta de la operación para recuperar todos los dispositivos con navegador Chrome. Para obtener información sobre las cadenas de consulta, las solicitudes y las propiedades de respuesta, consulta la referencia de la API.

A continuación se muestra una referencia de todos los parámetros de cadena de consulta que se pueden utilizar en la solicitud:

Parámetro	Tipo	Descripción
deviceId	string	ID único del dispositivo. Los ID de dispositivo se devuelven en la respuesta del método browserdevices.list. Nota: Este parámetro es obligatorio.
proyección	string	Determina si la respuesta contiene la lista completa de propiedades o solo un subconjunto.
		Los valores que se aceptan son:
		BASIC: solo incluye los campos de metadatos básicos, es decir, los que se encuentran en las columnas de la lista de navegadores de la consola de administración que se indican más arriba.
		"FULL": incluye todos los campos de metadatos (tal como se ha enumerado anteriormente).

Ejemplo

Solicitud JSON

Ejemplo de solicitud Nota: Para facilitar su lectura, el código de ejemplo incluye retornos de carro.

GET https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/deviceId?projection=basic

Respuesta en JSON

Una solicitud correcta devuelve un código de estado HTTP 200. Junto con el código de estado, la respuesta devuelve las propiedades del dispositivo del navegador Chrome:

{
  "deviceId": "device_id_value",
  "kind": "admin#directory#browserdevice",
  "osPlatform": "Windows",
  "osVersion": "6.3.9600.19542",
  "machineName": "CLIENT2012",
  "lastRegistrationTime": "2019-11-27T12:55:27.230Z",
  "lastActivityTime": "2019-11-27T12:55:27.230Z",
  "virtualDeviceId": "virtual_device_id",
  "orgUnitPath": "/Org-unit path",
  "deviceIdentifiersHistory": { 
    "records": [
    { 
      "identifiers": { 
        "machineName": "CLIENT2012", 
        "serialNumber": "ABCD1234567890" }, 
      "firstRecordTime": "2019-11-27T12:55:27.230Z",
      "lastActivityTime": "2019-11-27T12:55:27.230Z"}
  ],
  “has_device_id_collision”: “false”
  }
}

Lenguaje de consultas de filtro

Al usar el parámetro "query" en una solicitud de lista, cada término de la consulta debe coincidir con un dispositivo de navegador específico para ser válido.Si no se especifica ningún operador (campo) en la consulta, la búsqueda buscará un navegador que tenga todos los términos especificados en todos los campos de texto indexados internamente. Por ejemplo, si la consulta es "query=machine 73", se devolverá un navegador que incluya los términos "machine" y "73" en todos los campos que se podrían devolver en un dispositivo de navegador, como el siguiente:

{
  "deviceId": "device_id_value",
  "kind": "admin#directory#browserdevice",
  "osPlatform": "Windows",
  "osVersion": "6.3.9600.19542",
  "machineName": "machine_name",
  "browser_versions": [
    "73.0.0.0",
  ],
  "lastActivityTime": "2019-11-27T12:55:27.230Z",
  "virtualDeviceId": "virtual_device_id",
  "orgUnitPath": "/Org-unit path",
}

Nota 1: La coincidencia se aplica a los límites de palabras (cualquier puntuación o espacio), por lo que no sería posible hacer coincidencias parciales de palabras. En el ejemplo anterior, no sería posible hacer query='mach 73'.

Nota 2: En la concordancia de palabras no se distingue entre mayúsculas y minúsculas, de modo que una consulta con "máquina" debe coincidir con "máquina" y con "máquina".

Puede especificar los siguientes campos para orientar su búsqueda a campos específicos (Nota: Aunque en las palabras de consulta no se distingue entre mayúsculas y minúsculas, los nombres de campo distinguen entre mayúsculas y minúsculas).

Campo	Descripción
machine_name	Nombre del equipo del dispositivo Chrome.
os_platform	Plataforma del SO del dispositivo Chrome. (por ejemplo, Windows)
arco	Arquitectura de CPU del dispositivo del navegador Chrome. (por ejemplo, x86_64)
os_version	Versión del sistema operativo del dispositivo del navegador Chrome. (por ejemplo, 10.0.16299.904)
ubicación	La ubicación anotada del dispositivo Chrome.
usuario	El usuario anotado en el dispositivo Chrome.
asset_id	El ID del recurso anotado para el dispositivo Chrome.
nota	La nota anotada correspondiente al dispositivo con navegador Chrome.
register	Indica la hora de registro del dispositivo Chrome.
os	La plataforma del sistema operativo combinada con la versión principal del sistema operativo en el dispositivo Chrome (por ejemplo, "Windows 10").
browser_version	Un navegador Chrome notificado en el dispositivo Chrome (por ejemplo, 73)
enrollment_token	El token de registro utilizado para registrar el dispositivo Chrome.
report	La hora del último informe del dispositivo Chrome
sync	La hora de la última sincronización de la política del dispositivo Chrome.
num_extensions	El número de extensiones notificadas por el dispositivo Chrome.
num_policies	El número de políticas denunciadas por el dispositivo Chrome.
machine_user	El último usuario notificado del dispositivo Chrome.
last_activity	La última vez que el dispositivo Chrome ha mostrado actividad (obtención de informes o obtención de políticas).
has_device_id_collision	Varios dispositivos comparten el mismo ID de dispositivo y el navegador Chrome lo identifica como el mismo equipo. Los valores admitidos son `true` y `false`.

En los campos que aceptan la hora (registro, informe, sincronización o last_activity), el formato de hora es YYYY-MM-DDThh:mm:ss (por ejemplo, 2020-01-01T12:00:00). También puedes especificar intervalos abiertos o cerrados para el tiempo:

Formulario	Significado	Ejemplos
datetime	Exactamente en la fecha o en la hora especificada	2011-03-23 2011-04-26T14:23:05
datetime..datetime	Dentro del periodo de fecha o de hora especificado (inclusive)	2011-03-23..2011-04-26
datetime..	A partir de la fecha o de la hora especificada	2011-04-26T14:23:05..
..datetime	Hasta la fecha o la hora especificada	..2011-04-26T14:23:05

Ejemplos de consultas de filtro

Nota 1: Todos los ejemplos proporcionados usan el parámetro query de la solicitud. El valor de estos parámetros debe tener el formato de escape adecuado en la URL (es decir, para escapar los espacios con solicitudes con varias condiciones).

Nota 2: Todas las consultas se pueden filtrar aún más para una unidad organizativa concreta añadiendo el parámetro de consulta "orgUnitPath" a la solicitud.

Busca todos los dispositivos con un nombre de máquina que contenga una palabra:
1. machine_name:LIX
Busca todos los dispositivos con nombre de máquina que contengan una palabra que se haya registrado después de una fecha determinada:
1. machine_name:LIX:26-04-2011.
Busca todos los dispositivos con un nombre de máquina que contengan una palabra que se haya registrado antes de una fecha determinada:
1. machine_name:LIX: ..2011-04-26

Consultas actualmente no admitidas:

Busca todos los dispositivos que tengan menos de un número determinado de extensiones instaladas (no se admiten consultas de intervalo por valores numéricos).
Busca todos los dispositivos que tengan un nombre de máquina que contenga una de dos palabras posibles (utilizando OR en las consultas).

Actualizar dispositivos Chrome

Para actualizar los campos anotados de un dispositivo con el navegador Chrome asignado a una cuenta, utiliza la siguiente solicitud PUT e incluye el token de acceso obtenido en la sección "Autorización".

PUT
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/
devices/chromebrowsers/{deviceId}

El parámetro customerId es un identificador único de la cuenta de Google del cliente.
En caso de iniciar sesión como administrador de una cuenta, también puedes usar la cadena my_customer que representa el customerId de tu cuenta. Otra manera de obtener el valor de customerId es recuperar un usuario. Usa la dirección de correo electrónico o el valor del ID de usuario único de tu administrador en el parámetro de ruta userKey para hacerlo.
El valor deviceId es un identificador único de un dispositivo y se encuentra en la respuesta de la operación para recuperar todos los dispositivos con navegador Chrome. Para obtener información sobre las cadenas de consulta, las solicitudes y las propiedades de respuesta, consulta la referencia de la API.

A continuación, se incluye una referencia de todos los parámetros de carga útil que se pueden usar en la solicitud:

Parámetro	Obligatorio	Tipo	Descripción
deviceId	obligatorio	string	ID único del dispositivo. Los ID de dispositivo se devuelven en la respuesta del método browserdevices.list. Nota: Este parámetro es obligatorio.
annotatedUser	opcional	string	El usuario del dispositivo según las anotaciones del administrador.
annotatedLocation	opcional	string	Dirección o ubicación del dispositivo indicada por el administrador.
annotatedNotes	opcional	string	Notas sobre este dispositivo según las anotaciones del administrador
annotatedAssetId	opcional	string	Identificador de recurso que el administrador ha anotado o especificado durante el registro.

Ejemplo

Solicitud JSON

Ejemplo de solicitud Nota: Para facilitar su lectura, el código de ejemplo incluye retornos de carro.

PUT https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/device_id_value

{

"deviceId": "value_id_device", "annotatedUser": "usuario 1" }

Respuesta en JSON

Una solicitud correcta devuelve un código de estado HTTP 200. Junto con el código de estado, la respuesta devuelve las propiedades del dispositivo del navegador Chrome:

{
 "deviceId": "device_id_value",
 "kind": "admin#directory#browserdevice",
 "osPlatform": "Windows",
 "osVersion": "6.3.9600.19542"
 ,
 "machineName": "CLIENT2012",
 "lastRegistrationTime": "2019-11-27T12:55:27.230Z",
 "lastActivityTime": "2019-11-27T12:55:27.230Z",
 "virtualDeviceId": "virtual_device_id",
 "orgUnitPath": "/Org-unit path",
 "annotatedUser": "usuario 1"
}

Eliminar un dispositivo con navegador Chrome

Para eliminar dispositivos de navegador Chrome asignados a una cuenta, utiliza la siguiente solicitud DELETE e incluye el token de acceso obtenido en la sección "Autorización".

DELETE
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/devices
chromebrowsers/{deviceId}

El parámetro customerId es un identificador único de la cuenta de Google del cliente.
En caso de iniciar sesión como administrador de una cuenta, también puedes usar la cadena my_customer que representa el customerId de tu cuenta. Otra manera de obtener el valor de customerId es recuperar un usuario. Usa la dirección de correo electrónico o el valor del ID de usuario único de tu administrador en el parámetro de ruta userKey para hacerlo.
El valor deviceId es un identificador único de un dispositivo y se encuentra en la respuesta de la operación para recuperar todos los dispositivos Chrome. Para obtener información sobre las cadenas de consulta, las solicitudes y las propiedades de respuesta, consulta la referencia de la API.

Ejemplo

Ejemplo de solicitud

DELETE https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/device_id_value

Respuesta en JSON

Una solicitud correcta devuelve un código de estado HTTP 200.

Mover un dispositivo de navegador Chrome entre unidades organizativas

Para mover dispositivos de navegador Chrome asignados a una cuenta de una unidad organizativa a otra, utiliza la siguiente solicitud POST e incluye el token de acceso obtenido a través de la sección "Autorización".

POST
https://www.googleapis.com/admin/directory/v1.1beta1/customer/{my_customer|customerId}/devices/chromebrowsers/moveChromeBrowsersToOu

El parámetro customerId es un identificador único de la cuenta de Google del cliente.
En caso de iniciar sesión como administrador de una cuenta, también puedes usar la cadena my_customer que representa el customerId de tu cuenta. Otra manera de obtener el valor de customerId es recuperar un usuario. Usa la dirección de correo electrónico o el valor del ID de usuario único de tu administrador en el parámetro de ruta userKey para hacerlo.

A continuación, se incluye una referencia de todos los parámetros de carga útil que se pueden usar en la solicitud:

Parámetro	Tipo	Descripción
resource_ids	Lista de cadenas	Lista de IDs de dispositivo únicos de dispositivos de navegador Chrome que se van a mover. Se puede mover un máximo de 600 navegadores por solicitud.
org_unit_path	string	Unidad organizativa de destino a la que se moverán los dispositivos.Ruta completa de la unidad organizativa o de su ID precedida de "id:"

Ejemplo

Ejemplo de solicitud

POST https://www.googleapis.com/admin/directory/v1.1beta1/customer/my_customer/devices/
chromebrowsers/moveChromeBrowsersToOu

{
  "org_unit_path": "/new-path",
  "resource_ids": ["device_id_value_1","device_id_value_2"],
}

Respuesta en JSON

Una solicitud correcta devuelve un código de estado HTTP 200.

¿Te ha resultado útil esta información?

¿Cómo podemos mejorar esta página?