Method: activities.watch

অ্যাকাউন্ট কার্যক্রমের জন্য বিজ্ঞপ্তি পাওয়া শুরু করুন। আরও তথ্যের জন্য, পুশ বিজ্ঞপ্তি প্রাপ্তি দেখুন।

HTTP অনুরোধ

POST https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}/watch

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
userKey or all

string

প্রোফাইল আইডি বা ব্যবহারকারীর ইমেল প্রতিনিধিত্ব করে যার জন্য ডেটা ফিল্টার করা উচিত। all তথ্য বা ব্যবহারকারীর অনন্য Google Workspace প্রোফাইল আইডি বা তাদের প্রাথমিক ইমেল ঠিকানার জন্য userKey হতে পারে। মুছে ফেলা ব্যবহারকারী হতে হবে না। একটি মুছে ফেলা ব্যবহারকারীর জন্য, showDeleted=true সহ ডিরেক্টরি API-তে users.list কল করুন, তারপর userKey হিসাবে ফেরত ID ব্যবহার করুন।

applicationName

enum ( ApplicationName )

অ্যাপ্লিকেশনের নাম যার জন্য ঘটনাগুলি পুনরুদ্ধার করা হবে৷

ক্যোয়ারী প্যারামিটার

পরামিতি
actorIpAddress

string

ইন্টারনেট প্রোটোকল (আইপি) হোস্টের ঠিকানা যেখানে অনুষ্ঠানটি সঞ্চালিত হয়েছিল। যে ব্যবহারকারীর কার্যকলাপ রিপোর্ট করা হচ্ছে তার IP ঠিকানা ব্যবহার করে রিপোর্টের সারাংশ ফিল্টার করার এটি একটি অতিরিক্ত উপায়। এই IP ঠিকানা ব্যবহারকারীর শারীরিক অবস্থান প্রতিফলিত করতে পারে বা নাও হতে পারে। উদাহরণস্বরূপ, IP ঠিকানাটি ব্যবহারকারীর প্রক্সি সার্ভারের ঠিকানা বা ভার্চুয়াল প্রাইভেট নেটওয়ার্ক (VPN) ঠিকানা হতে পারে। এই পরামিতি IPv4 এবং IPv6 ঠিকানা সংস্করণ উভয় সমর্থন করে।

customerId

string

ডেটা পুনরুদ্ধার করার জন্য গ্রাহকের অনন্য আইডি।

endTime

string

রিপোর্টে দেখানো সময়ের পরিসীমার শেষ সেট করে। তারিখটি RFC 3339 ফর্ম্যাটে , উদাহরণস্বরূপ 2010-10-28T10:26:35.000Z৷ ডিফল্ট মান হল API অনুরোধের আনুমানিক সময়। একটি API রিপোর্টের তিনটি মৌলিক সময় ধারণা রয়েছে:

  • একটি প্রতিবেদনের জন্য API-এর অনুরোধের তারিখ : যখন API তৈরি করে এবং প্রতিবেদনটি পুনরুদ্ধার করে।
  • প্রতিবেদনের শুরুর সময় : প্রতিবেদনে দেখানো সময়কালের শুরু। startTime অবশ্যই endTime আগে হতে হবে (যদি নির্দিষ্ট করা থাকে) এবং বর্তমান সময় যখন অনুরোধ করা হয়, অথবা API একটি ত্রুটি ফেরত দেয়।
  • রিপোর্টের শেষ সময় : রিপোর্টে দেখানো সময়সীমার শেষ। উদাহরণস্বরূপ, একটি প্রতিবেদনে সংক্ষিপ্ত ইভেন্টের সময়সীমা এপ্রিলে শুরু হতে পারে এবং মে মাসে শেষ হতে পারে। রিপোর্ট নিজেই আগস্টে অনুরোধ করা যেতে পারে.
যদি endTime নির্দিষ্ট করা না থাকে, তাহলে প্রতিবেদনটি startTime থেকে বর্তমান সময় পর্যন্ত বা সাম্প্রতিক 180 দিনের সমস্ত ক্রিয়াকলাপ ফেরত দেয় যদি startTime অতীতে 180 দিনের বেশি হয়।

eventName

string

