Method: customerUsageReports.get

• एचटीटीपी अनुरोध
• पाथ पैरामीटर
• क्वेरी पैरामीटर
• अनुरोध का मुख्य हिस्सा
• जवाब का मुख्य हिस्सा
• अनुमति पाने के लिंक
• इसे आज़माएं!

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

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

GET https://admin.googleapis.com/admin/reports/v1/usage/dates/{date}

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

पाथ पैरामीटर

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

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

पैरामीटर
customerId	string उस ग्राहक का यूनीक आईडी जिसका डेटा आपको चाहिए.
pageToken	string अगले पेज की जानकारी देने वाला टोकन. एक से ज़्यादा पेजों वाली रिपोर्ट के रिस्पॉन्स में nextPageToken प्रॉपर्टी होती है. रिपोर्ट के सभी पेजों को पाने के लिए, अपने फ़ॉलो-अप अनुरोधों में pageToken क्वेरी स्ट्रिंग में nextPageToken वैल्यू डालें.
parameters	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 फ़ॉर्मैट में होती है. ध्यान दें: एपीआई, किसी पैरामीटर की एक से ज़्यादा वैल्यू स्वीकार नहीं करता. अगर एपीआई अनुरोध में किसी पैरामीटर को एक से ज़्यादा बार दिया जाता है, तो एपीआई सिर्फ़ उस अनुरोध पैरामीटर की आखिरी वैल्यू स्वीकार करता है. इसके अलावा, अगर एपीआई अनुरोध में कोई अमान्य अनुरोध पैरामीटर दिया जाता है, तो एपीआई उस अनुरोध पैरामीटर को अनदेखा कर देता है और बाकी मान्य अनुरोध पैरामीटर के हिसाब से जवाब दिखाता है. अमान्य अनुरोध पैरामीटर का एक उदाहरण वह है जो ऐप्लिकेशन से नहीं जुड़ा है. अगर किसी पैरामीटर का अनुरोध नहीं किया जाता है, तो सभी पैरामीटर दिखाए जाते हैं.

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

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

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में UsageReports का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

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

• https://www.googleapis.com/auth/admin.reports.usage.readonly

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.