রিপোর্ট এপিআই: সত্তা ব্যবহারের রিপোর্ট

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

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

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

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

GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/date
?parameters=applicationParameters
&filters=parameterFilters
&maxResults=maxResults

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

applicationParameters হল একটি কমা দ্বারা পৃথক করা পরামিতিগুলির তালিকা যা আপনি পুনরুদ্ধার করতে চান। প্রতিটি প্যারামিটারটি application:parameter_name হিসাবে ফর্ম্যাট করা হয়েছে, উদাহরণস্বরূপ, gplus:community_name । উপলব্ধ পরামিতিগুলি সত্তা ব্যবহারের পরামিতি রেফারেন্সে নথিভুক্ত করা হয়েছে। কোনো পরামিতি নির্দিষ্ট না থাকলে, সব ফেরত দেওয়া হয়।

parameterFilters হল ফলাফলে প্রয়োগ করার জন্য ফিল্টারগুলির একটি কমা দ্বারা পৃথক করা তালিকা। প্রতিটি ফিল্টার application:parameter_name[relational_operator]parameter_value । উদাহরণ স্বরূপ, ফিল্টার gplus:num_total_members>100 শুধুমাত্র ফলাফল ধারণ করতে ফলাফলগুলিকে ফিল্টার করে যেখানে gplus:num_total_members প্যারামিটারের মান 100-এর বেশি থাকে।

maxResults হল একটি একক ফেচে ফেরার জন্য সর্বাধিক সংখ্যক ফলাফল। ফলাফলের মোট সংখ্যা এর থেকে বেশি হলে, প্রতিক্রিয়াটি কেটে ফেলা হবে এবং একটি nextPageToken অন্তর্ভুক্ত করা হবে (নীচে JSON প্রতিক্রিয়ার উদাহরণ দেখুন)।

উদাহরণ

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

GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all
/dates/2017-12-11

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

GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all
/dates/2017-12-11?parameters=gplus:community_name

নিম্নলিখিত উদাহরণটি প্রতিটি gplus_communities সত্তার জন্য community_name এবং num_total_members একটি প্রতিবেদন পায়, 100 টিরও বেশি সদস্যের সম্প্রদায় দ্বারা ফিল্টার করা হয়েছে। একটি API প্রতিক্রিয়ার উদাহরণের জন্য, JSON প্রতিক্রিয়া উদাহরণ দেখুন।

GET https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-11
?parameters=gplus:community_name,gplus:num_total_members&filters=gplus:num_total_members>100

GET https://admin.googleapis.com/admin/reports/v1/gplus_communities/entityKey/dates/date
?parameters=applicationParameters
&filters=parameterFilters
&maxResults=maxResults

https://admin.googleapis.com/admin/reports/v1/usage/gplus_communities/1234/dates/2017-12-11

{
 "kind": "reports#usageReports",
 "nextPageToken": "NjQ1OTgwODk0MzkxNDAwNjQ0OA",
 "usageReports": [
 {
   "kind": "admin#reports#usageReport",
   "date": "2017-12-11",
   "entity": {
    "type": "OBJECT",
    "customerId": "C03az79cb",
    "objectType": "GPLUS_COMMUNITY",
    "objectId": "1234",
   },
   "parameters": [
    {
      "name": "gplus:community_name",
      "stringValue": "My Community"
    },
    {
     "name": "gplus:num_total_members",
     "intValue": 37
    },
    {
     "name": "gplus:num_7day_active_members",
     "intValue": 12
    },
    {
     "name": "gplus:num_30day_active_members",
     "intValue": 17
    },
   ]
  }
 ]
}

{
 "kind": "reports#usageReports",
 "warnings": [
    {
      "code": "PARTIAL_DATA_AVAILABLE"
      "message": "Data for date 2017-12-11 for application gplus is not available right now, please try again after a few hours."
      "data": [
        {
          "key": "date"
          "value": "2017-12-11"
        }
      ]
    }
  ],
 "usageReports": [],
}