API দ্বারা অনুসন্ধান করা হচ্ছে ইভেন্টের নাম। প্রতিটি eventName একটি নির্দিষ্ট Google Workspace পরিষেবা বা বৈশিষ্ট্যের সাথে সম্পর্কিত যা এপিআই ইভেন্টের প্রকারে সংগঠিত করে। অ্যাডমিন কনসোল অ্যাপ্লিকেশনের রিপোর্টে Google ক্যালেন্ডার ইভেন্টগুলির একটি উদাহরণ৷ ক্যালেন্ডার সেটিংস type কাঠামোতে API দ্বারা রিপোর্ট করা সমস্ত ক্যালেন্ডার eventName কার্যকলাপ রয়েছে৷ যখন একজন প্রশাসক একটি ক্যালেন্ডার সেটিং পরিবর্তন করে, তখন API ক্যালেন্ডার সেটিংসের type এবং eventName প্যারামিটারে এই কার্যকলাপটি রিপোর্ট করে। eventName ক্যোয়ারী স্ট্রিং এবং প্যারামিটার সম্পর্কে আরও তথ্যের জন্য, applicationName এ উপরের বিভিন্ন অ্যাপ্লিকেশনের জন্য ইভেন্ট নামের তালিকাটি দেখুন।

filters

string

