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

Visita la API de informes de administración de Chrome 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 my_customer literal
  • $ORG_UNIT_ID: Es el ID de una unidad organizativa particular 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 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: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 varios permisos

Para ver la cantidad de dispositivos que tienen instalada una app en particular con un determinado cantidad de permisos, usa el valor number_of_permissions en Parámetro filter. Puedes controlar la paginación de los resultados con la Parámetros pageSize y pageToken

Para ver 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"
      ]
    },
  ]
}

Contar los dispositivos que tienen una app instalada

El ejemplo anterior mostró una app que se instaló en 2 dispositivos. Para ver los dispositivos que instalaron esta aplicación, puedes usar la Método personalizado findInstalledAppDevices Puedes controlar la paginación de los resultados con pageSize y pageToken. parámetros.

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 mostrado en el ejemplo anterior, puedes obtener más información sobre el dispositivo que instaló la aplicación a través del API de Directory del SDK de Admin para navegadores Chrome.