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.

Cuenta las versiones de perfiles de Chrome activas en un período

Para ver qué versiones de perfiles 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:countChromeProfileVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"

Respuesta

{
  "profileBrowserVersions": [
    {
      "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": 6
}

Cuenta 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
}

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

Cuenta 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.

Cuenta 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.

Busca el uso de SaaS

Para ver el uso agregado de aplicaciones de SaaS en tu organización, usa el método personalizado findSaasUsage. Puedes filtrar los resultados con el parámetro filter y ordenarlos con orderBy. 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:findSaasUsage"

Respuesta

{
  "saasReports": [
    {
      "app": "GitHub",
      "firstNavigationTime": "2026-01-01T00:00:00Z",
      "lastNavigationTime": "2026-01-01T10:00:00Z",
      "visitsCount": "100",
      "distinctBrowsersCount": "1",
      "distinctUsersCount": "0",
      "encryptionProtocols": [
        "TLS_1_3"
      ]
    },
    {
      "app": "Slack",
      "firstNavigationTime": "2026-01-02T00:00:00Z",
      "lastNavigationTime": "2026-01-03T10:00:00Z",
      "visitsCount": "25",
      "distinctBrowsersCount": "1",
      "distinctUsersCount": "2",
      "encryptionProtocols": [
        "QUIC",
        "TLS_1_2"
      ]
    }
  ],
  "totalSize": "2"
}

Busca el uso de SaaS agrupado por perfiles

Para ver el uso de aplicaciones de SaaS para una aplicación específica agrupada por perfiles, usa el método personalizado findSaasUsageProfiles. El parámetro app especifica la aplicación de SaaS. Puedes filtrar los resultados con el parámetro filter y ordenarlos con orderBy. 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:findSaasUsageProfiles?app=Slack"

Respuesta

{
  "profileReports": [
    {
      "email": "user1@example.com",
      "profilePermanentId": "profile-permanent-id-1",
      "firstNavigationTime": "2026-01-03T10:00:00Z",
      "lastNavigationTime": "2026-01-03T10:00:00Z",
      "orgUnitId": "03ph8a2z1en205c",
      "osPlatform": "SYSTEM_WINDOWS",
      "osVersion": "10.0.19044"
    },
    {
      "email": "user2@example.com",
      "profilePermanentId": "profile-permanent-id-2",
      "firstNavigationTime": "2026-01-03T10:00:00Z",
      "lastNavigationTime": "2026-01-03T10:00:00Z",
      "orgUnitId": "03ph8a2z1en205c",
      "osPlatform": "SYSTEM_MAC",
      "osVersion": "12.3.1"
    }
  ],
  "totalSize": "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 con la API de Chrome Management Profiles.

Busca el uso de SaaS agrupado por navegadores

Para ver el uso de aplicaciones de SaaS para una aplicación específica agrupada por navegadores, usa el método personalizado findSaasUsageBrowsers. El parámetro app especifica la aplicación de SaaS. Puedes filtrar los resultados con el parámetro filter y ordenarlos con orderBy. 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:findSaasUsageBrowsers?app=GitHub"

Respuesta

{
  "saasUsageBrowsers": [
    {
      "machine": "machine1",
      "devicePermanentId": "device1",
      "firstNavigationTime": "2026-01-01T00:00:00Z",
      "lastNavigationTime": "2026-01-01T10:00:00Z",
      "orgUnitId": "03ph8a2z1en205b",
      "osPlatform": "SYSTEM_WINDOWS",
      "osVersion": "10.0.19042"
    }
  ],
  "totalSize": "1"
}