filters ক্যোয়ারী স্ট্রিং হল একটি কমা-বিভক্ত তালিকা যা রিলেশনাল অপারেটরদের দ্বারা পরিচালিত ইভেন্ট প্যারামিটারের সমন্বয়ে গঠিত। ইভেন্ট প্যারামিটারগুলি আকারে আছে {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...

এই ইভেন্ট প্যারামিটারগুলি একটি নির্দিষ্ট eventName এর সাথে যুক্ত। অনুরোধের প্যারামিটার যদি eventName এর অন্তর্গত না হয় তাহলে একটি খালি রিপোর্ট ফেরত দেওয়া হয়। প্রতিটি অ্যাপ্লিকেশনের জন্য উপলব্ধ eventName ক্ষেত্র এবং তাদের সম্পর্কিত পরামিতি সম্পর্কে আরও তথ্যের জন্য, অ্যাপ্লিকেশননাম টেবিলে যান, তারপরে আপনি যে অ্যাপ্লিকেশনটি চান তার জন্য পরিশিষ্টের কার্যকলাপ ইভেন্ট পৃষ্ঠায় ক্লিক করুন৷

নিম্নলিখিত ড্রাইভ কার্যকলাপের উদাহরণগুলিতে, প্রত্যাবর্তিত তালিকায় সমস্ত edit ইভেন্ট রয়েছে যেখানে doc_id প্যারামিটার মান রিলেশনাল অপারেটর দ্বারা সংজ্ঞায়িত শর্তের সাথে মেলে। প্রথম উদাহরণে, অনুরোধটি 12345 এর সমান একটি doc_id মান সহ সমস্ত সম্পাদিত নথি ফেরত দেয়। দ্বিতীয় উদাহরণে, রিপোর্টটি কোনো সম্পাদিত নথি ফেরত দেয় যেখানে doc_id মান 98765 এর সমান নয়। অনুরোধের ক্যোয়ারী স্ট্রিং ( %3C%3E ) এ <> অপারেটরটি URL-এনকোড করা হয়েছে :

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

একটি filters ক্যোয়ারী এই রিলেশনাল অপারেটরকে সমর্থন করে:

  • == —'সমান'।
  • <> —'সমান নয়'। URL-এনকোড করা আবশ্যক (%3C%3E)।
  • < —'এর চেয়ে কম'। অবশ্যই URL-এনকোডেড (%3C) হতে হবে।
  • <= —'এর চেয়ে কম বা সমান'। URL-এনকোড করা আবশ্যক (%3C=)।
  • > -'এর চেয়ে বড়'। অবশ্যই URL-এনকোডেড (%3E) হতে হবে।
  • >= —'এর চেয়ে বড় বা সমান'। URL-এনকোড করা আবশ্যক (%3E=)।

দ্রষ্টব্য: API একই প্যারামিটারের একাধিক মান গ্রহণ করে না। যদি API অনুরোধে একটি প্যারামিটার একাধিকবার সরবরাহ করা হয়, তবে API শুধুমাত্র সেই প্যারামিটারের শেষ মানটি গ্রহণ করে। উপরন্তু, যদি API অনুরোধে একটি অবৈধ প্যারামিটার সরবরাহ করা হয়, API সেই পরামিতিটিকে উপেক্ষা করে এবং অবশিষ্ট বৈধ প্যারামিটারগুলির সাথে সম্পর্কিত প্রতিক্রিয়া প্রদান করে। যদি কোন পরামিতি অনুরোধ না করা হয়, সব পরামিতি ফেরত দেওয়া হয়.

maxResults

integer

প্রতিটি প্রতিক্রিয়া পৃষ্ঠায় কতগুলি কার্যকলাপ রেকর্ড দেখানো হয়েছে তা নির্ধারণ করে। উদাহরণস্বরূপ, যদি অনুরোধটি maxResults=1 সেট করে এবং প্রতিবেদনে দুটি ক্রিয়াকলাপ থাকে, প্রতিবেদনটিতে দুটি পৃষ্ঠা থাকে। প্রতিক্রিয়ার nextPageToken সম্পত্তিতে দ্বিতীয় পৃষ্ঠার টোকেন রয়েছে। অনুরোধে maxResults ক্যোয়ারী স্ট্রিং ঐচ্ছিক। ডিফল্ট মান 1000।

orgUnitID
(deprecated)

string

Deprecated । এই ক্ষেত্রটি অপ্রচলিত এবং আর সমর্থিত নয়৷

রিপোর্ট করার জন্য সাংগঠনিক ইউনিটের আইডি। কার্যকলাপের রেকর্ড শুধুমাত্র নির্দিষ্ট সাংগঠনিক ইউনিটের অন্তর্গত ব্যবহারকারীদের জন্য দেখানো হবে।

pageToken

string

পরবর্তী পৃষ্ঠা নির্দিষ্ট করার জন্য টোকেন। একাধিক পৃষ্ঠা সহ একটি প্রতিবেদনের প্রতিক্রিয়াতে nextPageToken বৈশিষ্ট্য রয়েছে। রিপোর্টের পরবর্তী পৃষ্ঠা পাওয়ার জন্য আপনার ফলো-অন অনুরোধে, pageToken ক্যোয়ারী স্ট্রিং-এ nextPageToken মান লিখুন।

startTime

string

রিপোর্টে দেখানো সময়ের সীমার শুরু সেট করে। তারিখটি RFC 3339 ফর্ম্যাটে , উদাহরণস্বরূপ 2010-10-28T10:26:35.000Z৷ প্রতিবেদনটি startTime থেকে endTime পর্যন্ত সমস্ত ক্রিয়াকলাপ ফিরিয়ে দেয়। startTime অবশ্যই endTime আগে হতে হবে (যদি নির্দিষ্ট করা থাকে) এবং বর্তমান সময় যখন অনুরোধ করা হয়, অথবা API একটি ত্রুটি ফেরত দেয়।

groupIdFilter

string

কমা বিভক্ত গ্রুপ আইডি (অস্পষ্ট) যেখানে ব্যবহারকারীর কার্যকলাপগুলি ফিল্টার করা হয়, অর্থাৎ প্রতিক্রিয়াটিতে শুধুমাত্র সেই ব্যবহারকারীদের কার্যকলাপ থাকবে যারা এখানে উল্লিখিত গ্রুপ আইডিগুলির অন্তত একটির অংশ। বিন্যাস: "id:abc123, id:xyz456"

শরীরের অনুরোধ

অনুরোধের মূল অংশে SubscriptionChannel এর একটি উদাহরণ রয়েছে।

প্রতিক্রিয়া শরীর

সম্পদ পরিবর্তনের জন্য দেখার জন্য ব্যবহৃত একটি বিজ্ঞপ্তি চ্যানেল।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "id": string,
  "token": string,
  "expiration": string,
  "type": string,
  "address": string,
  "payload": boolean,
  "params": {
    string: string,
    ...
  },
  "resourceId": string,
  "resourceUri": string,
  "kind": string
}
ক্ষেত্র
id

string

