نماذج التعليمات البرمجية لواجهة برمجة التطبيقات "إحصاءات الأمان في Chrome Management"

يمكنك الاطّلاع على مستندات Chrome Management Security Insights API للحصول على معلومات عن ميزات واجهة برمجة التطبيقات.

تستخدم جميع الطلبات الموضّحة أدناه المتغيّرات التالية:

• $TOKEN : رمز OAuth 2 المميّز
• $CUSTOMER : رقم تعريف العميل أو القيمة الحرفية my_customer

التحقّق من حالة تفعيل الإحصاءات لنطاقك

للتحقّق من حالة تفعيل الإحصاءات لنطاقك، استخدِم طريقة checkEnablementStatus.

طلب

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:checkEnablementStatus"

الردّ

{
  "insightsState": "INSIGHTS_ENABLED"
}

تفعيل الإحصاءات لنطاقك

لتفعيل الإحصاءات لنطاقك، استخدِم طريقة enable. يمكنك اختياريًا ضبط موصِّلات Chrome لمجموعة معيّنة من الوحدات التنظيمية من خلال توفير targetOus. إذا لم يتم ضبط targetOus، يتم ضبط موصِّلات Chrome في الوحدة التنظيمية الجذر.

طلب

  curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "targetOus": [
      "/corp/sales",
      "/eng"
    ]
  }' \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:enable"

الردّ

{
  "insightsState": "INSIGHTS_ENABLED"
}

إيقاف الإحصاءات لنطاقك

لإيقاف الإحصاءات لنطاقك، استخدِم طريقة disable.

طلب

  curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}' \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:disable"

الردّ

{
  "insightsState": "INSIGHTS_DISABLED"
}

طلب ملخّصات عالية المستوى لعمليات نقل المحتوى لنطاقك

لاسترداد ملخّصات عالية المستوى لعمليات نقل المحتوى، استخدِم طريقة queryContentTransfers.

طلب

  curl -G \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "filter=event_time >= \"2026-05-01T00:00:00Z\" AND event_time <= \"2026-05-02T00:00:00Z\"" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:queryContentTransfers"

الردّ

{
  "summaries": [
    {
      "metric": "CONTENT_TRANSFERS_METRIC_TOTAL_SENSITIVE_TRANSFERS",
      "count": "918"
    },
    {
      "metric": "CONTENT_TRANSFERS_METRIC_TOTAL_DOWNLOADS",
      "count": "1537"
    },
    {
      "metric": "CONTENT_TRANSFERS_METRIC_TOTAL_UPLOADS",
      "count": "1532"
    },
    {
      "metric": "CONTENT_TRANSFERS_METRIC_SENSITIVE_UPLOADS",
      "count": "306"
    },
    {
      "metric": "CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS",
      "count": "4596"
    },
    {
      "metric": "CONTENT_TRANSFERS_METRIC_SENSITIVE_PRINTS",
      "count": "305"
    },
    {
      "metric": "CONTENT_TRANSFERS_METRIC_SENSITIVE_DOWNLOADS",
      "count": "307"
    },
    {
      "metric": "CONTENT_TRANSFERS_METRIC_TOTAL_PRINTS",
      "count": "1527"
    }
  ]
}

طلب ملخّصات عمليات نقل المحتوى مع تصنيفات تفصيلية

لطلب عمليات نقل المحتوى مع تصنيفات تفصيلية حسب المكوّن (مثل التصنيف التفصيلي حسب USER)، استخدِم طريقة queryContentTransfersBreakdowns.

طلب

  curl -G \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "breakdown=USER" \
  --data-urlencode "metric=CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS" \
  --data-urlencode "fixedTimeRange=FIXED_TIME_RANGE_FOUR_WEEKS" \
  --data-urlencode "filter=user = \"user1\" AND event_time <= \"2026-05-01T00:00:00Z\"" \
  --data-urlencode "pageSize=5" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:queryContentTransfersBreakdowns"

الردّ

{
  "contentTransfersBreakdowns": [
    {
      "user": "user1",
      "summary": {
        "metric": "CONTENT_TRANSFERS_METRIC_TOTAL_TRANSFERS",
        "count": "20"
      }
    }
  ]
}

طلب ملخّصات عالية المستوى لزيارات عناوين URL لنطاقك

لاسترداد ملخّصات عالية المستوى لزيارات عناوين URL المريبة، استخدِم طريقة queryUrlVisits.

طلب

  curl -G \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "filter=event_time >= \"2026-05-01T00:00:00Z\" AND event_time <= \"2026-05-02T00:00:00Z\"" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:queryUrlVisits"

الردّ

{
  "summaries": [
    {
      "metric": "URL_VISITS_METRIC_HIGH_RISK_URL_VISITS",
      "count": "286"
    },
    {
      "metric": "URL_VISITS_METRIC_LOW_RISK_URL_VISITS",
      "count": "287"
    },
    {
      "metric": "URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS",
      "count": "859"
    },
    {
      "metric": "URL_VISITS_METRIC_MEDIUM_RISK_URL_VISITS",
      "count": "286"
    }
  ]
}

طلب ملخّصات زيارات عناوين URL مع تصنيفات تفصيلية

لطلب زيارات عناوين URL مع تصنيفات تفصيلية حسب المكوّن (مثل التصنيف التفصيلي حسب EVENT_DOMAIN)، استخدِم طريقة queryUrlVisitsBreakdowns.

طلب

  curl -G \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "breakdown=EVENT_DOMAIN" \
  --data-urlencode "metric=URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS" \
  --data-urlencode "fixedTimeRange=FIXED_TIME_RANGE_ONE_WEEK" \
  --data-urlencode "filter=event_domain = \"suspicious-domain.com\" AND event_time <= \"2026-05-01T00:00:00Z\"" \
  --data-urlencode "pageSize=5" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/enterprise/securityInsights:queryUrlVisitsBreakdowns"

الردّ

{
  "urlVisitsBreakdowns": [
    {
      "eventDomain": "suspicious-domain.com",
      "summary": {
        "metric": "URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS",
        "count": "132"
      }
    }
  ]
}