ক্রোম ম্যানেজমেন্ট সিকিউরিটি ইনসাইটস এপিআই-এর জন্য কোড নমুনা

এপিআই বৈশিষ্ট্য সম্পর্কে তথ্যের জন্য ক্রোম ম্যানেজমেন্ট সিকিউরিটি ইনসাইটস এপিআই দেখুন।

নীচে দেখানো সমস্ত অনুরোধে নিম্নলিখিত ভেরিয়েবলগুলি ব্যবহার করা হয়েছে:

• $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 পদ্ধতিটি ব্যবহার করুন। আপনি ঐচ্ছিকভাবে 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"
      }
    }
  ]
}

আপনার ডোমেনের জন্য উচ্চ-স্তরের ইউআরএল ভিজিট সারাংশ অনুসন্ধান করুন।

সন্দেহজনক ইউআরএল ভিজিটগুলোর উচ্চ-স্তরের সারাংশ পেতে 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"
    }
  ]
}

বিস্তারিত বিবরণ সহ কোয়েরি ইউআরএল ভিজিট সারাংশ

ডাইমেনশন অনুযায়ী (যেমন, EVENT_DOMAIN অনুযায়ী) বিস্তারিত বিবরণসহ URL ভিজিট কোয়েরি করতে, 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"
      }
    }
  ]
}