Method: customers.enterprise.securityInsights.queryContentTransfersBreakdowns

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

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

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

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

पाथ पैरामीटर

पैरामीटर
customer

string

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

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

पैरामीटर
pageSize

integer

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

string

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

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

string

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

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

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

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

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

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

enum (ContentTransfersMetric)

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

enum (ContentTransfersBreakdownDimension)

ज़रूरी नहीं. यह डाइमेंशन, कॉन्टेंट ट्रांसफ़र को अलग-अलग कैटगरी में बांटता है. डिफ़ॉल्ट रूप से USER पर सेट होता है.
fixedTimeRange

enum (FixedTimeRange)

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

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

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

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

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

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

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

object (ContentTransfersBreakdown)

चुनी गई अहम जानकारी के आधार पर, कॉन्टेंट ट्रांसफ़र के बारे में ज़्यादा जानकारी.
nextPageToken

string

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

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

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

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

ContentTransfersBreakdownDimension

यह डाइमेंशन, कॉन्टेंट ट्रांसफ़र को अलग-अलग कैटगरी में बांटता है.

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

ContentTransfersBreakdown

किसी दिए गए ब्रेकडाउन डाइमेंशन के लिए, कॉन्टेंट ट्रांसफ़र की खास जानकारी.

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

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

object (ContentTransfersSummary)

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

string

वह उपयोगकर्ता जिसने कॉन्टेंट ट्रांसफ़र किया है.
eventDomain

string

कॉन्टेंट ट्रांसफ़र करने के इवेंट का डोमेन.
contentCategory

string

कॉन्टेंट ट्रांसफ़र करने की सुविधा के लिए कॉन्टेंट की कैटगरी.