Muestras de código para la API de informes de administración de Chrome

Visita la API de informes de Chrome Management para obtener una descripción general de las funciones de la API.

Todas las solicitudes que se muestran a continuación usan las siguientes variables:

• $TOKEN: Token de OAuth 2
• $CUSTOMER: ID del cliente o literal my_customer
• $ORG_UNIT_ID: Es el ID de una unidad organizativa parcial para la que deseas generar una solicitud.

Contar las versiones de Chrome activas en el período

Para ver qué versiones de Chrome estuvieron activas durante un período determinado, usa el valor last_active_date en el parámetro filter. Puedes controlar la paginación de los resultados con los parámetros pageSize y pageToken.

Solicitud

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countChromeVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"

Respuesta

{
  "browserVersions": [
    {
      "count": "1",
      "version": "85.0.4183.83",
      "system": "SYSTEM_MAC",
      "channel": "STABLE"
    },
    {
      "count": "1",
      "version": "85.0.4183.102",
      "system": "SYSTEM_WINDOWS",
      "channel": "STABLE"
    },
    {
      "count": "13697",
      "version": "71.0.3578.96",
      "system": "SYSTEM_MAC",
      "channel": "STABLE"
    },
    {
      "count": "1",
      "version": "87.0.4280.40",
      "system": "SYSTEM_MAC",
      "channel": "BETA"
    },
    {
      "count": "1",
      "version": "88.0.4314.0",
      "system": "SYSTEM_MAC",
      "channel": "CANARY"
    },
    {
      "count": "1718"
    },
  ],
  "totalSize": 5
}

Distribución del recuento de instalaciones de apps con una cantidad de permisos

Para ver la cantidad de dispositivos en los que se instaló una app en particular con una cantidad determinada de permisos, usa el valor number_of_permissions en el parámetro filter. Puedes controlar la paginación de los resultados mediante los parámetros pageSize y pageToken.

Para obtener más parámetros de filtros, visita la referencia.

Solicitud

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countInstalledApps?filter=number_of_permissions>6"

Respuesta

{
  "totalSize": 1,
  "installedApps": [
    {
      "browserDeviceCount": "2",
      "appSource": "CHROME_WEBSTORE",
      "displayName": "Secure Shell App",
      "description": "Terminal emulator and SSH and SFTP client.",
      "appType": "APP",
      "appInstallType": "ADMIN",
      "appId": "pnhechapfaindjhompbnflcldabbghjo",
      "homepageUri": "https://chrome.google.com/webstore/detail/pnhechapfaindjhompbnflcldabbghjo",
      "permissions": [
        "clipboardRead",
        "clipboardWrite",
        "crashReportPrivate",
        "idle",
        "metricsPrivate",
        "notifications",
        "storage",
        "unlimitedStorage"
      ]
    },
  ]
}

Cómo registrar los dispositivos que tienen una app instalada

En el ejemplo anterior, se muestra una app que se instaló en 2 dispositivos. Para ver los dispositivos que instalaron esta app, puedes usar el método personalizado findInstalledAppDevices. Puedes controlar la paginación de los resultados mediante los parámetros pageSize y pageToken.

Solicitud

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findInstalledAppDevices?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"

Respuesta

{
  "totalSize": 2,
  "devices": [
    {
      "machine": "MACHINEA-A",
      "deviceId": "b472473e-fe50-4c6e-9ac3-03fe0d0753ce"
    },
    {
      "machine": "MACHINE-B",
      "deviceId": "a5f49e54-b07b-409f-bc5c-aaf27c483249"
    }
  ]
}

Solicitud de seguimiento

Dado el ID de dispositivo que se muestra en el ejemplo anterior, puedes obtener más información sobre el dispositivo que instaló la app mediante la API de Directory del SDK de Admin para navegadores Chrome.