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

Visita la API de Chrome Management Reports 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: Es el ID del cliente o el literal my_customer.
• $ORG_UNIT_ID - Es el ID de una unidad organizacional específica para la que deseas generar una solicitud.

Cómo contar las versiones de Chrome activas en un 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
}

Cómo contar la distribución de las instalaciones de apps con una cantidad de permisos

Para ver la cantidad de dispositivos que instalaron 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 con los parámetros pageSize y pageToken.

Para obtener más parámetros de filtro, 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 contar los dispositivos que tienen una app instalada

En el ejemplo anterior, se mostró 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 con 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 del dispositivo que se muestra en el ejemplo anterior, puedes obtener más información sobre el dispositivo que instaló la app con la API de Directory del SDK de Admin para navegadores Chrome.

Cómo contar los perfiles que tienen una app instalada

Para ver la lista de perfiles que instalaron una app, puedes usar el método personalizado findInstalledAppProfiles. 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:findInstalledAppProfiles?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"

Respuesta

{
  "totalSize": 2,
  "profiles": [
    {
      "email": "<email1>",
      "profileId": "ca847f92-7988-4ac8-a5a3-d0b8473c8bce",
      "profilePermanentId": "agio5SHt1rlQz3WlnKV41z5Fzxw",
      "profileOrgUnitId": "org_unit_id_1"
    },
    {
      "email": "<email2>",
      "profileId": "g472473e-fe50-4c6e-2ac3-53fe0d0753ce",
      "profilePermanentId": "pgeo2SHt1rlQz1WlnKV41z3Fzxw",
      "profileOrgUnitId": "org_unit_id_2"
    },
  ]
}

Solicitud de seguimiento

Dado el ID permanente del perfil que se muestra en el ejemplo anterior, puedes obtener más información sobre el perfil que instaló la app con la API de Chrome Management Profiles.