تتيح لك Reports API إنشاء تقارير تقدّم لك معلومات مجمّعة حول نشر أجهزة ChromeOS / متصفّح Chrome المُدارة.
نظرة عامة سريعة على طرق واجهة برمجة التطبيقات
تكون عناوين URL مرتبطة بالموقع الإلكتروني https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| الوصف | عنوان URL نسبي | طريقة Http | مَعلمات الطلبات المسموح بها |
|---|---|---|---|
| عدد متصفّحات Chrome التي تستدعي الانتباه في نطاقك | /reports:countChromeBrowsersNeedingAttention | الاطّلاع على | اختياري: orgUnitId |
| عدد أجهزة Chrome التي اقترب تاريخ انتهاء صلاحية الحصول التلقائي على التحديثات في نطاقك | /reports:countChromeDevicesReachingAutoExpirationDate | الاطّلاع على | اختياري: orgUnitId وminAueDate وmaxAueDate |
| عدد أجهزة Chrome التي تتطلّب اتخاذ إجراء في نطاقك | /reports:countChromeDevicesThatNeedAttention | الاطّلاع على | اختياري: orgUnitId وreadMask |
| إحصاء أجهزة أسطول أجهزة Chrome في نطاقك | /reports:countChromeHardwareFleetDevices | الاطّلاع على | اختياري: orgUnitId وreadMask |
| عدد إصدارات Chrome التي تم نشرها في الملفات الشخصية في نطاقك | /reports:countChromeProfileVersions | الاطّلاع على | اختيارية: orgUnitId وfilter وpageSize وpageToken |
| عدد إصدارات Chrome التي تم نشرها على الأجهزة في نطاقك | /reports:countChromeVersions | الاطّلاع على | اختيارية: orgUnitId وfilter وpageSize وpageToken |
| عدد التطبيقات المُبلغ عنها والمثبَّتة على جميع أجهزتك ومتصفّحاتك | /reports:countInstalledApps | الاطّلاع على | اختيارية: orgUnitId وfilter وpageSize وpageToken وorderBy |
| الحصول على ملخّص لعمليات الطباعة التي أجرتها كل طابعة في نطاقك | /reports:countPrintJobsByPrinter | الاطّلاع على | اختيارية: printerOrgUnitId وfilter وpageSize وpageToken وorderBy |
| الحصول على ملخّص لعمليات الطباعة التي أجراها كل مستخدم في نطاقك | /reports:countPrintJobsByUser | الاطّلاع على | اختيارية: printerOrgUnitId وfilter وpageSize وpageToken وorderBy |
| الحصول على تقرير مفصّل عن مهام الطباعة في نطاقك | /reports:enumeratePrintJobs | الاطّلاع على | اختيارية: printerOrgUnitId وfilter وpageSize وpageToken وorderBy |
| عرض قائمة بالأجهزة التي تم تثبيت تطبيق معيّن عليها | /reports:findInstalledAppDevices | الاطّلاع على | اختيارية: orgUnitId وfilter وpageSize وpageToken وorderBy |
| عرض قائمة الملفات الشخصية التي تم تثبيت تطبيق معيّن عليها | /reports:findInstalledAppProfiles | الاطّلاع على | اختيارية: orgUnitId وfilter وpageSize وpageToken وorderBy |
| الحصول على عدد أحداث الأعطال في Chrome | /reports:countChromeCrashEvents | الاطّلاع على | اختياري: orgUnitId وfilter وorderBy |
| العثور على تقارير استخدام SaaS في نطاقك | /reports:findSaasUsage | الاطّلاع على | اختيارية: filter وpageSize وpageToken وorderBy |
| العثور على تقارير استخدام SaaS في نطاقك مجمّعة حسب المتصفّحات | /reports:findSaasUsageBrowsers | الاطّلاع على | مطلوب: التطبيق، اختياري: الفلتر، وpageSize، وpageToken، وorderBy |
| العثور على تقارير استخدام SaaS في نطاقك مجمّعة حسب الملفات الشخصية | /reports:findSaasUsageProfiles | الاطّلاع على | مطلوب: التطبيق، اختياري: الفلتر، وpageSize، وpageToken، وorderBy |
اطّلِع على نماذج الرموز للاطّلاع على أمثلة للطلبات والاستجابات.
امتيازات المشرف
تلتزم Reports API بتفويض دور المشرف. استنادًا إلى التقارير التي يريد المشرف إنشاءها، يجب توفُّر امتيازات مختلفة للمشرف.
| الطريقة | امتيازات المشرف مطلوبة |
|---|---|
| countChromeBrowsersNeedingAttention | "الخدمات -> إدارة Chrome -> عرض تقرير إحصاءات Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير إحصاءات Chrome" |
| countChromeDevicesReachingAutoExpirationDate | "الخدمات -> إدارة Chrome -> عرض تقرير إحصاءات Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير إحصاءات Chrome" |
| countChromeDevicesThatNeedAttention | "الخدمات -> إدارة Chrome -> عرض تقرير إحصاءات Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير إحصاءات Chrome" |
| countChromeHardwareFleetDevices | "الخدمات -> إدارة Chrome -> عرض تقرير إحصاءات Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير إحصاءات Chrome" |
| countChromeProfileVersions | "الخدمات -> إدارة Chrome -> عرض تقرير إصدارات Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير إصدارات Chrome" |
| countChromeVersions | "الخدمات -> إدارة Chrome -> عرض تقرير إصدارات Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير إصدارات Chrome" |
| countInstalledApps | "الخدمات -> إدارة Chrome -> عرض تقرير قائمة الإضافات"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير قائمة الإضافات" |
| countPrintJobsByPrinter | "الخدمات -> إدارة Chrome -> عرض تقرير طابعات Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير طابعات Chrome" |
| countPrintJobsByUser | "الخدمات -> إدارة Chrome -> عرض تقرير طابعات Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير طابعات Chrome" |
| enumeratePrintJobs | "الخدمات -> إدارة Chrome -> عرض تقرير طابعات Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير طابعات Chrome" |
| findInstalledAppDevices | "الخدمات -> إدارة Chrome -> عرض تقرير قائمة الإضافات"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير قائمة الإضافات" |
| findInstalledAppProfiles | "الخدمات -> إدارة Chrome -> عرض تقرير قائمة الإضافات"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير قائمة الإضافات" |
| countChromeCrashEvents | "الخدمات -> إدارة Chrome -> عرض تقرير أعطال Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير أعطال Chrome" |
| findSaasUsage | "الخدمات -> إدارة Chrome -> عرض تقرير استخدام SaaS"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير استخدام SaaS" |
| findSaasUsageBrowsers | "الخدمات -> إدارة Chrome -> عرض تقرير استخدام SaaS"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير استخدام SaaS" |
| findSaasUsageProfiles | "الخدمات -> إدارة Chrome -> عرض تقرير استخدام SaaS"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير استخدام SaaS" |
لإدارة أدوار المشرفين وأذوناتهم، انتقِل إلى "وحدة تحكّم المشرف -> أدوار المشرف".
نطاقات واجهة برمجة التطبيقات
تتطلّب Reports API نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.reports.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.