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

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