ग्राहक इस्तेमाल के बारे में जानकारी देने वाली रिपोर्ट में, पूरे डोमेन के सभी उपयोगकर्ताओं के लिए, 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 दिनों में आपके खाते में हुए सभी सफल लॉगिन की एक रिपोर्ट मिली है. इसमें
2013-03-33 से शुरू होने वाले, हर आवेदन के लिए अनुमति वाले ऐप्लिकेशन की सूची दी गई है. 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
},
...
]
}
]
}
]
}