রিপোর্ট এপিআই: ড্রাইভ অ্যাক্টিভিটি রিপোর্ট

ড্রাইভ অ্যাক্টিভিটি রিপোর্ট আপনার ব্যবহারকারীদের Google Workspace-এ Google Drive-এ ফাইল পরিচালনা, পরিবর্তন এবং শেয়ার করার সময় তাদের কার্যকলাপ সম্পর্কে তথ্য প্রদান করে। উদাহরণস্বরূপ, আপনি নির্দিষ্ট সময়ের মধ্যে একটি নির্দিষ্ট ব্যবহারকারীর দ্বারা তৈরি সমস্ত নতুন ড্রাইভ ডকুমেন্টের তালিকা পেতে ড্রাইভ অ্যাক্টিভিটি রিপোর্ট ব্যবহার করতে পারেন। আরও ভাল কন্টেন্ট ম্যানেজমেন্ট এবং সম্ভাব্য ডেটা ফাঁস সম্পর্কে অন্তর্দৃষ্টি পেতে আপনি এই তথ্য ব্যবহার করতে পারেন। একটি রিপোর্ট পেতে, আপনি ব্যবহারকারীর ইমেল ঠিকানা বা একটি নির্দিষ্ট ধরণের Google Drive পরিবর্তনের মতো রিপোর্ট-নির্দিষ্ট প্যারামিটার সহ মৌলিক রিপোর্ট এন্ডপয়েন্ট অনুরোধ ব্যবহার করেন। রিপোর্টে গত 180 দিন পর্যন্ত ডেটা অন্তর্ভুক্ত থাকতে পারে।

Google ড্রাইভ অ্যাক্টিভিটি রিপোর্ট শুধুমাত্র সেইসব অ্যাকাউন্টে বৈধ উদ্দেশ্যে ব্যবহার করা যেতে পারে যাদের লাইসেন্স দেওয়া হয়েছে।

অনুরোধের কোয়েরি স্ট্রিং এবং প্রতিক্রিয়া বৈশিষ্ট্য সম্পর্কে তথ্যের জন্য, API রেফারেন্স দেখুন। Google ড্রাইভ সম্পর্কিত নির্দিষ্ট ইভেন্ট সম্পর্কে তথ্যের জন্য, Drive ইভেন্টের নাম দেখুন।

একটি ডোমেনের জন্য Google ড্রাইভ ইভেন্টগুলি পুনরুদ্ধার করুন

আপনার ড্রাইভ ডকুমেন্ট সম্পর্কে তথ্য তালিকাভুক্ত করার জন্য আপনি ড্রাইভ অ্যাক্টিভিটি রিপোর্ট ব্যবহার করতে পারেন। উদাহরণস্বরূপ, আপনি আপনার অ্যাকাউন্টের ১৮০ দিন পর্যন্ত চলমান ২৫টি সাম্প্রতিক ড্রাইভ ইভেন্টের তালিকাভুক্ত একটি রিপোর্টের জন্য অনুরোধ করতে পারেন। এই রিপোর্টটি পেতে, অনুমোদন নির্দেশিকাতে বর্ণিত একটি অনুমোদন টোকেন পান, তারপর নিম্নলিখিত HTTP GET অনুরোধটি ব্যবহার করুন:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25

আপনি এই API কলের একটি উদাহরণ প্রতিক্রিয়া দেখতে পারেন।

নিম্নলিখিত উদাহরণটি গত ১৮০ দিনের সমস্ত ড্রাইভ ইভেন্টের একটি প্রতিবেদন পুনরুদ্ধার করে, যা সর্বোচ্চ সময়কাল।

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive

ব্যবহারকারীর দ্বারা Google ড্রাইভ ইভেন্টগুলি পুনরুদ্ধার করুন

কোনও নির্দিষ্ট ব্যবহারকারীর Google ড্রাইভ কার্যকলাপের প্রতিবেদন পুনরুদ্ধার করতে, অনুমোদন নির্দেশিকা নির্দেশিকায় বর্ণিত অনুমোদন টোকেন সহ একটি HTTP GET অনুরোধ ব্যবহার করুন। userKey ক্ষেত্রটি হল প্রতিবেদনে থাকা ব্যবহারকারীর প্রাথমিক ইমেল ঠিকানা, অথবা সকল ব্যবহারকারীর জন্য all ।

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

GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive

শেয়ার্ড ড্রাইভের জন্য Google ড্রাইভ ইভেন্টগুলি পুনরুদ্ধার করুন

