ग्राहक के इस्तेमाल की रिपोर्ट पूरे डोमेन में मौजूद सभी उपयोगकर्ताओं के लिए, Google Workspace की सेवाओं के इस्तेमाल की जानकारी इकट्ठा करता है. उपयोगकर्ता के इस्तेमाल की रिपोर्ट से, आपके खाते में मौजूद Google Workspace की सेवाओं के इस्तेमाल की जानकारी मिलती है. इस इस्तेमाल की जानकारी को ऐप्लिकेशन के प्रकार के हिसाब से व्यवस्थित किया जाता है. इसमें उस ऐप्लिकेशन के लिए खास पैरामीटर होते हैं. हर रिपोर्ट के लिए, डिफ़ॉल्ट और ज़्यादा से ज़्यादा समयावधि पिछले 450 दिनों की होती है.
ग्राहक के कानूनी समझौते के तहत, इस्तेमाल की इस रिपोर्ट का इस्तेमाल सिर्फ़ कानूनी मकसद के लिए किया जा सकता है. साथ ही, इन ये रिपोर्ट, Google Workspace और Education पर लागू होती हैं.
ग्राहक के इस्तेमाल की रिपोर्ट वापस पाना
अपने खाते की गतिविधियों की रिपोर्ट वापस पाने के लिए, इस GET एचटीटीपी अनुरोध का इस्तेमाल करें और अनुमति वाले टोकन को शामिल करें
अनुमति देने वाले दस्तावेज़ में बताया गया है. रीडबिलिटी के लिए,
नीचे दिए गए उदाहरण में, लाइन रिटर्न के डेटा को फ़ॉर्मैट किया गया है:
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/yyyy-mm-dd date ?parameters=app name: usage parameter,... &customerId=the customer's ID &maxResults=number of events listed on each page of the report
dates की वैल्यू, इस्तेमाल होने की तारीख होती है. साथ ही, टाइमस्टैंप ISO 8601 फ़ॉर्मैट, yyyy-mm-dd, में होता है. हमारा सुझाव है कि इसके लिए आप अपने खाते के टाइम ज़ोन का इस्तेमाल करें. अनुरोध की क्वेरी स्ट्रिंग और रिस्पॉन्स प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, एपीआई का रेफ़रंस और ग्राहक के इस्तेमाल की रिपोर्ट के पैरामीटर का रेफ़रंस देखें.
नीचे दिए गए उदाहरण में पिछले 30 दिनों में आपके खाते में सभी सफल लॉगिन की कुल संख्या के साथ एक रिपोर्ट दी गई है.
03-03-2013 से प्रति ऐप्लिकेशन उपयोगकर्ता प्राधिकरणों की संख्या के साथ अधिकृत ऐप्लिकेशन. maxResults
क्वेरी स्ट्रिंग से पता चलता है कि यह रिपोर्ट, हर रिपोर्ट पेज पर दो इवेंट दिखाती है:
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/2013-03-03 ?parameters=accounts:num_30day_logins%2Caccounts:authorized_apps&maxResults=2
ग्राहक के इस्तेमाल की रिपोर्ट के लिए, JSON रिस्पॉन्स
{
"kind": "reports#usageReports",
"warnings": [
{
"code": warning machine-readable code,
"message": warning human-readable message,
"data": [
{
"key": key for key-value pair that gives detailed warning information,
"value": value for key-value pair giving detailed warning information
}
]
}
],
"nextPageToken": "N:NNN:NNN:N:C03az79cb",
"usageReports": [
{
"kind": "usageReport",
"date": "2013-03-03",
"entity": {
"type": "CUSTOMER",
"customerId": "C03az79cb"
},
"parameters": [
{
"name": "accounts:num_1day_logins",
"intValue": "1"
},
{
"name": "accounts:num_30day_logins",
"intValue": "1"
},
{
"name": "accounts:num_7day_logins",
"intValue": "1"
},
{
"name": "accounts:num_disabled_accounts",
"intValue": "5"
},
{
"name": "accounts:authorized_apps",
"msgValue": [
{
"client_id": "1234.apps.googleusercontent.com",
"client_name": "www.example.com",
"num_users": 2
},
{
"client_id": "4567.apps.googleusercontent.com",
"client_name": "Example",
"num_users": 1
},
...
]
}
]
}
]
}