একটি UUID বা অনুরূপ অনন্য স্ট্রিং যা এই চ্যানেলটিকে সনাক্ত করে৷

token

string

এই চ্যানেলে বিতরিত প্রতিটি বিজ্ঞপ্তির সাথে লক্ষ্য ঠিকানায় একটি নির্বিচারে স্ট্রিং বিতরণ করা হয়। ঐচ্ছিক।

expiration

string ( int64 format)

মিলিসেকেন্ডে ইউনিক্স টাইমস্ট্যাম্প হিসাবে প্রকাশ করা বিজ্ঞপ্তি চ্যানেলের মেয়াদ শেষ হওয়ার তারিখ এবং সময়। ঐচ্ছিক।

type

string

এই চ্যানেলের জন্য ব্যবহৃত ডেলিভারি মেকানিজমের ধরন। মান "web_hook" এ সেট করা উচিত।

address

string

ঠিকানা যেখানে এই চ্যানেলের জন্য বিজ্ঞপ্তি বিতরণ করা হয়৷

payload

boolean

পেলোড চাই কিনা তা নির্দেশ করার জন্য একটি বুলিয়ান মান। একটি পেলোড হল ডেটা যা একটি HTTP POST, PUT, বা PATCH বার্তার মূল অংশে পাঠানো হয় এবং অনুরোধ সম্পর্কে গুরুত্বপূর্ণ তথ্য ধারণ করে। ঐচ্ছিক।

params

map (key: string, value: string)

ডেলিভারি চ্যানেলের আচরণ নিয়ন্ত্রণকারী অতিরিক্ত পরামিতি। ঐচ্ছিক।

"key": value জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }

resourceId

string

একটি অস্বচ্ছ আইডি যা এই চ্যানেলে যে সংস্থান দেখা হচ্ছে তা শনাক্ত করে৷ বিভিন্ন API সংস্করণ জুড়ে স্থিতিশীল।

resourceUri

string

দেখা সম্পদের জন্য একটি সংস্করণ-নির্দিষ্ট শনাক্তকারী।

kind

string

এটিকে একটি রিসোর্সের পরিবর্তন দেখার জন্য ব্যবহৃত একটি বিজ্ঞপ্তি চ্যানেল হিসাবে চিহ্নিত করে, যা হল " api#channel "৷

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।

আবেদনের নাম

অ্যাপ্লিকেশনের নাম যার জন্য ঘটনাগুলি পুনরুদ্ধার করা হবে৷

Enums
access_transparency

Google Workspace অ্যাক্সেস ট্রান্সপারেন্সি অ্যাক্টিভিটি বিভিন্ন ধরনের অ্যাক্সেস ট্রান্সপারেন্সি অ্যাক্টিভিটি ইভেন্টের তথ্য প্রদান করে।

admin

অ্যাডমিন কনসোল অ্যাপ্লিকেশানের অ্যাক্টিভিটি রিপোর্টগুলি বিভিন্ন ধরনের অ্যাডমিনিস্ট্রেটর অ্যাক্টিভিটি ইভেন্ট সম্পর্কে অ্যাকাউন্টের তথ্য প্রদান করে।

calendar

Google ক্যালেন্ডার অ্যাপ্লিকেশানের কার্যকলাপের প্রতিবেদনগুলি বিভিন্ন ক্যালেন্ডার কার্যকলাপ ইভেন্টের তথ্য প্রদান করে৷

chat চ্যাট কার্যকলাপ রিপোর্ট বিভিন্ন চ্যাট কার্যকলাপ ইভেন্ট সম্পর্কে তথ্য প্রদান করে।
drive

Google ড্রাইভ অ্যাপ্লিকেশনের কার্যকলাপ প্রতিবেদনগুলি বিভিন্ন Google ড্রাইভ কার্যকলাপ ইভেন্ট সম্পর্কে তথ্য প্রদান করে৷ Drive অ্যাক্টিভিটি রিপোর্ট শুধুমাত্র Google Workspace Business এবং Google Workspace এন্টারপ্রাইজ গ্রাহকদের জন্য উপলভ্য।

