Method: customers.reports.findSaasUsageProfiles

सर्च और सॉर्ट करने के दिए गए मानदंड के आधार पर, प्रोफ़ाइल के हिसाब से ग्रुप किए गए किसी ग्राहक के सॉफ़्टवेयर ऐज़ ए सर्विस (सैस) के इस्तेमाल की रिपोर्ट ढूंढें.

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

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

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

पाथ पैरामीटर

पैरामीटर
customer

string

ज़रूरी है. ग्राहक का आईडी, जिसे "customers/C" या "customers/my_customer" से शुरू किया जाता है.

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

पैरामीटर
app

string

ज़रूरी है. सैस ऐप्लिकेशन का नाम. जैसे, ChatGPT, Gemini.
pageSize

integer

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

string

ज़रूरी नहीं. पेज टोकन, जो reports.findSaasUsageProfiles के पिछले कॉल से मिला हो. अगला पेज पाने के लिए, यह टोकन दें.
filter

string

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

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

  • ईमेल
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

ज़रूरी नहीं. सैस प्रोफ़ाइल की रिपोर्ट को सॉर्ट करने का एक्सप्रेशन.

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

  • ईमेल
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

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

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

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

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

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

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

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

object (SaasUsageProfileReport)

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

string

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

string (int64 format)

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

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

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

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

SaasUsageProfileReport

यह सैस की एक रिपोर्ट की एंट्री है, जिसे प्रोफ़ाइल के हिसाब से ग्रुप किया गया है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "email": string,
  "profilePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
फ़ील्ड
email

string

सिर्फ़ आउटपुट के लिए. उपयोगकर्ता का ईमेल.
profilePermanentId

string

सिर्फ़ आउटपुट के लिए. प्रोफ़ाइल का परमानेंट आईडी.
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".
orgUnitId

string

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

enum (DeviceSystem)

सिर्फ़ आउटपुट के लिए. ओएस प्लैटफ़ॉर्म.
osVersion

string

सिर्फ़ आउटपुट के लिए. ओएस वर्शन.