Reports API: গ্রাহকদের ব্যবহারের রিপোর্ট

গ্রাহকদের ব্যবহারের রিপোর্ট সমগ্র ডোমেন জুড়ে সমস্ত ব্যবহারকারীর জন্য Google Workspace পরিষেবা ব্যবহারের তথ্য একত্রিত করে। ব্যবহারকারীর ব্যবহারের রিপোর্ট আপনার অ্যাকাউন্ট জুড়ে Google Workspace পরিষেবা ব্যবহারের তথ্য প্রদান করে। এই ব্যবহারের তথ্য অ্যাপ্লিকেশন প্রকার দ্বারা সংগঠিত হয় যা সেই অ্যাপ্লিকেশনের জন্য নির্দিষ্ট পরামিতিগুলির সমন্বয়ে গঠিত। প্রতিটি রিপোর্টের জন্য ডিফল্ট এবং সর্বোচ্চ সময়কাল হল শেষ 450 দিন।

এই ব্যবহার রিপোর্ট আপনার গ্রাহক চুক্তি অনুযায়ী শুধুমাত্র বৈধ উদ্দেশ্যে ব্যবহার করা যেতে পারে. এছাড়াও, এই রিপোর্টগুলি Google Workspace এবং Education-এর ক্ষেত্রে প্রযোজ্য।

একটি গ্রাহক ব্যবহার রিপোর্ট পুনরুদ্ধার করুন

আপনার অ্যাকাউন্টের কার্যকলাপের রিপোর্ট পুনরুদ্ধার করতে নিম্নলিখিত GET HTTP অনুরোধটি ব্যবহার করুন এবং অনুমোদন ডকুমেন্টেশনে বর্ণিত অনুমোদন টোকেন অন্তর্ভুক্ত করুন। পঠনযোগ্যতার জন্য, নিম্নলিখিত উদাহরণটি লাইন রিটার্নের সাথে ফর্ম্যাট করা হয়েছে:

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। আমরা আপনাকে এটির জন্য আপনার অ্যাকাউন্টের সময় অঞ্চল ব্যবহার করার পরামর্শ দিই৷ অনুরোধের ক্যোয়ারী স্ট্রিং এবং প্রতিক্রিয়া বৈশিষ্ট্য সম্পর্কে আরও তথ্যের জন্য, এপিআই রেফারেন্স এবং গ্রাহক ব্যবহারের রিপোর্ট প্যারামিটার রেফারেন্স দেখুন।

নিম্নলিখিত উদাহরণটি 2013-03-03 থেকে শুরু করে আপনার অ্যাকাউন্টে গত 30 দিনে সমস্ত সফল লগইন এবং অনুমোদিত অ্যাপ্লিকেশনগুলির একটি তালিকা, প্রতি অ্যাপ্লিকেশন ব্যবহারকারীর অনুমোদনের সংখ্যা সহ একটি প্রতিবেদন পায়। 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
      },
     ...
     ]
    }
   ]
  }
 ]
}