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

এন্টিটি ব্যবহারের রিপোর্টটি আপনার অ্যাকাউন্টের ব্যবহারকারীদের দ্বারা ব্যবহৃত এন্টিটির সাথে সম্পর্কিত 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 HTTP অনুরোধটি ব্যবহার করুন এবং অনুমোদন ডকুমেন্টেশনে বর্ণিত অনুমোদন টোকেন অন্তর্ভুক্ত করুন। পঠনযোগ্যতার জন্য, নিম্নলিখিত উদাহরণটি লাইন রিটার্ন দিয়ে ফর্ম্যাট করা হয়েছে।

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

entityKey হল একটি সত্তা শনাক্তকারী যা সত্তা যেখানে বাস করে সেই অ্যাপ্লিকেশনের জন্য নির্দিষ্ট। আপনার আগ্রহের নির্দিষ্ট সত্তার জন্য entityKey কীভাবে পেতে হয় তার বিশদ বিবরণের জন্য API রেফারেন্স দেখুন৷ অন্যান্য পরামিতিগুলি সমস্ত সত্তা ব্যবহারের কার্যকলাপ পুনরুদ্ধার করার অধীনে উপরে নথিভুক্ত করা হয়েছে৷

ক্যোয়ারী স্ট্রিং প্যারামিটার এবং প্রতিক্রিয়া বৈশিষ্ট্য সম্পর্কে আরও তথ্যের জন্য, API রেফারেন্স দেখুন। সত্তা ব্যবহারের রিপোর্ট প্যারামিটার সম্পর্কে তথ্যের জন্য, সত্তা ব্যবহারের পরামিতি রেফারেন্স দেখুন।

উদাহরণ

নিম্নলিখিত উদাহরণটি entityKey "1234" সহ একটি gplus_community সত্তার জন্য সত্তা রিপোর্ট পায়।

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

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

একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড প্রদান করে। স্ট্যাটাস কোড সহ, প্রতিক্রিয়া একটি রিপোর্ট প্রদান করে। প্রতিক্রিয়ার কিছু প্যারামিটার পাঠযোগ্যতার জন্য বাদ দেওয়া হয়েছে।

সত্তা রিপোর্টের জন্য উদাহরণ JSON প্রতিক্রিয়া

{
 "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
    },
   ]
  }
 ]
}

সতর্কতা সহ সত্তা রিপোর্টের জন্য উদাহরণ JSON প্রতিক্রিয়া

অনুরোধটি পূরণ করা না গেলে প্রতিক্রিয়াতে এক বা একাধিক সতর্কতা ফেরত দেওয়া হতে পারে। এই উদাহরণে, অনুরোধ করার সময় প্রতিবেদনটি পাওয়া যায় না।

{
 "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": [],
}

warnings অ্যারের প্রতিটি এন্ট্রিতে নিম্নলিখিত পরামিতি রয়েছে:

• code : মেশিন-পাঠযোগ্য সতর্কতা কোড
• message : মানুষের পাঠযোগ্য সতর্কতা বার্তা
• data : কী-মানের জোড়ার তালিকা যা বিশদ সতর্কতা তথ্য দেয়