برای مرور کلی ویژگیهای API، به Chrome Management Reports API مراجعه کنید.
تمام درخواستهای نشان داده شده در زیر از متغیرهای زیر استفاده میکنند:
- توکن
$TOKEN- توکن OAuth 2 -
$CUSTOMER- شناسه مشتری یا به عبارت دیگرmy_customer -
$ORG_UNIT_ID- شناسه یک واحد سازمانی خاص که میخواهید برای آن درخواست ایجاد کنید.
تعداد نسخههای فعال کروم در یک بازه زمانی
برای مشاهدهی نسخههای فعال کروم در یک بازه زمانی مشخص، از مقدار last_active_date در پارامتر filter استفاده کنید. میتوانید با استفاده از پارامترهای 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
}
تعداد توزیع نصب برنامهها با تعدادی مجوز
برای مشاهده تعداد دستگاههایی که یک برنامه خاص با تعداد مجوزهای مشخص را نصب کردهاند، از مقدار number_of_permissions در پارامتر filter استفاده کنید. میتوانید صفحهبندی نتایج را با استفاده از پارامترهای 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"
]
},
]
}
تعداد دستگاههایی که برنامه نصب شده دارند
مثال قبلی برنامهای را نشان داد که روی ۲ دستگاه نصب شده است. برای مشاهده دستگاههایی که این برنامه را نصب کردهاند، میتوانید از متد سفارشی 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"
}
]
}
درخواست پیگیری
با توجه به شناسه دستگاه برگردانده شده در مثال قبلی، میتوانید با استفاده از API دایرکتوری SDK مدیریت برای مرورگرهای کروم ، اطلاعات بیشتری در مورد دستگاهی که برنامه را نصب کرده است، دریافت کنید.
تعداد پروفایلهایی که برنامه نصب شده دارند
برای مشاهده لیست پروفایلهایی که یک برنامه را نصب کردهاند، میتوانید از متد سفارشی 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"
},
]
}
درخواست پیگیری
با توجه به شناسه دائمی پروفایل که در مثال قبلی برگردانده شد، میتوانید با استفاده از API مدیریت پروفایلهای کروم ، اطلاعات بیشتری در مورد پروفایلی که برنامه را نصب کرده است، دریافت کنید.