نمونه کد برای API بینش‌های امنیتی مدیریت کروم

برای اطلاعات بیشتر در مورد ویژگی‌های API، به Chrome Management Security Insights API مراجعه کنید.

تمام درخواست‌های نشان داده شده در زیر از متغیرهای زیر استفاده می‌کنند:

• توکن $TOKEN - توکن OAuth 2
• $CUSTOMER - شناسه مشتری یا به عبارت دیگر my_customer

وضعیت فعال‌سازی را برای مشاهده‌ی اطلاعات دامنه‌ی خود بررسی کنید

برای بررسی وضعیت فعال‌سازی Insights برای دامنه خود، از متد checkEnablementStatus استفاده کنید.

درخواست

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

پاسخ

{
  "insightsState": "INSIGHTS_ENABLED"
}

فعال کردن بینش برای دامنه شما

برای فعال کردن بینش‌ها برای دامنه خود، از متد enable استفاده کنید. می‌توانید به صورت اختیاری با ارائه targetOus کانکتورهای کروم را برای مجموعه‌ای خاص از OUها پیکربندی کنید. اگر targetOus تنظیم نشده باشد، کانکتورهای کروم در OU ریشه پیکربندی می‌شوند.

درخواست

  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"
      }
    }
  ]
}