Chrome Management Security Insights API के लिए कोड के सैंपल

एपीआई की सुविधाओं के बारे में जानने के लिए, 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"
    }
  ]
}

ब्रेकडाउन के साथ कॉन्टेंट ट्रांसफ़र की खास जानकारी के बारे में क्वेरी करना

डाइमेंशन के हिसाब से ब्रेकडाउन करके कॉन्टेंट ट्रांसफ़र के बारे में क्वेरी करने के लिए, queryContentTransfersBreakdowns तरीके का इस्तेमाल करें. उदाहरण के लिए, USER के हिसाब से ब्रेकडाउन करें.

अनुरोध

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

अपने डोमेन के लिए, यूआरएल पर विज़िट करने से जुड़ी खास जानकारी के बारे में क्वेरी करना

संदिग्ध यूआरएल पर हुई विज़िट की खास जानकारी पाने के लिए, 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"
    }
  ]
}

क्वेरी यूआरएल पर जाने से जुड़ी खास जानकारी को अलग-अलग हिस्सों में बांटकर देखना

डाइमेंशन के हिसाब से ब्रेकडाउन करके यूआरएल विज़िट के बारे में क्वेरी करने के लिए, queryUrlVisitsBreakdowns तरीके का इस्तेमाल करें. जैसे, EVENT_DOMAIN के हिसाब से ब्रेकडाउन.

अनुरोध

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