इकाइयों के इस्तेमाल की रिपोर्ट में, Google Workspace की सेवा से जुड़ी उन गतिविधियों की जानकारी मिलती है जो आपके खाते के उपयोगकर्ताओं ने की हैं. इन रिपोर्ट को अपनी पसंद के मुताबिक बनाया जा सकता है. साथ ही, इस्तेमाल से जुड़ी खास जानकारी के लिए इन्हें फ़िल्टर किया जा सकता है. यह डेटा पिछले 30 दिनों का होता है.
इकाइयों के इस्तेमाल की रिपोर्ट का इस्तेमाल, सिर्फ़ कानूनी तौर पर किया जा सकता है. इसके लिए, आपको ग्राहक समझौते का पालन करना होगा. ये रिपोर्ट, Google Workspace और Education पर भी लागू होती हैं.
सभी इकाइयों के इस्तेमाल से जुड़ी गतिविधियों को फिर से पाना
यह एपीआई सिर्फ़ Google+ कम्यूनिटी के साथ काम करता है. अपने खाते में मौजूद ऐप्लिकेशन इकाइयों से जुड़ी सभी गतिविधियों की रिपोर्ट पाने के लिए, यहां दिया गया GET एचटीटीपी अनुरोध इस्तेमाल करें. साथ ही, अनुमति से जुड़े दस्तावेज़ में बताया गया अनुमति वाला टोकन शामिल करें. पढ़ने में आसानी हो, इसके लिए यहां दिए गए उदाहरण को लाइन ब्रेक के साथ फ़ॉर्मैट किया गया है:
GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/date ?parameters=applicationParameters &filters=parameterFilters &maxResults=maxResults
date वैल्यू, इस्तेमाल की तारीख होती है. टाइमस्टैंप, ISO 8601 फ़ॉर्मैट में होता है, yyyy-mm-dd. हमारा सुझाव है कि इसके लिए, अपने खाते का टाइम ज़ोन इस्तेमाल करें. क्वेरी स्ट्रिंग पैरामीटर और रिस्पॉन्स प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, एपीआई रेफ़रंस देखें. इकाइयों के इस्तेमाल की रिपोर्ट के पैरामीटर के बारे में जानकारी के लिए, इकाइयों के इस्तेमाल के पैरामीटर का रेफ़रंस देखें.
applicationParameters, कॉमा लगाकर अलग किए गए उन पैरामीटर की सूची है जिन्हें आपको वापस पाना है.
हर पैरामीटर को application:parameter_name के तौर पर फ़ॉर्मैट किया जाता है. उदाहरण के लिए,
gplus:community_name. उपलब्ध पैरामीटर के बारे में जानकारी, इकाइयों के इस्तेमाल से जुड़े पैरामीटर के रेफ़रंस में दी गई है. अगर कोई पैरामीटर नहीं दिया गया है, तो सभी पैरामीटर दिखते हैं.
parameterFilters, नतीजों पर लागू किए जाने वाले फ़िल्टर की कॉमा लगाकर अलग की गई सूची है. हर फ़िल्टर को application:parameter_name[relational_operator]parameter_value के तौर पर फ़ॉर्मैट किया जाता है. उदाहरण के लिए, फ़िल्टर gplus:num_total_members>100, नतीजों को इस तरह से फ़िल्टर करता है कि सिर्फ़ वे नतीजे शामिल हों जिनमें gplus:num_total_members पैरामीटर की वैल्यू 100 से ज़्यादा हो.
maxResults, एक बार में फ़ेच किए जाने वाले नतीजों की ज़्यादा से ज़्यादा संख्या है. अगर नतीजों की कुल संख्या इससे ज़्यादा है, तो रिस्पॉन्स को छोटा कर दिया जाएगा और उसमें nextPageToken शामिल किया जाएगा. इसके बारे में ज़्यादा जानने के लिए, यहां दिया गया JSON रिस्पॉन्स का उदाहरण देखें.
उदाहरण
यहां दिए गए उदाहरण में, सभी gplus_communities इकाइयों के लिए सभी पैरामीटर वाली रिपोर्ट मिलती है.
GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all /dates/2017-12-11
यहां दिए गए उदाहरण में, सभी gplus_communities इकाइयों के लिए community_name पैरामीटर वाली रिपोर्ट मिलती है.
GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all /dates/2017-12-11?parameters=gplus:community_name
यहां दिए गए उदाहरण में, हर gplus_communities इकाई के लिए community_name और num_total_members की रिपोर्ट मिलती है. इसे 100 से ज़्यादा सदस्यों वाले समुदायों के हिसाब से फ़िल्टर किया जाता है. एपीआई से मिले जवाब का उदाहरण देखने के लिए, JSON रिस्पॉन्स का उदाहरण देखें.
GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-11 ?parameters=gplus:community_name,gplus:num_total_members&filters=gplus:num_total_members>100
किसी इकाई के लिए रिपोर्ट वापस पाना
किसी इकाई के लिए रिपोर्ट पाने के लिए, यहां दिया गया GET एचटीटीपी अनुरोध इस्तेमाल करें. साथ ही, अनुमति से जुड़े दस्तावेज़ में बताया गया अनुमति टोकन शामिल करें. पढ़ने में आसानी हो, इसके लिए यहां दिए गए उदाहरण को लाइन ब्रेक के साथ फ़ॉर्मैट किया गया है.
GET https://admin.googleapis.com/admin/reports/v1/gplus_communities/entityKey/dates/date ?parameters=applicationParameters &filters=parameterFilters &maxResults=maxResults
entityKey एक इकाई आइडेंटिफ़ायर है. यह उस ऐप्लिकेशन के लिए खास होता है जहां इकाई मौजूद है. आपको जिस इकाई के लिए entityKey चाहिए उसके बारे में जानने के लिए, एपीआई के बारे में जानकारी देखें. अन्य पैरामीटर के बारे में, इस सेक्शन में पहले बताया गया है: सभी इकाइयों के इस्तेमाल से जुड़ी गतिविधियां वापस पाना.
क्वेरी स्ट्रिंग पैरामीटर और रिस्पॉन्स प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, एपीआई रेफ़रंस देखें. इकाइयों के इस्तेमाल की रिपोर्ट के पैरामीटर के बारे में जानकारी पाने के लिए, इकाइयों के इस्तेमाल के पैरामीटर का रेफ़रंस देखें.
उदाहरण
यहां दिए गए उदाहरण में, gplus_community "1234" वाली gplus_community इकाई के लिए इकाई रिपोर्ट मिलती है.entityKey
https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/1234/dates/2017-12-11
इस्तेमाल की रिपोर्ट के JSON रिस्पॉन्स का उदाहरण
अनुरोध पूरा होने पर, HTTP 200 स्टेटस कोड मिलता है. जवाब में स्टेटस कोड के साथ-साथ एक रिपोर्ट भी मिलती है. जवाब में दिए गए कुछ पैरामीटर को पढ़ने में आसानी हो, इसलिए उन्हें शामिल नहीं किया गया है.
इकाइयों की रिपोर्ट के लिए JSON रिस्पॉन्स का उदाहरण
{ "kind": "reports#usageReports", "nextPageToken": "NjQ1OTgwODk0MzkxNDAwNjQ0OA", "usageReports": [ { "kind": "admin#reports#usageReport", "date": "2017-12-11", "entity": { "type": "OBJECT", "customerId": "C03az79cb", "objectType": "GPLUS_COMMUNITY", "objectId": "1234", }, "parameters": [ { "name": "gplus:community_name", "stringValue": "My Community" }, { "name": "gplus:num_total_members", "intValue": 37 }, { "name": "gplus:num_7day_active_members", "intValue": 12 }, { "name": "gplus:num_30day_active_members", "intValue": 17 }, ] } ] }
चेतावनी वाली इकाइयों की रिपोर्ट के लिए JSON रिस्पॉन्स का उदाहरण
अगर अनुरोध पूरा नहीं किया जा सकता, तो जवाब में एक या उससे ज़्यादा चेतावनियां दिख सकती हैं. इस उदाहरण में, अनुरोध किए जाने के समय रिपोर्ट उपलब्ध नहीं है.{
"kind": "reports#usageReports",
"warnings": [
{
"code": "PARTIAL_DATA_AVAILABLE"
"message": "Data for date 2017-12-11 for application gplus is not available right now, please try again after a few hours."
"data": [
{
"key": "date"
"value": "2017-12-11"
}
]
}
],
"usageReports": [],
}warnings कलेक्शन में मौजूद हर एंट्री में ये पैरामीटर शामिल होते हैं:
code: मशीन के पढ़ने लायक चेतावनी कोडmessage: चेतावनी वाला ऐसा मैसेज जिसे आसानी से पढ़ा जा सकेdata: की-वैल्यू पेयर की सूची, जिसमें चेतावनी के बारे में ज़्यादा जानकारी दी गई है