انتقِل إلى Chrome Management Reports API للاطّلاع على نظرة عامة على ميزات واجهة برمجة التطبيقات.
تستخدِم جميع الطلبات الموضّحة أدناه المتغيّرات التالية:
$TOKEN- رمز OAuth 2 المميز-
$CUSTOMER- معرّف العميل أو القيمة الحرفيةmy_customer - استبدِل
$ORG_UNIT_IDبمعرّف وحدة تنظيمية معيّنة تريد إنشاء طلب لها.
عدد إصدارات ملفات Chrome الشخصية النشطة خلال النطاق الزمني
للاطّلاع على إصدارات ملفات Chrome الشخصية التي كانت نشطة خلال نطاق زمني معيّن، استخدِم القيمة 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
}
عدد إصدارات Chrome النشطة في النطاق الزمني
للاطّلاع على إصدارات Chrome التي كانت نشطة خلال نطاق زمني معيّن، استخدِم القيمة 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"
}
]
}
طلب المتابعة
بالنظر إلى معرّف الجهاز الذي تم عرضه في المثال السابق، يمكنك الحصول على مزيد من المعلومات حول الجهاز الذي ثبّت التطبيق باستخدام واجهة برمجة التطبيقات Directory في حزمة SDK للمشرف لمتصفّحات Chrome.
عدد الملفات الشخصية التي تم تثبيت تطبيق عليها
للاطّلاع على قائمة الملفات الشخصية التي ثبّتت تطبيقًا، يمكنك استخدام الطريقة المخصّصة
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"
},
]
}
طلب المتابعة
بالنظر إلى المعرّف الدائم للملف الشخصي الذي تم عرضه في المثال السابق، يمكنك الحصول على مزيد من المعلومات حول الملف الشخصي الذي ثبَّت التطبيق باستخدام Chrome Management Profiles 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"
}
طلب المتابعة
بالنظر إلى المعرّف الدائم للملف الشخصي الذي تم عرضه في المثال السابق، يمكنك الحصول على مزيد من المعلومات حول الملف الشخصي باستخدام Chrome Management Profiles 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"
}