Reports API হল একটি RESTful API যেটি আপনি আপনার ব্যবহারকারীদের Google Workspace অ্যাক্টিভিটি সম্পর্কে তথ্য অ্যাক্সেস করতে ব্যবহার করতে পারেন। Reports API হল Admin SDK API-এর অংশ৷
Reports API দুই ধরনের রিপোর্ট প্রদান করে:
- কার্যকলাপ প্রতিবেদন, যা একটি নির্দিষ্ট অ্যাপ্লিকেশন বা পরিষেবার জন্য ইভেন্ট রিপোর্ট করে, যেমন Google ড্রাইভ বা অ্যাডমিন কনসোল।
- ব্যবহারের প্রতিবেদন, যা ব্যবহারকারীদের দ্বারা সৃষ্ট ওয়ার্কস্পেস ইভেন্টের তালিকা করে।
- গ্রাহকের ব্যবহার প্রতিবেদন আপনার ডোমেনের সমস্ত ব্যবহারকারীর জন্য ইভেন্ট তালিকাভুক্ত করে।
- ব্যবহারকারীর ব্যবহার প্রতিবেদন ব্যবহারকারী দ্বারা সংগঠিত ঘটনা তালিকা.
রিপোর্ট এপিআই-এ ব্যবহৃত সাধারণ পদগুলির একটি তালিকা নিচে দেওয়া হল:
- কার্যকলাপ রিপোর্ট
অ্যাক্টিভিটি রিপোর্ট একটি নির্দিষ্ট Google Workspace অ্যাপ্লিকেশন বা পরিষেবার কার্যকলাপের তথ্য তালিকাভুক্ত করে। কার্যকলাপ রিপোর্ট তারিখ, সময়, ব্যবহারকারী, এবং কার্যকলাপের ধরন অন্তর্ভুক্ত. এপিআই রেফারেন্সে অ্যাক্টিভিটি রিপোর্টের একটি সম্পূর্ণ তালিকা এবং সেগুলির অন্তর্ভুক্ত তথ্য রয়েছে। এখানে অ্যাপ্লিকেশন বা পরিষেবা দ্বারা তালিকাভুক্ত কিছু উদাহরণ কার্যকলাপ প্রতিবেদন রয়েছে:
- অ্যাডমিন অ্যাক্টিভিটি রিপোর্ট অ্যাডমিন কনসোল ব্যবহার করে অ্যাডমিনিস্ট্রেটরদের করা কার্যকলাপ দেখায়। উদাহরণস্বরূপ, অ্যাডমিন কনসোল ব্যবহার করে অ্যাডমিনিস্ট্রেটররা কতবার ব্যবহারকারীর নাম পরিবর্তন করেছে তার একটি তালিকা আপনি পেতে পারেন।
- আপনার ডোমেনের ব্যবহারকারীরা কীভাবে তাদের ড্রাইভ নথিগুলিকে সম্পাদনা করে এবং দেখেন তা Google ড্রাইভ কার্যকলাপের প্রতিবেদনগুলি তালিকাভুক্ত করে৷ উদাহরণস্বরূপ, আপনি ড্রাইভে একটি নির্দিষ্ট ব্যবহারকারীর কার্যকলাপের একটি তালিকা পেতে পারেন৷
- লগইন কার্যকলাপ রিপোর্ট আপনার অ্যাকাউন্টের ব্যবহারকারীরা তাদের অ্যাকাউন্ট থেকে লগ ইন এবং আউট তথ্য প্রদান করে. আপনি, উদাহরণস্বরূপ, একটি নির্দিষ্ট সময়ের মধ্যে আপনার ডোমেনের জন্য সমস্ত লগইনগুলির একটি প্রতিবেদন পেতে পারেন৷
- মোবাইল অ্যাক্টিভিটি রিপোর্ট Google মোবাইল ম্যানেজমেন্ট দ্বারা পরিচালিত মোবাইল ডিভাইস ব্যবহার করে কার্যকলাপ দেখায়। উদাহরণস্বরূপ, ব্যবহারকারীরা একটি নতুন ডিভাইস নিবন্ধন করলে আপনি একটি বিজ্ঞপ্তি পেতে পারেন৷
- OAuth টোকেন কার্যকলাপ প্রতিবেদনগুলি ইভেন্টগুলিকে তালিকাভুক্ত করে যখন আপনার ব্যবহারকারীরা তৃতীয় পক্ষের ওয়েবসাইট এবং অ্যাপ্লিকেশনগুলির দ্বারা ব্যবহৃত অনুমোদন টোকেনগুলি প্রদান করে বা প্রত্যাহার করে। ব্যবহারকারীর Google Workspace ডেটাতে সমস্ত থার্ড-পার্টি অ্যাক্সেসের তালিকা পেতে আপনি Reports API ব্যবহার করতে পারেন।
- ব্যবহারের প্রতিবেদন
ব্যবহারের রিপোর্ট আপনার ডোমেনে Google Workspace ইভেন্ট সম্পর্কে তথ্য প্রদান করে। আপনি ব্যবহারকারীদের সম্পর্কে নির্দিষ্ট তথ্যের জন্য অনুরোধ করতে API ব্যবহার করতে পারেন।
- গ্রাহকদের ব্যবহার প্রতিবেদন আপনার অ্যাকাউন্টে বিস্তারিত অ্যাপ্লিকেশন এবং পরিষেবা কার্যক্রম তালিকাভুক্ত করে। এই ব্যবহারের তথ্য অ্যাপ্লিকেশন প্রকার দ্বারা সংগঠিত এবং সেই অ্যাপ্লিকেশনের জন্য নির্দিষ্ট তথ্য রয়েছে।
- ব্যবহারকারীদের ব্যবহারের প্রতিবেদন আপনার অ্যাকাউন্টের ব্যবহারকারীদের দ্বারা কার্যকলাপ দেখায়। এই প্রতিবেদনগুলি নির্দিষ্ট ব্যবহারের তথ্যের জন্য কাস্টমাইজ এবং ফিল্টার করা যেতে পারে। এই ব্যবহারের তথ্য অ্যাপ্লিকেশন প্রকার দ্বারা সংগঠিত এবং সেই অ্যাপ্লিকেশনের জন্য নির্দিষ্ট তথ্য রয়েছে।
- কারেন্টস অ্যাপ্লিকেশানে আপনার অ্যাকাউন্টের ব্যবহারকারীদের দ্বারা ব্যবহৃত সত্ত্বাগুলির সাথে সম্পর্কিত কার্যকলাপের প্রতিবেদনগুলি সত্তার ব্যবহার প্রতিবেদনগুলি তালিকাভুক্ত করে৷
- বিজ্ঞপ্তি
- রিপোর্ট এপিআই বিজ্ঞপ্তি প্রদান করে যা আপনাকে ইভেন্টগুলি দেখতে দেয়, যেমন সম্পদে পরিবর্তন। আপনি যখন কোনো সম্পদ দেখছেন এবং সেই সম্পদের পরিবর্তন হচ্ছে, রিপোর্ট API আপনাকে একটি বিজ্ঞপ্তি পাঠায়। Reports API থেকে বিজ্ঞপ্তি সেট আপ এবং প্রাপ্তির বিষয়ে আরও তথ্যের জন্য, পুশ বিজ্ঞপ্তি প্রাপ্তির নির্দেশিকা দেখুন।
পরবর্তী পদক্ষেপ
রিপোর্ট এপিআই সম্পর্কে জানতে এবং এটি কাজ করে দেখতে, একটি কুইকস্টার্ট ব্যবহার করুন, যা বাম নেভিগেশন বারে প্রোগ্রামিং ভাষা দ্বারা তালিকাভুক্ত। আপনার অ্যাকাউন্ট সেট আপ করার বিষয়ে সাধারণ তথ্য পড়তে আপনি এই বিভাগের মাধ্যমে চালিয়ে যেতে পারেন।
অনুমোদন বিভাগ আপনাকে দেখায় কিভাবে Google Workspace অ্যাপ্লিকেশন এবং পরিষেবাগুলি থেকে ব্যবহারকারীর ডেটা পেতে OAuth 2.0 অ্যাক্সেস টোকেন ব্যবহার করতে হয়।
একটি নির্দিষ্ট রিসোর্স টাইপ বা পদ্ধতির বিশদ জানতে, API রেফারেন্স দেখুন।
আরও তথ্যের জন্য, অ্যাডমিন SDK API সমস্যা ট্র্যাকার , Google Workspace ডেভেলপারস ব্লগ এবং Google Workspace অ্যাডমিন সহায়তা কেন্দ্র দেখুন।