Method: userUsageReport.get

string

उस प्रोफ़ाइल आईडी या उपयोगकर्ता के ईमेल पते को दिखाता है जिसके लिए डेटा फ़िल्टर किया जाना चाहिए. यह वैल्यू, पूरी जानकारी के लिए all या उपयोगकर्ता के यूनीक Google Workspace प्रोफ़ाइल आईडी या उसके मुख्य ईमेल पते के लिए userKey हो सकती है. हटाया गया उपयोगकर्ता नहीं होना चाहिए. मिटाए गए उपयोगकर्ता के लिए, showDeleted=true के साथ Directory API में users.list को कॉल करें. इसके बाद, userKey के तौर पर दिखाए गए ID का इस्तेमाल करें.

string

यूटीसी-8:00 (पैसिफ़िक स्टैंडर्ड टाइम) के हिसाब से, इस्तेमाल होने की तारीख दिखाता है. टाइमस्टैंप, ISO 8601 फ़ॉर्मैट, yyyy-mm-dd में होना चाहिए.

string

उस ग्राहक का यूनीक आईडी जिसका डेटा आपको चाहिए.

string

filters क्वेरी स्ट्रिंग, किसी ऐप्लिकेशन के इवेंट पैरामीटर की सूची होती है. इसमें पैरामीटर की वैल्यू को रिलेशनल ऑपरेटर से मैनिप्युलेट किया जाता है. इस सूची में, पैरामीटर को कॉमा लगाकर अलग किया जाता है. filters क्वेरी स्ट्रिंग में, उस ऐप्लिकेशन का नाम शामिल होता है जिसका इस्तेमाल रिपोर्ट में दिखाया जाता है. उपयोगकर्ताओं के इस्तेमाल की रिपोर्ट के लिए, ऐप्लिकेशन की वैल्यू में accounts, docs, और gmail शामिल हैं.

फ़िल्टर [application name]:[parameter name][relational operator][parameter value],... फ़ॉर्मैट में होते हैं.

इस उदाहरण में, अनुरोध की क्वेरी स्ट्रिंग (%3C%3E) में <> 'बराबर नहीं है' ऑपरेटर को यूआरएल-एन्कोड किया गया है:

GET
https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time
&filters=accounts:last_login_time%3C%3E2010-10-28T10:26:35.000Z 

रिलेशनल ऑपरेटर में ये शामिल हैं:

• == - 'बराबर है'.
• <> - 'बराबर नहीं है'. यह यूआरएल-कोड (%3C%3E) है.
• < - 'कम है'. यह कोड में बदला गया यूआरएल है (%3C).
• <= - 'इससे कम या इसके बराबर है'. यह यूआरएल कोड में बदला गया है (%3C=).
• > - 'इससे ज़्यादा'. यह यूआरएल कोड में बदला गया है (%3E).
• >= - 'इससे ज़्यादा या इसके बराबर होना चाहिए'. यह यूआरएल कोड में बदला गया है (%3E=).

integer (uint32 format)

इससे यह तय होता है कि जवाब वाले हर पेज पर गतिविधि के कितने रिकॉर्ड दिखाए जाते हैं. उदाहरण के लिए, अगर अनुरोध maxResults=1 सेट करता है और रिपोर्ट में दो गतिविधियां हैं, तो रिपोर्ट में दो पेज होंगे. रिस्पॉन्स की nextPageToken प्रॉपर्टी में दूसरे पेज का टोकन होता है.
maxResults क्वेरी स्ट्रिंग का इस्तेमाल करना ज़रूरी नहीं है.

string

जिस संगठन की इकाई के लिए रिपोर्ट करनी है उसका आईडी. उपयोगकर्ता की गतिविधि सिर्फ़ उन उपयोगकर्ताओं को दिखेगी जो किसी खास संगठन की इकाई से जुड़े हैं.

string

अगला पेज बताने के लिए टोकन. एक से ज़्यादा पेजों वाली रिपोर्ट के रिस्पॉन्स में nextPageToken प्रॉपर्टी होती है. रिपोर्ट का अगला पेज पाने के लिए अपने फ़ॉलो-ऑन अनुरोध में, pageToken क्वेरी स्ट्रिंग में nextPageToken वैल्यू डालें.

string

parameters क्वेरी स्ट्रिंग, इवेंट पैरामीटर की एक सूची होती है. इसमें पैरामीटर को कॉमा लगाकर अलग किया जाता है. इससे रिपोर्ट के नतीजों को बेहतर बनाया जा सकता है. पैरामीटर किसी खास ऐप्लिकेशन से जुड़ा होता है. ग्राहकों के इस्तेमाल की रिपोर्ट के लिए, ऐप्लिकेशन की वैल्यू में accounts, app_maker, apps_scripts, calendar, classroom, cros, docs, gmail, gplus, device_management, meet, और sites शामिल हैं.
parameters क्वेरी स्ट्रिंग, app_name1:param_name1, app_name2:param_name2 के CSV फ़ॉर्मैट में है.

string

कॉमा से अलग किए गए ग्रुप आईडी (धुंधला किए गए), जिन पर उपयोगकर्ता गतिविधियों को फ़िल्टर किया जाता है. इसका मतलब है कि जवाब में सिर्फ़ उन उपयोगकर्ताओं की गतिविधियां शामिल होंगी जो यहां बताए गए कम से कम एक ग्रुप आईडी का हिस्सा हैं. फ़ॉर्मैट: "id:abc123,id:xyz456"