API 기능 개요는 Chrome Management Reports API를 참고하세요.
아래 표시된 모든 요청은 다음 변수를 사용합니다.
$TOKEN- OAuth 2 토큰$CUSTOMER- 고객 ID 또는 리터럴my_customer$ORG_UNIT_ID- 요청을 생성하려는 특정 조직 단위의 ID
날짜 범위에서 활성 상태인 Chrome 버전 수
특정 기간 동안 활성 상태였던 Chrome 버전을 보려면 filter 매개변수의 last_active_date 값을 사용합니다. pageSize 및 pageToken 매개변수를 사용하여 결과의 페이지 나누기를 제어할 수 있습니다.
요청
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 값을 사용합니다. pageSize 및 pageToken 매개변수를 사용하여 결과의 페이지 나누기를 제어할 수 있습니다.
필터 매개변수에 대한 자세한 내용은 참조를 확인하세요.
요청
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 커스텀 메서드를 사용하면 됩니다.
pageSize 및 pageToken 매개변수를 사용하여 결과의 페이지 나누기를 제어할 수 있습니다.
요청
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를 통해 앱을 설치한 기기에 대한 자세한 정보를 확인할 수 있습니다.
설치된 앱이 있는 프로필 수
앱을 설치한 프로필 목록을 보려면 findInstalledAppProfiles 커스텀 메서드를 사용하면 됩니다.
pageSize 및 pageToken 매개변수를 사용하여 결과의 페이지 나누기를 제어할 수 있습니다.
요청
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findInstalledAppProfiles?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"
응답
{
"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"
},
]
}
후속 요청
이전 예에서 반환된 프로필 영구 ID를 사용하여 Chrome Management Profiles API를 통해 앱을 설치한 프로필에 대한 자세한 정보를 확인할 수 있습니다.