تتيح لك 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: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 |
اطّلِع على نماذج الرموز للاطّلاع على أمثلة للطلبات والاستجابات.
امتيازات المشرف
تلتزم Reports API بتفويض دور المشرف. استنادًا إلى التقارير التي يريد المشرف إنشاءها، يجب توفُّر امتيازات مختلفة للمشرف.
| الطريقة | امتيازات المشرف مطلوبة |
|---|---|
| countChromeBrowsersNeedingAttention | "الخدمات -> إدارة Chrome -> عرض تقرير إحصاءات Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير إحصاءات Chrome" |
| countChromeDevicesReachingAutoExpirationDate | "الخدمات -> إدارة Chrome -> عرض تقرير إحصاءات Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير إحصاءات Chrome" |
| countChromeDevicesThatNeedAttention | "الخدمات -> إدارة Chrome -> عرض تقرير إحصاءات Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير إحصاءات Chrome" |
| countChromeHardwareFleetDevices | "الخدمات -> إدارة 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" |
لإدارة أدوار المشرفين وأذوناتهم، انتقِل إلى "وحدة تحكّم المشرف -> أدوار المشرف".
نطاقات واجهة برمجة التطبيقات
تتطلّب Reports API نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.reports.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.