برای مرور کلی ویژگیهای 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:countChromeProfileVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"
پاسخ
{
"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
}
تعداد نسخههای فعال کروم را در محدوده تاریخ بشمارید
برای مشاهدهی نسخههای فعال کروم در یک بازه زمانی مشخص، از مقدار 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"
}
]
}
درخواست پیگیری
با توجه به شناسه دستگاه برگردانده شده در مثال قبلی، میتوانید با استفاده از 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"
},
]
}
درخواست پیگیری
با توجه به شناسه دائمی پروفایل که در مثال قبلی برگردانده شد، میتوانید با استفاده از API مدیریت پروفایلهای کروم ، اطلاعات بیشتری در مورد پروفایلی که برنامه را نصب کرده است، دریافت کنید.
یافتن میزان استفاده از SaaS
برای مشاهدهی میزان استفادهی تجمیعی از برنامههای SaaS در سراسر سازمان خود، از متد سفارشی findSaasUsage استفاده کنید. میتوانید نتایج را با استفاده از پارامتر filter فیلتر کرده و با استفاده از orderBy مرتبسازی کنید. میتوانید صفحهبندی نتایج را با استفاده از پارامترهای pageSize و pageToken کنترل کنید.
درخواست
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findSaasUsage"
پاسخ
{
"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"
}
یافتن میزان استفاده از SaaS که بر اساس پروفایلها گروهبندی شدهاند
برای مشاهده میزان استفاده از برنامه SaaS برای یک برنامه خاص که بر اساس پروفایلها گروهبندی شده است، از متد سفارشی findSaasUsageProfiles استفاده کنید. پارامتر app برنامه SaaS را مشخص میکند. میتوانید نتایج را با استفاده از پارامتر filter فیلتر کرده و با استفاده از orderBy مرتبسازی کنید. میتوانید صفحهبندی نتایج را با استفاده از پارامترهای pageSize و pageToken کنترل کنید.
درخواست
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findSaasUsageProfiles?app=Slack"
پاسخ
{
"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"
}
درخواست پیگیری
با توجه به شناسه دائمی پروفایل که در مثال قبلی برگردانده شد، میتوانید با استفاده از API مدیریت پروفایلهای کروم، اطلاعات بیشتری در مورد پروفایل دریافت کنید.
یافتن میزان استفاده از SaaS به صورت گروهبندی شده بر اساس مرورگرها
برای مشاهده میزان استفاده از برنامههای SaaS برای یک برنامه خاص که بر اساس مرورگرها گروهبندی شده است، از متد سفارشی findSaasUsageBrowsers استفاده کنید. پارامتر app برنامه SaaS را مشخص میکند. میتوانید نتایج را با استفاده از پارامتر filter فیلتر کرده و با استفاده از orderBy مرتبسازی کنید. میتوانید صفحهبندی نتایج را با استفاده از پارامترهای pageSize و pageToken کنترل کنید.
درخواست
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findSaasUsageBrowsers?app=GitHub"
پاسخ
{
"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"
}
برای مرور کلی ویژگیهای 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:countChromeProfileVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"
پاسخ
{
"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
}
تعداد نسخههای فعال کروم را در محدوده تاریخ بشمارید
برای مشاهدهی نسخههای فعال کروم در یک بازه زمانی مشخص، از مقدار 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"
}
]
}
درخواست پیگیری
با توجه به شناسه دستگاه برگردانده شده در مثال قبلی، میتوانید با استفاده از 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"
},
]
}
درخواست پیگیری
با توجه به شناسه دائمی پروفایل که در مثال قبلی برگردانده شد، میتوانید با استفاده از API مدیریت پروفایلهای کروم ، اطلاعات بیشتری در مورد پروفایلی که برنامه را نصب کرده است، دریافت کنید.
یافتن میزان استفاده از SaaS
برای مشاهدهی میزان استفادهی تجمیعی از برنامههای SaaS در سراسر سازمان خود، از متد سفارشی findSaasUsage استفاده کنید. میتوانید نتایج را با استفاده از پارامتر filter فیلتر کرده و با استفاده از orderBy مرتبسازی کنید. میتوانید صفحهبندی نتایج را با استفاده از پارامترهای pageSize و pageToken کنترل کنید.
درخواست
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findSaasUsage"
پاسخ
{
"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"
}
یافتن میزان استفاده از SaaS که بر اساس پروفایلها گروهبندی شدهاند
برای مشاهده میزان استفاده از برنامه SaaS برای یک برنامه خاص که بر اساس پروفایلها گروهبندی شده است، از متد سفارشی findSaasUsageProfiles استفاده کنید. پارامتر app برنامه SaaS را مشخص میکند. میتوانید نتایج را با استفاده از پارامتر filter فیلتر کرده و با استفاده از orderBy مرتبسازی کنید. میتوانید صفحهبندی نتایج را با استفاده از پارامترهای pageSize و pageToken کنترل کنید.
درخواست
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findSaasUsageProfiles?app=Slack"
پاسخ
{
"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"
}
درخواست پیگیری
با توجه به شناسه دائمی پروفایل که در مثال قبلی برگردانده شد، میتوانید با استفاده از API مدیریت پروفایلهای کروم، اطلاعات بیشتری در مورد پروفایل دریافت کنید.
یافتن میزان استفاده از SaaS به صورت گروهبندی شده بر اساس مرورگرها
برای مشاهده میزان استفاده از برنامههای SaaS برای یک برنامه خاص که بر اساس مرورگرها گروهبندی شده است، از متد سفارشی findSaasUsageBrowsers استفاده کنید. پارامتر app برنامه SaaS را مشخص میکند. میتوانید نتایج را با استفاده از پارامتر filter فیلتر کرده و با استفاده از orderBy مرتبسازی کنید. میتوانید صفحهبندی نتایج را با استفاده از پارامترهای pageSize و pageToken کنترل کنید.
درخواست
curl -X GET \
-H "Authorization: Bearer $TOKEN" \
"https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findSaasUsageBrowsers?app=GitHub"
پاسخ
{
"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"
}