تتيح لك واجهة برمجة التطبيقات "إحصاءات الأمان" تفعيل ميزة "إحصاءات الأمان في Chrome" أو إيقافها، والتحقّق من حالة تفعيلها، والاستعلام عن بيانات الإحصاءات (مثل عمليات نقل المحتوى وعمليات زيارة عناوين URL).
نظرة عامة سريعة على طرق واجهة برمجة التطبيقات
تكون عناوين URL نسبية إلى
https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER
| الوصف | عنوان URL نسبي | طريقة طلب HTTP | مَعلمات الطلب المسموح بها |
|---|---|---|---|
| تفعيل الإحصاءات لنطاقك وضبط إعدادات وصلات Chrome لوحدة تنظيمية جذرية أو مجموعة معيّنة من الوحدات التنظيمية في نطاقك | /enterprise/securityInsights:enable | نشر مشاركة | اختياري: targetOus |
| إيقاف الإحصاءات لنطاقك | /enterprise/securityInsights:disable | نشر مشاركة | |
| التحقّق من حالة تفعيل الإحصاءات لنطاقك | /enterprise/securityInsights:checkEnablementStatus | الاطّلاع على | |
| الاستعلام عن ملخّصات عمليات نقل المحتوى عالية المستوى لنطاقك | /enterprise/securityInsights:queryContentTransfers | الاطّلاع على | اختياري: filter |
| الاستعلام عن ملخّصات عمليات نقل المحتوى مع تقسيمها حسب المستخدم أو النطاق أو فئة المحتوى | /enterprise/securityInsights:queryContentTransfersBreakdowns | الاطّلاع على | اختياري: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
| الاستعلام عن ملخّصات عمليات زيارة عناوين URL عالية المستوى لنطاقك | /enterprise/securityInsights:queryUrlVisits | الاطّلاع على | اختياري: filter |
| الاستعلام عن ملخّصات عمليات زيارة عناوين URL مع تقسيمها حسب المستخدم أو النطاق | /enterprise/securityInsights:queryUrlVisitsBreakdowns | الاطّلاع على | اختياري: filter, metric, breakdown, fixedTimeRange, pageSize, pageToken |
يمكنك الاطّلاع على نماذج الرموز لـ طلبات وأذونات مثال.
متطلبات الاشتراك
تتطلّب طرق واجهة برمجة التطبيقات التالية اشتراكًا نشطًا في Chrome Enterprise Premium. إذا لم يكن لدى العميل هذا الاشتراك، لن يتم حظر الطلبات، ولكن ستكون نتائج الاستعلام فارغة.
queryUrlVisitsqueryUrlVisitsBreakdowns
امتيازات المشرف
تتطلّب الطرق المختلفة لواجهة برمجة التطبيقات امتيازات مختلفة للمشرف.
| الطريقة | امتيازات المشرف المطلوبة |
|---|---|
| تفعيل | "الوحدات التنظيمية > القراءة" "الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات المستخدم" "الخدمات > منع فقدان البيانات في Chrome > إدارة إعدادات إحصاءات تطبيق منع فقدان البيانات في Chrome" |
| إيقاف | "الوحدات التنظيمية > القراءة" "الخدمات > إدارة Chrome > الإعدادات > إدارة إعدادات المستخدم" "الخدمات > منع فقدان البيانات في Chrome > إدارة إعدادات إحصاءات تطبيق منع فقدان البيانات في Chrome" |
| checkEnablementStatus | "الوحدات التنظيمية > القراءة" "الخدمات > منع فقدان البيانات في Chrome > إدارة إعدادات إحصاءات تطبيق منع فقدان البيانات في Chrome" أو "الخدمات > منع فقدان البيانات في Chrome > عرض إعدادات إحصاءات تطبيق منع فقدان البيانات في Chrome" |
| queryContentTransfers | "الخدمات > منع فقدان البيانات في Chrome > عرض إعدادات إحصاءات تطبيق منع فقدان البيانات في Chrome" |
| queryContentTransfersBreakdowns | "الخدمات > منع فقدان البيانات في Chrome > عرض إعدادات إحصاءات تطبيق منع فقدان البيانات في Chrome" |
| queryUrlVisits | "الخدمات > منع فقدان البيانات في Chrome > عرض إعدادات إحصاءات تطبيق منع فقدان البيانات في Chrome" |
| queryUrlVisitsBreakdowns | "الخدمات > منع فقدان البيانات في Chrome > عرض إعدادات إحصاءات تطبيق منع فقدان البيانات في Chrome" |
لإدارة أدوار المشرفين وامتيازاتهم، انتقِل إلى "وحدة تحكّم المشرف -> أدوار المشرف".
نطاقات واجهة برمجة التطبيقات
تتطلّب واجهات برمجة التطبيقات "تفعيل" و"إيقاف" نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.securityinsights
بالنسبة إلى checkEnablementStatus وجميع طرق الاستعلام، يمكن استخدام أي من النطاقَين التاليَين:
https://www.googleapis.com/auth/chrome.management.securityinsights
https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.