Chrome Management Reports API용 코드 샘플

API 기능의 개요는 Chrome Management Reports API를 참조하세요.

아래에 표시된 모든 요청은 다음 변수를 사용합니다.

  • $TOKEN - OAuth 2 토큰
  • $CUSTOMER - 고객 ID 또는 리터럴 my_customer
  • $ORG_UNIT_ID - 요청을 생성하려는 특정 조직 단위의 ID입니다.

특정 기간 동안 활성 상태인 Chrome 버전 수

일정 기간 동안 활성 상태였던 Chrome 버전을 보려면 filter 매개변수의 last_active_date 값을 사용하세요. pageSizepageToken 매개변수를 사용하여 결과의 페이지로 나누기를 제어할 수 있습니다.

요청

  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"

응답

{
  "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
}

다양한 권한이 있는 앱 설치 분포 계산

주어진 권한으로 특정 앱을 설치한 기기의 수를 보려면 filter 매개변수의 number_of_permissions 값을 사용하세요. pageSizepageToken 매개변수를 사용하여 결과의 페이지로 나누기를 제어할 수 있습니다.

더 많은 필터 매개변수에 대한 자세한 내용은 참조를 확인하세요.

요청

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

응답

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

앱이 설치된 기기 수 집계

이전 예는 2대의 기기에 설치된 앱을 보여주었습니다. 이 앱이 설치된 기기를 보려면 findInstalledAppDevices 맞춤 메서드를 사용하면 됩니다. pageSizepageToken 매개변수를 사용하여 결과의 페이지로 나누기를 제어할 수 있습니다.

요청

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

응답

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

후속 요청

이전 예에서 반환된 기기 ID가 주어지면 Chrome 브라우저용 Admin SDK Directory API를 사용하여 앱을 설치한 기기에 관한 자세한 정보를 얻을 수 있습니다.