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