Reports API: ব্যবহারকারীদের ব্যবহারের প্রতিবেদন

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

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

সমস্ত ব্যবহারকারীর ব্যবহার কার্যক্রম পুনরুদ্ধার করুন

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

GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/yyyy-mm-dd date
?parameters=application: user usage parameter,...
&filters=application: user usage parameter relational operator usage parameter's value,...
&maxResults=number of events listed on each page of the report

dates মান হল ব্যবহার হওয়ার তারিখ এবং টাইমস্ট্যাম্পটি ISO 8601 ফর্ম্যাটে yyyy-mm-dd। ক্যোয়ারী স্ট্রিং প্যারামিটার এবং প্রতিক্রিয়া বৈশিষ্ট্য সম্পর্কে আরও তথ্যের জন্য, API রেফারেন্স দেখুন। ব্যবহারকারীর ব্যবহার প্রতিবেদন পরামিতি সম্পর্কে তথ্যের জন্য, ব্যবহারকারীর ব্যবহারের পরামিতি রেফারেন্স দেখুন।

নিম্নলিখিত উদাহরণ অ্যাকাউন্টের জন্য সমস্ত ব্যবহারকারীর কার্যকলাপের একটি প্রতিবেদন পায়।

GET https://admin.googleapis.com/admin/reports/v1/usage/users/all
/dates/2013-03-03?maxResults=2

নিম্নলিখিত উদাহরণটি একটি নির্দিষ্ট গ্রাহক অ্যাকাউন্টের জন্য সমস্ত ব্যবহারকারীর কার্যকলাপের একটি প্রতিবেদন পায়।

GET https://admin.googleapis.com/admin/reports/v1/usage/users/all
/dates/2013-03-03?customerId=C03az79cb

নিম্নলিখিত উদাহরণ অ্যাকাউন্টে ব্যবহারকারীদের শেষ লগইন টাইমস্ট্যাম্পের একটি প্রতিবেদন পায়। একটি API প্রতিক্রিয়ার উদাহরণের জন্য, JSON প্রতিক্রিয়া উদাহরণ দেখুন।

GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time&maxResults=2

নিম্নলিখিত উদাহরণটি অ্যাকাউন্টে ব্যবহারকারীদের শেষ লগইন টাইমস্ট্যাম্পের একটি প্রতিবেদন পায়, একটি নির্দিষ্ট সময়ের পরে লগ ইন করা ব্যবহারকারীদের দ্বারা ফিল্টার করা হয়। একটি API প্রতিক্রিয়ার উদাহরণের জন্য, JSON প্রতিক্রিয়া উদাহরণ দেখুন।

GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time&filters=accounts:last_login_time
>2010-10-28T10:26:35.000Z"

নিম্নলিখিত উদাহরণটি অ্যাকাউন্টে ব্যবহারকারীদের শেষ লগইন টাইমস্ট্যাম্প এবং স্থগিত অবস্থার একটি প্রতিবেদন পায়। একটি API প্রতিক্রিয়ার উদাহরণের জন্য, JSON প্রতিক্রিয়া উদাহরণ দেখুন।

GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time,accounts:is_disabled"

একটি নির্দিষ্ট ব্যবহারকারীর ব্যবহার কার্যক্রম পুনরুদ্ধার করুন

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

GET https://admin.googleapis.com/admin/reports/v1/usage/users/userKey/dates/yyyy-mm-dd date
?parameters=application: user usage parameter,...
&filters=application: user usage parameter relational operator usage parameter's value,...
&maxResults=number of events listed on each page of the report

userKey হয় রিপোর্টে ব্যবহারকারীর প্রাথমিক ইমেল ঠিকানা বা ব্যবহারকারীর অনন্য Google Workspace profileId হতে পারে। dates মান হল ব্যবহার হওয়ার তারিখ এবং টাইমস্ট্যাম্পটি ISO 8601 ফর্ম্যাটে yyyy-mm-dd। ক্যোয়ারী স্ট্রিং প্যারামিটার এবং প্রতিক্রিয়া বৈশিষ্ট্য সম্পর্কে আরও তথ্যের জন্য, API রেফারেন্স দেখুন। ব্যবহারকারীর ব্যবহার প্রতিবেদন পরামিতি সম্পর্কে তথ্যের জন্য, ব্যবহারকারীর ব্যবহারের পরামিতি রেফারেন্স দেখুন।

নিচের উদাহরণটি john@example.com-এর ব্যবহারের রিপোর্ট পায়।

https://admin.googleapis.com/admin/reports/v1/usage/users/john@example.com/dates/2013-03-03

ব্যবহার রিপোর্ট উদাহরণ JSON প্রতিক্রিয়া

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড প্রদান করে। স্ট্যাটাস কোড সহ, প্রতিক্রিয়া একটি রিপোর্ট প্রদান করে।

ব্যবহারকারীর প্রতিবেদনের জন্য 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": "USER",
    "customerId": "C03az79cb",
    "userEmail": "liz@example.com",
    "profileId": "user's unique Google Workspace ID"
   },
   "parameters": [
    {
      "name": "accounts:is_disabled",
      "boolValue": false
     },
    {
     "name": "accounts:disabled_reason",
     "stringValue": "reason description"
    },
    {
     "name": "accounts:first_name",
     "stringValue": "Liz"
    },
    {
     "name": "accounts:is_2sv_enforced",
     "boolValue": false
    },
    {
     "name": "accounts:is_2sv_enrolled",
     "boolValue": false
    },
    {
     "name": "accounts:last_name",
     "stringValue": "Smith"
    },
    {
     "name": "accounts:creation_time",
     "datetimeValue": "2010-10-28T10:26:35.000Z"
    },
    {
     "name": "accounts:last_login_time",
     "datetimeValue": "1970-01-01T00:00:00.000Z"
    },
    {
     "name": "accounts:last_sso_time",
     "datetimeValue": "1970-01-01T00:00:00.000Z"
    }
   ]
  }
 ]
}