অনুমোদন নির্দেশিকায় বর্ণিত GET টোকেন ব্যবহার করে আপনি একটি নির্দিষ্ট শেয়ার্ড ড্রাইভের জন্য Google ড্রাইভ কার্যকলাপের একটি প্রতিবেদন পুনরুদ্ধার করতে পারেন। আপনি যে ব্যবহারকারীর উপর প্রতিবেদনটি চালাতে চান তার ইমেল ঠিকানাটি userKey ক্ষেত্রে উল্লেখ করুন, অথবা সমস্ত ব্যবহারকারীর উপর প্রতিবেদনটি চালানোর জন্য all নির্দিষ্ট করুন।

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

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>

একটি শেয়ার্ড ড্রাইভের ইভেন্ট পুনরুদ্ধার করতে, doc_type ব্যবহার করে ফিল্টার করুন। নিম্নলিখিত উদাহরণটি সমস্ত শেয়ার্ড ড্রাইভকে প্রভাবিত করে এমন ইভেন্টগুলি পুনরুদ্ধার করে:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive

সদস্যপদ পরিবর্তনের জন্য ইভেন্টগুলি পুনরুদ্ধার করতে, shared_drive_membership_change ইভেন্টটি নির্দিষ্ট করুন। নিম্নলিখিত উদাহরণটি শেয়ার্ড ড্রাইভে সমস্ত সদস্য সংযোজন পুনরুদ্ধার করে:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive

ইভেন্টের ধরণ অনুসারে Google ড্রাইভ ইভেন্টগুলি পুনরুদ্ধার করুন

একটি নির্দিষ্ট ইভেন্ট ধরণের সমস্ত উদাহরণের রিপোর্ট পুনরুদ্ধার করতে, যেমন একটি ডকুমেন্ট তৈরি বা সম্পাদনা করা, অনুমোদন নির্দেশিকায় বর্ণিত অনুমোদন টোকেন সহ একটি HTTP GET অনুরোধ ব্যবহার করুন। userKey ক্ষেত্র হল প্রতিবেদনে ব্যবহারকারীর প্রাথমিক ইমেল ঠিকানা, অথবা সকল ব্যবহারকারীর জন্য all ।

নিম্নলিখিত উদাহরণটি সমস্ত অ্যাকাউন্ট ডকুমেন্টেশন তৈরির কার্যকলাপের একটি প্রতিবেদন পুনরুদ্ধার করে। একটি API প্রতিক্রিয়ার উদাহরণের জন্য, নমুনা JSON প্রতিক্রিয়া দেখুন:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create

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

যখন আপনি API-তে একটি HTTP GET অনুরোধ করেন, তখন একটি সফল প্রতিক্রিয়া একটি HTTP 200 স্ট্যাটাস কোড ফেরত পাঠায়। স্ট্যাটাস কোডের সাথে, প্রতিক্রিয়াটি ড্রাইভের জন্য একটি রিপোর্ট ফেরত পাঠায়। এই প্রতিবেদনগুলি অ্যাডমিন কনসোলেও পাওয়া যায়। আরও তথ্যের জন্য, Google Workspace অ্যাডমিন সহায়তা কেন্দ্র দেখুন। eventName তথ্যের জন্য, Drive ইভেন্টের নাম রেফারেন্স দেখুন। অনুরোধের কোয়েরি স্ট্রিং এবং প্রতিক্রিয়া বৈশিষ্ট্য সম্পর্কে আরও তথ্যের জন্য, API রেফারেন্স দেখুন।

{
 "kind": "reports#auditActivities",
 "nextPageToken": "next page's token",
 "items": [
  {
   "kind": "audit#activity",
   "id": {
    "time": "2014-03-17T15:39:18.460Z",
    "uniqQualifier": "report's unique ID",
    "applicationName": "drive",
    "customerId": "ABC123xyz"
   },
   "actor": {
   "callerType": "USER",
   "email": "kim@example.com",
   "profileId": "user's unique Google Workspace profile ID",
   "key": "consumer key of requestor in an OAuth 2LO request"
   },
   "ownerDomain": "domain of the source owner",
   "ipAddress": "user's IP address",
   "events": [
    {
     "type": "access",
     "name": "edit",
     "parameters": [
      {
        "name": "primary_event",
        "boolValue": true
      },
      {
        "name": "owner_is_shared_drive",
        "boolValue": false
      },      {
        "name": "doc_id",
        "value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
      },
      {
        "name": "doc_title",
        "value": "Meeting notes"
      },
      {
        "name": "doc_type",
        "value": "document"
      },
      {
        "name": "owner",
        "value": "mary@example.com"
      }
      ]
     }
    ]
   },
  ]
 }