Method: customers.enterprise.securityInsights.queryUrlVisitsBreakdowns

यह फ़ंक्शन, किसी दी गई मेट्रिक और ब्रेकडाउन डाइमेंशन के लिए, यूआरएल विज़िट की खास जानकारी दिखाता है.

एचटीटीपी अनुरोध

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/enterprise/securityInsights:queryUrlVisitsBreakdowns

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
customer

string

ज़रूरी है. "customers/{customer_id}" फ़ॉर्मैट में ग्राहक आईडी.

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

ज़रूरी नहीं. ज़्यादा से ज़्यादा कितने ब्रेकडाउन दिखाने हैं. ऐसा हो सकता है कि सेवा इस वैल्यू से कम नतीजे दिखाए. अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 50 ब्रेकडाउन दिखेंगे. इसकी ज़्यादा से ज़्यादा वैल्यू 1,000 हो सकती है. इससे ज़्यादा वैल्यू डालने पर, उसे 1,000 पर सेट कर दिया जाएगा.
pageToken

string

ज़रूरी नहीं. यह एक पेज टोकन है, जो पिछली securityInsights.queryUrlVisitsBreakdowns कॉल से मिला था. अगला पेज पाने के लिए, यह जानकारी दें.

पेज नंबर के हिसाब से डेटा दिखाने के दौरान, securityInsights.queryUrlVisitsBreakdowns को दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए.
filter

string

ज़रूरी नहीं. अनुरोध पर लागू किया जाने वाला फ़िल्टर. सिंटैक्स के लिए, AIP-160 देखें. यह डेटा, 180 दिन से ज़्यादा पुराने इवेंट या 48 घंटे से कम समय पहले हुए इवेंट के लिए उपलब्ध नहीं है. अगर event_time की जानकारी नहीं दी जाती है, तो नतीजे 48 घंटे पहले खत्म हो जाएंगे.

फ़िल्टर करने के लिए इस्तेमाल किए जा सकने वाले फ़ील्ड: - user - event_domain - event_time

user या event_domain के हिसाब से फ़िल्टर करने के लिए, breakdown डाइमेंशन को उससे जुड़ी वैल्यू पर सेट करना ज़रूरी है. उदाहरण के लिए, user के हिसाब से फ़िल्टर करने के लिए, आपको breakdown = USER को सेट करना होगा.

इस्तेमाल किए जा सकने वाले ऑपरेटर: - user और event_domain के लिए =. - event_time के लिए <=.

इन कंजंक्शन का इस्तेमाल किया जा सकता है: - AND

उदाहरण: user = "testuser" AND event_time <= "2024-01-02T00:00:00Z"
metric

enum (UrlVisitsMetric)

ज़रूरी नहीं. वह मेट्रिक जिसके लिए ब्रेकडाउन दिखाना है. डिफ़ॉल्ट रूप से, URL_VISITS_METRIC_TOTAL_SUSPICIOUS_URL_VISITS पर सेट होता है.
breakdown

enum (UrlVisitsBreakdownDimension)

ज़रूरी नहीं. यूआरएल पर हुई विज़िट को इस डाइमेंशन के हिसाब से ब्रेक डाउन किया जाता है. डिफ़ॉल्ट रूप से USER पर सेट होता है.
fixedTimeRange

enum (FixedTimeRange)

ज़रूरी नहीं. वह तय समयसीमा जिसके लिए ब्रेकडाउन की जानकारी दिखानी है. डिफ़ॉल्ट रूप से FIXED_TIME_RANGE_FOUR_WEEKS पर सेट होता है. समय की तय सीमा का इस्तेमाल, पहले से हिसाब लगाने और जवाब देने में लगने वाले समय को ऑप्टिमाइज़ करने के लिए किया जाता है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

securityInsights.queryUrlVisitsBreakdowns के लिए जवाब का मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "urlVisitsBreakdowns": [
    {
      object (UrlVisitsBreakdown)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
urlVisitsBreakdowns[]

object (UrlVisitsBreakdown)

इस इनसाइट से मिले यूआरएल विज़िट का ब्यौरा.
nextPageToken

string

यह एक टोकन है. इसका इस्तेमाल pageToken के तौर पर किया जा सकता है, ताकि अगला पेज वापस पाया जा सके. अगर इस फ़ील्ड को खाली छोड़ा जाता है, तो इसके बाद कोई पेज नहीं होता.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/chrome.management.securityinsights.readonly
  • https://www.googleapis.com/auth/chrome.management.securityinsights

UrlVisitsBreakdownDimension

यूआरएल पर हुई विज़िट को इस डाइमेंशन के हिसाब से ब्रेक डाउन किया जाता है.

Enums
URL_VISITS_BREAKDOWN_DIMENSION_UNSPECIFIED ब्रेकडाउन डाइमेंशन की जानकारी नहीं दी गई है. डिफ़ॉल्ट रूप से USER पर सेट होता है.
USER उपयोगकर्ता के हिसाब से ब्रेकडाउन.
EVENT_DOMAIN इवेंट डोमेन के हिसाब से ब्रेकडाउन.

UrlVisitsBreakdown

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

JSON के काेड में दिखाना 
{
  "summary": {
    object (UrlVisitsSummary)
  },

  // Union field dimension can be only one of the following:
  "user": string,
  "eventDomain": string
  // End of list of possible types for union field dimension.
}
फ़ील्ड
summary

object (UrlVisitsSummary)

ब्रेकडाउन डाइमेंशन के लिए, यूआरएल विज़िट का खास जानकारी वाला डेटा.
यूनियन फ़ील्ड dimension. ब्रेकडाउन के लिए डाइमेंशन. dimension इनमें से सिर्फ़ एक हो सकता है:
user

string

यूआरएल पर आने वाला उपयोगकर्ता.
eventDomain

string

यूआरएल विज़िट का इवेंट डोमेन.