Method: customers.reports.findSaasUsage

सर्च और सॉर्ट करने के लिए दिए गए मानदंड के आधार पर, किसी ग्राहक के लिए सैस के इस्तेमाल की रिपोर्ट ढूंढें.

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

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findSaasUsage

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

पाथ पैरामीटर

पैरामीटर
customer

string

ज़रूरी है. ग्राहक आईडी को धुंधला किया गया है. इसके आगे "customers/C" या "customers/my_customer" जोड़ा गया है.

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

पैरामीटर
pageSize

integer

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

string

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

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

string

ज़रूरी नहीं. सैस की रिपोर्ट को फ़िल्टर करने के लिए, फ़िल्टर एक्सप्रेशन का इस्तेमाल करें. इन ऑपरेटर का इस्तेमाल किया जा सकता है: =, !=, <, <=, >, >=, :. लॉजिकल ऑपरेटर AND, OR, और NOT का इस्तेमाल किया जा सकता है.

इन फ़ील्ड का इस्तेमाल किया जा सकता है:

  • ऐप्लिकेशन
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • कैटगरी
  • संगठन
  • foundedYear
  • headquarters
  • primaryDomain
  • डोमेन
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

उदाहरण: (firstNavigationTime < "2026-01-31T00:00:00Z" AND lastNavigationTime > "2026-01-01T00:00:00Z") AND visitsCount > 100
orderBy

string

ज़रूरी नहीं. सैस की रिपोर्ट को सॉर्ट करने के लिए, ऑर्डर बाय एक्सप्रेशन का इस्तेमाल करें.

इन फ़ील्ड का इस्तेमाल किया जा सकता है:

  • ऐप्लिकेशन
  • कैटगरी
  • संगठन
  • foundedYear
  • headquarters
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

डिफ़ॉल्ट ऑर्डर, बढ़ते क्रम में होता है. किसी फ़ील्ड के लिए घटते क्रम में ऑर्डर तय करने के लिए, " desc" जोड़ें.

उदाहरण: visitsCount desc

अनुरोध का मुख्य हिस्सा

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

जवाब का मुख्य हिस्सा

reports.findSaasUsage तरीके का जवाब.

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

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

object (SaasUsageReport)

सैस के इस्तेमाल की रिपोर्ट की सूची.
nextPageToken

string

यह टोकन, pageToken के तौर पर भेजा जा सकता है, ताकि अगला पेज पाया जा सके. अगर यह फ़ील्ड शामिल नहीं किया जाता है, तो इसका मतलब है कि कोई और पेज नहीं है.
totalSize

string (int64 format)

अनुरोध से मेल खाने वाली, सैस के इस्तेमाल की रिपोर्ट की कुल संख्या.

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

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

SaasUsageReport

यह सैस की रिपोर्ट की एक एंट्री है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "app": string,
  "orgUnitId": string,
  "category": string,
  "organization": string,
  "foundedYear": integer,
  "headquarters": string,
  "primaryDomain": string,
  "domains": [
    string
  ],
  "encryptionProtocols": [
    string
  ],
  "visitsCount": string,
  "distinctUsersCount": string,
  "distinctBrowsersCount": string,
  "contentTransferDetails": {
    object (ContentTransferDetails)
  },
  "firstNavigationTime": string,
  "lastNavigationTime": string
}
फ़ील्ड
app

string

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन का नाम.
orgUnitId

string

सिर्फ़ आउटपुट के लिए. संगठन की इकाई का आईडी.
category

string

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन की कैटगरी.
organization

string

सिर्फ़ आउटपुट के लिए. वह संगठन जो ऐप्लिकेशन बनाता है.
foundedYear

integer

सिर्फ़ आउटपुट के लिए. वह साल जिसमें संगठन की स्थापना की गई थी.
headquarters

string

सिर्फ़ आउटपुट के लिए. संगठन का मुख्यालय.
primaryDomain

string

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन का प्राइमरी डोमेन.
domains[]

string

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन से जुड़े डोमेन और सबडोमेन की सूची.
encryptionProtocols[]

string

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन को ऐक्सेस करने के लिए इस्तेमाल किए जाने वाले एन्क्रिप्ट (सुरक्षित) करने के प्रोटोकॉल की सूची.
visitsCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन पर आने वाली कुल विज़िट की संख्या.
distinctUsersCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन पर आने वाले अलग-अलग उपयोगकर्ताओं की संख्या.
distinctBrowsersCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन पर आने वाले अलग-अलग ब्राउज़र की संख्या.
contentTransferDetails

object (ContentTransferDetails)

सिर्फ़ आउटपुट के लिए. अगर उपलब्ध हो, तो कॉन्टेंट ट्रांसफ़र इवेंट के बारे में जानकारी देता है.
firstNavigationTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह टाइमस्टैंप जब ऐप्लिकेशन को पहली बार नेविगेट किया गया था.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
lastNavigationTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह टाइमस्टैंप जब ऐप्लिकेशन को आखिरी बार नेविगेट किया गया था.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

ContentTransferDetails

अगर उपलब्ध हो, तो कॉन्टेंट ट्रांसफ़र इवेंट के बारे में जानकारी देता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "contentTransferCount": string
}
फ़ील्ड
contentTransferCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. ऐप्लिकेशन से जुड़े कॉन्टेंट ट्रांसफ़र की कुल संख्या.