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
},
...
]
}
]
}
]
}
जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.
आखिरी बार 2025-08-29 (UTC) को अपडेट किया गया.
[null,null,["आखिरी बार 2025-08-29 (UTC) को अपडेट किया गया."],[],[],null,["# Reports API: Customers Usage Report\n\nThe Customers usage report\naggregates Google Workspace service usage information, for all users, across an entire domain.\nThe user usage report returns Google Workspace service usage information across your account.\nThis usage information is organized by application type which is composed of parameters specific to that application.\nThe default and maximum time period for each report is the last 450 days.\n\nThese usage report may be used only for lawful purposes in accordance with your Customer Agreement. Also, these\nreports apply to Google Workspace and Education.\n\nRetrieve a customer usage report\n--------------------------------\n\nTo retrieve report of your account activities use the following `GET` HTTP request and include the authorization token\ndescribed in the [authorization documentation](/workspace/admin/reports/v1/guides/authorizing). For readability,\nthe following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/usage/dates/yyyy-mm-dd date\n?parameters=app name: usage parameter,...\n&customerId=the customer's ID\n&maxResults=number of events listed on each page of the report\n```\n\nThe `dates` value is the date the usage occurred and the timestamp is in the [ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601), yyyy-mm-dd. We recommend you use your account's time zone for this. For more information about the request's query strings and response properties, see the [API Reference](/workspace/admin/reports/v1/reference/customerUsageReports/get) and the [customer usage report parameters reference](/workspace/admin/reports/v1/reference/usage-ref-appendix-a/customers).\n\nThe following example gets a report with the total of all successful logins to your account in the past 30 days and a list\nof authorized applications, with the number of user authorizations per application, starting 2013-03-03. The `maxResults`\nquery string shows this report returns two events per report page: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/usage/dates/2013-03-03\n?parameters=accounts:num_30day_logins%2Caccounts:authorized_apps&maxResults=2\n```\n\n#### JSON response for customer usage report\n\n```carbon\n{\n \"kind\": \"reports#usageReports\",\n \"warnings\": [\n {\n \"code\": warning machine-readable code,\n \"message\": warning human-readable message,\n \"data\": [\n {\n \"key\": key for key-value pair that gives detailed warning information,\n \"value\": value for key-value pair giving detailed warning information\n }\n ]\n }\n ],\n \"nextPageToken\": \"N:NNN:NNN:N:C03az79cb\",\n \"usageReports\": [\n {\n \"kind\": \"usageReport\",\n \"date\": \"2013-03-03\",\n \"entity\": {\n \"type\": \"CUSTOMER\",\n \"customerId\": \"C03az79cb\"\n },\n \"parameters\": [\n {\n \"name\": \"accounts:num_1day_logins\",\n \"intValue\": \"1\"\n },\n {\n \"name\": \"accounts:num_30day_logins\",\n \"intValue\": \"1\"\n },\n {\n \"name\": \"accounts:num_7day_logins\",\n \"intValue\": \"1\"\n },\n {\n \"name\": \"accounts:num_disabled_accounts\",\n \"intValue\": \"5\"\n },\n {\n \"name\": \"accounts:authorized_apps\",\n \"msgValue\": [\n {\n \"client_id\": \"1234.apps.googleusercontent.com\",\n \"client_name\": \"www.example.com\",\n \"num_users\": 2\n },\n {\n \"client_id\": \"4567.apps.googleusercontent.com\",\n \"client_name\": \"Example\",\n \"num_users\": 1\n },\n ...\n ]\n }\n ]\n }\n ]\n}\n```"]]
