تتيح لك "واجهة برمجة التطبيقات لإعداد التقارير" إنشاء تقارير تمنحك معلومات مجمّعة عن جهاز ChromeOS المُدار / نشر متصفّح Chrome.
نظرة عامة سريعة على طرق واجهات برمجة التطبيقات
ترتبط عناوين URL بـ https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER.
| الوصف | عنوان URL نسبي | طريقة Http | مَعلمات الطلب المسموح بها |
|---|---|---|---|
| عدد متصفِّحات Chrome التي تستدعي الانتباه في نطاقك | /reports:countChromeBrowsersNeedingAttention | GET | اختياري: orgUnitId |
| عدد أجهزة Chrome التي وصلت إلى تاريخ انتهاء الصلاحية التلقائي في نطاقك | /reports:countChromeDevicesReachingAutoExpirationDate | GET | اختياري: orgUnitId وminAueDate وmaxAueDate |
| عدد أجهزة Chrome التي تستدعي الانتباه في نطاقك | /reports:countChromeDevicesThatNeedAttention | GET | اختياري: orgUnitId وreadMask |
| احتساب عدد أجهزة Chrome في نطاقك | /reports:countChromeالأجهزةFleetDevices | GET | اختياري: orgUnitId وreadMask |
| حساب إصدارات Chrome المنشورة على الأجهزة في نطاقك | /reports:countChromeVersions | GET | اختياري: orgUnitId والفلتر وpageSize وpageToken |
| احتساب التطبيقات التي تم الإبلاغ عنها والمثبَّتة على جميع أجهزتك ومتصفّحاتك | /reports:countinstalledApps | GET | اختياري: orgUnitId والفلتر وpageSize وpageToken وorderBy |
| الحصول على ملخص لعمليات الطباعة التي تتم من خلال كل طابعة في نطاقك | /reports:countPrintJobsByPrinter | GET | اختياري: printOrgUnitId والفلتر وpageSize وpageToken و orderBy |
| الحصول على ملخّص لعمليات الطباعة التي يجريها كل مستخدم في نطاقك | /reports:countPrintJobsByUser | GET | اختياري: printOrgUnitId والفلتر وpageSize وpageToken و orderBy |
| الحصول على تقرير تفصيلي عن مهام الطباعة في نطاقك | /reports:enumeratePrintJobs | GET | اختياري: printOrgUnitId والفلتر وpageSize وpageToken و orderBy |
| إدراج الأجهزة التي تم تثبيت تطبيق معين عليها | /reports:findinstalledAppDevices | GET | اختياري: orgUnitId والفلتر وpageSize وpageToken وorderBy |
| الحصول على عدد أحداث أعطال Chrome | /reports:countChromeCrashevents | GET | اختياري: orgUnitId والفلتر و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 -> الإعدادات -> عرض تقرير قائمة الإضافات" |
| countChromeCrashEvents | "الخدمات -> إدارة Chrome -> عرض تقرير أعطال Chrome"
أو "الخدمات -> ChromeOS -> الإعدادات -> عرض تقرير أعطال Chrome" |
لإدارة أدوار المشرف وامتيازاته، انتقِل إلى "وحدة تحكّم المشرف -> أدوار المشرف".
نطاقات واجهة برمجة التطبيقات
تتطلب Reports API نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.reports.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.