gcp Google ক্লাউড প্ল্যাটফর্ম অ্যাপ্লিকেশানের কার্যকলাপের প্রতিবেদনগুলি বিভিন্ন GCP কার্যকলাপ ইভেন্টের তথ্য প্রদান করে৷
gplus Google+ অ্যাপ্লিকেশানের অ্যাক্টিভিটি রিপোর্ট বিভিন্ন Google+ অ্যাক্টিভিটি ইভেন্ট সম্পর্কে তথ্য প্রদান করে।
groups

Google Groups অ্যাপ্লিকেশানের অ্যাক্টিভিটি রিপোর্ট বিভিন্ন গ্রুপ অ্যাক্টিভিটি ইভেন্ট সম্পর্কে তথ্য প্রদান করে।

groups_enterprise

এন্টারপ্রাইজ গ্রুপের কার্যকলাপ রিপোর্ট বিভিন্ন এন্টারপ্রাইজ গ্রুপ কার্যকলাপ ইভেন্ট সম্পর্কে তথ্য প্রদান করে।

jamboard Jamboard কার্যকলাপ রিপোর্ট বিভিন্ন Jamboard কার্যকলাপ ইভেন্ট সম্পর্কে তথ্য ফেরত.
login

লগইন অ্যাপ্লিকেশনের কার্যকলাপ রিপোর্ট বিভিন্ন ধরনের লগইন কার্যকলাপ ইভেন্ট সম্পর্কে অ্যাকাউন্ট তথ্য প্রদান করে।

meet Meet অডিট অ্যাক্টিভিটি রিপোর্ট বিভিন্ন ধরনের Meet অডিট অ্যাক্টিভিটি ইভেন্টের তথ্য প্রদান করে।
mobile ডিভাইস অডিট কার্যকলাপ রিপোর্ট বিভিন্ন ধরনের ডিভাইস অডিট কার্যকলাপ ইভেন্ট সম্পর্কে তথ্য প্রদান করে।
rules

নিয়ম কার্যকলাপ রিপোর্ট বিভিন্ন ধরনের নিয়ম কার্যকলাপ ইভেন্ট সম্পর্কে তথ্য প্রদান করে।

saml

SAML কার্যকলাপ রিপোর্ট বিভিন্ন ধরনের SAML কার্যকলাপ ইভেন্ট সম্পর্কে তথ্য প্রদান করে।

token

টোকেন অ্যাপ্লিকেশানের অ্যাক্টিভিটি রিপোর্ট বিভিন্ন ধরনের টোকেন অ্যাক্টিভিটি ইভেন্ট সম্পর্কে অ্যাকাউন্ট তথ্য প্রদান করে।

user_accounts

ব্যবহারকারীর অ্যাকাউন্ট অ্যাপ্লিকেশানের কার্যকলাপের প্রতিবেদনগুলি বিভিন্ন ধরনের ব্যবহারকারী অ্যাকাউন্ট কার্যকলাপ ইভেন্ট সম্পর্কে অ্যাকাউন্ট তথ্য প্রদান করে।

context_aware_access

কনটেক্সট-সচেতন অ্যাক্সেস অ্যাক্টিভিটি রিপোর্টগুলি কনটেক্সট-সচেতন অ্যাক্সেস নিয়মের কারণে ব্যবহারকারীদের অ্যাক্সেস অস্বীকৃত ইভেন্টগুলির তথ্য প্রদান করে।

chrome

Chrome কার্যকলাপ রিপোর্টগুলি Chrome ব্রাউজার এবং Chrome OS ইভেন্ট সম্পর্কে তথ্য প্রদান করে৷

data_studio ডেটা স্টুডিও অ্যাক্টিভিটি রিপোর্ট বিভিন্ন ধরনের ডেটা স্টুডিও অ্যাক্টিভিটি ইভেন্টের তথ্য প্রদান করে।
keep Keep অ্যাপ্লিকেশনের কার্যকলাপের প্রতিবেদন বিভিন্ন Google Keep কার্যকলাপ ইভেন্ট সম্পর্কে তথ্য প্রদান করে। Keep অ্যাক্টিভিটি রিপোর্ট শুধুমাত্র Google Workspace ব্যবসা এবং এন্টারপ্রাইজ গ্রাহকদের জন্য উপলব্ধ।