Reports API: ग्राहक के इस्तेमाल की रिपोर्ट

ग्राहकों के इस्तेमाल की रिपोर्ट में, पूरे डोमेन के सभी उपयोगकर्ताओं के लिए, 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
      },
     ...
     ]
    }
   ]
  }
 ]
}