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

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

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

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

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

আপনি আপনার ড্রাইভ নথি সম্পর্কে তথ্য তালিকাভুক্ত করতে ড্রাইভ কার্যকলাপ প্রতিবেদন ব্যবহার করতে পারেন৷ উদাহরণস্বরূপ, আপনি 180 দিন পর্যন্ত কভার করে আপনার অ্যাকাউন্টের 25টি সাম্প্রতিকতম ড্রাইভ ইভেন্ট তালিকাভুক্ত একটি প্রতিবেদনের অনুরোধ করতে পারেন৷ এই প্রতিবেদনটি পেতে, অনুমোদন গাইডে বর্ণিত একটি অনুমোদন টোকেন পান, তারপর নিম্নলিখিত HTTP GET অনুরোধটি ব্যবহার করুন:

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

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

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

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 ড্রাইভ ইভেন্ট পুনরুদ্ধার করুন

আপনি অনুমোদন গাইডে বর্ণিত অনুমোদন টোকেন সহ একটি HTTP 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 তথ্যের জন্য, ড্রাইভ ইভেন্টের নাম উল্লেখ দেখুন। অনুরোধের ক্যোয়ারী স্ট্রিং এবং প্রতিক্রিয়া বৈশিষ্ট্য সম্পর্কে আরও তথ্যের জন্য, 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": "[email protected]",
   "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": "[email protected]"
      }
      ]
     }
    ]
   },
  ]
 }