Google Workspace Events API স্কোপ বেছে নিন

এই ডকুমেন্টে Google Workspace Events API-নির্দিষ্ট অনুমোদন এবং প্রমাণীকরণের তথ্য রয়েছে। এই ডকুমেন্টটি পড়ার আগে, Learn about authentication and authorization -এ Google Workspace-এর সাধারণ প্রমাণীকরণ এবং অনুমোদনের তথ্য পড়তে ভুলবেন না।

অনুমোদনের জন্য OAuth 2.0 কনফিগার করুন

OAuth সম্মতি স্ক্রিনটি কনফিগার করুন এবং ব্যবহারকারী এবং অ্যাপ পর্যালোচকদের কাছে কোন তথ্য প্রদর্শিত হবে তা নির্ধারণ করার জন্য স্কোপগুলি নির্বাচন করুন এবং আপনার অ্যাপটি নিবন্ধন করুন যাতে আপনি পরে এটি প্রকাশ করতে পারেন।

Google Workspace ইভেন্ট API স্কোপ

আপনার অ্যাপে প্রদত্ত অ্যাক্সেসের স্তর নির্ধারণ করতে, আপনাকে অনুমোদনের স্কোপগুলি সনাক্ত করতে হবে এবং ঘোষণা করতে হবে। অনুমোদনের স্কোপ হল একটি OAuth 2.0 URI স্ট্রিং যাতে Google Workspace অ্যাপের নাম, এটি কী ধরণের ডেটা অ্যাক্সেস করে এবং অ্যাক্সেসের স্তর থাকে। স্কোপ হল ব্যবহারকারীদের Google অ্যাকাউন্ট ডেটা সহ Google Workspace ডেটার সাথে কাজ করার জন্য আপনার অ্যাপের অনুরোধ।

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

যখন সম্ভব, আমরা অ-সংবেদনশীল স্কোপ ব্যবহার করার পরামর্শ দিই কারণ এটি প্রতি-ফাইল অ্যাক্সেসের সুযোগ দেয় এবং একটি অ্যাপের জন্য প্রয়োজনীয় নির্দিষ্ট কার্যকারিতার অ্যাক্সেসকে সংকুচিত করে।

Google Workspace Events API সাবস্ক্রিপশন সমর্থন করে এমন Google Workspace অ্যাপ্লিকেশন থেকে স্কোপ ব্যবহার করে। যদি আপনার অ্যাপ ইতিমধ্যেই আপনার সাবস্ক্রিপশনের জন্য প্রয়োজনীয় স্কোপ ব্যবহার করে, তাহলে Google Workspace Events API ব্যবহার করার জন্য আপনাকে অতিরিক্ত স্কোপ যোগ করার প্রয়োজন নেই।

নিম্নলিখিত টেবিলটি Google Workspace Events API-এর জন্য সমর্থিত স্কোপগুলি প্রদর্শন করে:

স্কোপ কোড বিবরণ ব্যবহার
গুগল চ্যাট
https://www.googleapis.com/auth/chat.bot Google Chat অ্যাপগুলিকে চ্যাট দেখতে এবং বার্তা পাঠাতে দেয়। Chat অ্যাপগুলিতে উপলব্ধ সমস্ত বৈশিষ্ট্য অ্যাক্সেস দেয়। অ-সংবেদনশীল
https://www.googleapis.com/auth/chat.memberships Google Chat-এ কথোপকথন দেখুন, যোগ করুন এবং সদস্যদের সরিয়ে দিন।
সংবেদনশীল
https://www.googleapis.com/auth/chat.memberships.readonly Google Chat কথোপকথনে সদস্যদের দেখুন।
সংবেদনশীল
https://www.googleapis.com/auth/chat.app.memberships

Google Chat-এ চ্যাট অ্যাপ হিসেবে কথোপকথন এবং স্পেস থেকে সদস্যদের দেখুন, যোগ করুন, আপডেট করুন এবং সরান।

প্রশাসকের অনুমোদন প্রয়োজন।

এই স্কোপটি শুধুমাত্র পরিষেবা অ্যাকাউন্টের মাধ্যমে অ্যাপ প্রমাণীকরণ সমর্থন করে। আপনি এই স্কোপ ব্যবহার করে ব্যবহারকারীর শংসাপত্র বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে প্রমাণীকরণ করতে পারবেন না।


সংবেদনশীল
https://www.googleapis.com/auth/chat.spaces Google Chat-এ কথোপকথন এবং স্পেস তৈরি করুন এবং মেটাডেটা (ইতিহাসের সেটিংস সহ) দেখুন বা আপডেট করুন। সংবেদনশীল
https://www.googleapis.com/auth/chat.spaces.readonly Google Chat-এ চ্যাট এবং স্পেস দেখুন।
সংবেদনশীল
https://www.googleapis.com/auth/chat.app.spaces

চ্যাট অ্যাপ হিসেবে Google Chat-এ কথোপকথন এবং স্পেস তৈরি করুন এবং মেটাডেটা (ইতিহাসের সেটিংস সহ) দেখুন বা আপডেট করুন।

প্রশাসকের অনুমোদন প্রয়োজন।

এই স্কোপটি শুধুমাত্র পরিষেবা অ্যাকাউন্টের মাধ্যমে অ্যাপ প্রমাণীকরণ সমর্থন করে। আপনি এই স্কোপ ব্যবহার করে ব্যবহারকারীর শংসাপত্র বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে প্রমাণীকরণ করতে পারবেন না।


সংবেদনশীল
https://www.googleapis.com/auth/chat.messages.reaction এস চ্যাটে মেসেজে প্রতিক্রিয়া দেখুন, যোগ করুন এবং মুছুন।
সংবেদনশীল
https://www.googleapis.com/auth/chat.messages.reactions.readonly চ্যাটে কোনও বার্তার প্রতিক্রিয়া দেখুন।
সংবেদনশীল
https://www.googleapis.com/auth/chat.messages বার্তাগুলি দেখুন, রচনা করুন, পাঠান, আপডেট করুন এবং মুছে ফেলুন, এবং বার্তাগুলিতে প্রতিক্রিয়া যোগ করুন, দেখুন এবং মুছে ফেলুন। সীমাবদ্ধ
https://www.googleapis.com/auth/chat.messages.readonly Google Chat-এ মেসেজ এবং প্রতিক্রিয়া দেখুন।
সীমাবদ্ধ
https://www.googleapis.com/auth/chat.app.messages.readonly

Google Chat-এ চ্যাট অ্যাপ হিসেবে মেসেজ এবং প্রতিক্রিয়া দেখুন।

প্রশাসকের অনুমোদন প্রয়োজন।

এই স্কোপটি শুধুমাত্র পরিষেবা অ্যাকাউন্টের মাধ্যমে অ্যাপ প্রমাণীকরণ সমর্থন করে। আপনি এই স্কোপ ব্যবহার করে ব্যবহারকারীর শংসাপত্র বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে প্রমাণীকরণ করতে পারবেন না।


সীমাবদ্ধ
গুগল ড্রাইভ
https://www.googleapis.com/auth/drive.file নতুন ড্রাইভ ফাইল তৈরি করুন, অথবা বিদ্যমান ফাইলগুলি পরিবর্তন করুন, যা আপনি একটি অ্যাপ দিয়ে খোলেন অথবা ব্যবহারকারী Google Picker API বা অ্যাপের ফাইল পিকার ব্যবহার করার সময় একটি অ্যাপের সাথে শেয়ার করেন। অ-সংবেদনশীল
https://www.googleapis.com/auth/drive আপনার সমস্ত ড্রাইভ ফাইল দেখুন এবং পরিচালনা করুন। সীমাবদ্ধ
https://www.googleapis.com/auth/drive.readonly আপনার সমস্ত ড্রাইভ ফাইল দেখুন এবং ডাউনলোড করুন। সীমাবদ্ধ
https://www.googleapis.com/auth/drive.metadata আপনার ড্রাইভে ফাইলগুলির মেটাডেটা দেখুন এবং পরিচালনা করুন। সীমাবদ্ধ
https://www.googleapis.com/auth/drive.metadata.readonly আপনার ড্রাইভে থাকা ফাইলগুলির মেটাডেটা দেখুন। সীমাবদ্ধ
গুগল মিট
https://www.googleapis.com/auth/meetings.space.created আপনার অ্যাপ দ্বারা তৈরি মিটিং স্পেস সম্পর্কে মেটাডেটা তৈরি, পরিবর্তন এবং পড়ার জন্য অ্যাপগুলিকে অনুমতি দিন।
সংবেদনশীল
https://www.googleapis.com/auth/meetings.space.readonly ব্যবহারকারীর অ্যাক্সেস থাকা যেকোনো মিটিং স্পেস সম্পর্কে অ্যাপগুলিকে মেটাডেটা পড়ার অনুমতি দিন।
সংবেদনশীল

পূর্ববর্তী সারণিতে ব্যবহার কলামটি নিম্নলিখিত সংজ্ঞা অনুসারে প্রতিটি স্কোপের সংবেদনশীলতা নির্দেশ করে:

  • সংবেদনশীল নয় : এই স্কোপগুলি অনুমোদন অ্যাক্সেসের ক্ষুদ্রতম সুযোগ প্রদান করে এবং শুধুমাত্র মৌলিক অ্যাপ যাচাইকরণের প্রয়োজন হয়। এই প্রয়োজনীয়তা সম্পর্কে তথ্যের জন্য, যাচাইকরণের প্রয়োজনীয়তা দেখুন।

  • সংবেদনশীল : এই স্কোপগুলি আপনার অ্যাপের জন্য ব্যবহারকারীর দ্বারা অনুমোদিত নির্দিষ্ট Google ব্যবহারকারীর ডেটাতে অ্যাক্সেস প্রদান করে। এর জন্য আপনাকে অতিরিক্ত অ্যাপ যাচাইকরণের মধ্য দিয়ে যেতে হবে। এই প্রয়োজনীয়তা সম্পর্কে তথ্যের জন্য, সংবেদনশীল এবং সীমাবদ্ধ সুযোগের প্রয়োজনীয়তা দেখুন।

  • সীমাবদ্ধ : এই স্কোপগুলি Google ব্যবহারকারীর ডেটাতে বিস্তৃত অ্যাক্সেস প্রদান করে এবং আপনাকে একটি সীমাবদ্ধ স্কোপ যাচাইকরণ প্রক্রিয়ার মধ্য দিয়ে যেতে হয়। এই প্রয়োজনীয়তা সম্পর্কে তথ্যের জন্য, Google API পরিষেবাগুলি দেখুন: ব্যবহারকারীর ডেটা নীতি এবং নির্দিষ্ট API স্কোপের জন্য অতিরিক্ত প্রয়োজনীয়তা । আপনি যদি সার্ভারে সীমাবদ্ধ স্কোপ ডেটা সংরক্ষণ করেন (অথবা প্রেরণ করেন), তাহলে আপনাকে অবশ্যই একটি নিরাপত্তা মূল্যায়নের মধ্য দিয়ে যেতে হবে।

যদি আপনার অ্যাপের অন্য কোনও Google API-তে অ্যাক্সেসের প্রয়োজন হয়, তাহলে আপনি সেই স্কোপগুলিও যোগ করতে পারেন। Google API স্কোপ সম্পর্কে আরও তথ্যের জন্য, Google API-তে অ্যাক্সেস করার জন্য OAuth 2.0 ব্যবহার করা দেখুন।

নির্দিষ্ট OAuth 2.0 স্কোপ সম্পর্কে আরও তথ্যের জন্য, Google API-এর জন্য OAuth 2.0 স্কোপ দেখুন।

OAuth যাচাইকরণ

নির্দিষ্ট কিছু OAuth স্কোপ ব্যবহার করার জন্য আপনার অ্যাপকে OAuth অ্যাপ যাচাইকরণ সহায়তা কেন্দ্রের মাধ্যমে এগিয়ে যেতে হতে পারে। আপনার অ্যাপটি কখন যাচাইকরণের মধ্য দিয়ে যাবে এবং কী ধরণের যাচাইকরণ প্রয়োজন তা নির্ধারণ করতে OAuth অ্যাপের প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী পড়ুন। Google ড্রাইভ পরিষেবার শর্তাবলীও দেখুন।

প্রয়োজনীয় প্রমাণীকরণের প্রকারগুলি

এই বিভাগটি ব্যাখ্যা করে যে কোন ধরণের প্রমাণীকরণ প্রয়োজন বা সমর্থিত, এবং Google Workspace Events API-এর প্রতিটি পদ্ধতির জন্য সমর্থিত স্কোপগুলি প্রদান করে।

Google Chat ইভেন্টের সাবস্ক্রিপশনের জন্য, Google Workspace Events API ব্যবহারকারী এবং অ্যাপ উভয়ের প্রমাণীকরণ সমর্থন করে, এর কিছু পদ্ধতিতে কল করার জন্য। যদি কোনও API পদ্ধতি উভয় শংসাপত্র সমর্থন করে, তাহলে কলে ব্যবহৃত শংসাপত্রের ধরণটি ফলাফলের উপর প্রভাব ফেলে। উদাহরণস্বরূপ, যদি আপনি ব্যবহারকারী প্রমাণীকরণের সাথে subscriptions.list পদ্ধতিতে কল করেন, তাহলে API প্রমাণীকরণকৃত ব্যবহারকারী অ্যাক্সেস করতে পারে এমন সাবস্ক্রিপশনের একটি তালিকা ফেরত দেয়। আপনি যদি অ্যাপ প্রমাণীকরণ ব্যবহার করেন, তাহলে API অ্যাপ অ্যাক্সেস করতে পারে এমন সাবস্ক্রিপশনের একটি তালিকা ফেরত দেয়। চ্যাট প্রমাণীকরণের ধরণ সম্পর্কে আরও জানতে, Chat অ্যাপ এবং Google Chat API অনুরোধগুলিকে প্রমাণীকরণ এবং অনুমোদন করুন দেখুন।

নিম্নলিখিত টেবিলটি প্রতিটি Google Workspace Events API পদ্ধতির জন্য কোন স্কোপ এবং ধরণের প্রমাণীকরণ প্রয়োজন বা সমর্থিত তা দেখায়:

পদ্ধতি ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন বা সমর্থিত অ্যাপ প্রমাণীকরণ সমর্থিত (শুধুমাত্র গুগল চ্যাট অ্যাপ) অনুমোদনের সুযোগ সমর্থিত
একটি সাবস্ক্রিপশন তৈরি করুন —

ব্যবহারকারী প্রমাণীকরণের সাথে, প্রতিটি ইভেন্টের ধরণের জন্য একটি সমর্থিত সুযোগ প্রয়োজন:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • drive.file
  • drive
  • drive.readonly
  • drive.metadata
  • drive.metadata.readonly
  • meetings.space.created
  • meetings.space.readonly

ডেভেলপার প্রিভিউ : অ্যাপ প্রমাণীকরণ এবং প্রশাসকের অনুমোদনের সাথে (শুধুমাত্র গুগল চ্যাট অ্যাপ), প্রতিটি ইভেন্টের ধরণের জন্য একটি সমর্থিত সুযোগ প্রয়োজন:

  • chat.app.memberships
  • chat.app.spaces
  • chat.app.messages.readonly
সাবস্ক্রিপশন নিন ব্যবহারকারী প্রমাণীকরণের সাথে, এই পদ্ধতিতে এমন একটি স্কোপ প্রয়োজন যা সাবস্ক্রিপশনের জন্য কমপক্ষে একটি ইভেন্ট টাইপ সমর্থন করে ।

অ্যাপ প্রমাণীকরণের মাধ্যমে (শুধুমাত্র গুগল চ্যাট অ্যাপ):

  • chat.bot
সাবস্ক্রিপশন তালিকাভুক্ত করুন ব্যবহারকারী প্রমাণীকরণের সাথে, এই পদ্ধতিতে এমন একটি স্কোপ প্রয়োজন যা সাবস্ক্রিপশনের জন্য কমপক্ষে একটি ইভেন্ট টাইপ সমর্থন করে ।

অ্যাপ প্রমাণীকরণের মাধ্যমে (শুধুমাত্র গুগল চ্যাট অ্যাপ):

  • chat.bot
সাবস্ক্রিপশন আপডেট করুন —

ব্যবহারকারী প্রমাণীকরণের সাথে, প্রতিটি ইভেন্টের ধরণের জন্য একটি সমর্থিত সুযোগ প্রয়োজন:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • drive.file
  • drive
  • drive.readonly
  • drive.metadata
  • drive.metadata.readonly
  • meetings.space.created
  • meetings.space.readonly

ডেভেলপার প্রিভিউ : অ্যাপ প্রমাণীকরণ এবং প্রশাসকের অনুমোদনের সাথে (শুধুমাত্র গুগল চ্যাট অ্যাপ), প্রতিটি ইভেন্টের ধরণের জন্য একটি সমর্থিত সুযোগ প্রয়োজন:

  • chat.app.memberships
  • chat.app.spaces
  • chat.app.messages.readonly
সাবস্ক্রিপশন পুনরায় সক্রিয় করুন —

ব্যবহারকারী প্রমাণীকরণের সাথে, প্রতিটি ইভেন্টের ধরণের জন্য একটি সমর্থিত সুযোগ প্রয়োজন:

  • chat.messages
  • chat.messages.readonly
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.memberships
  • chat.memberships.readonly
  • chat.spaces
  • chat.spaces.readonly
  • drive.file
  • drive
  • drive.readonly
  • drive.metadata
  • drive.metadata.readonly
  • meetings.space.created
  • meetings.space.readonly

ডেভেলপার প্রিভিউ : অ্যাপ প্রমাণীকরণ এবং প্রশাসকের অনুমোদনের সাথে (শুধুমাত্র গুগল চ্যাট অ্যাপ), প্রতিটি ইভেন্টের ধরণের জন্য একটি সমর্থিত সুযোগ প্রয়োজন:

  • chat.app.memberships
  • chat.app.spaces
  • chat.app.messages.readonly
একটি সাবস্ক্রিপশন মুছুন ব্যবহারকারী প্রমাণীকরণের সাথে, এই পদ্ধতিতে এমন একটি স্কোপ প্রয়োজন যা সাবস্ক্রিপশনের জন্য কমপক্ষে একটি ইভেন্ট টাইপ সমর্থন করে ।

অ্যাপ প্রমাণীকরণের মাধ্যমে (শুধুমাত্র গুগল চ্যাট অ্যাপ):

  • chat.bot

ইভেন্টের ধরণ অনুসারে সুযোগ

যখন আপনি ব্যবহারকারী প্রমাণীকরণ ব্যবহার করে Google Workspace Events API কল করেন, তখন আপনাকে সাবস্ক্রিপশনের ইভেন্টের ধরণের সাথে সঙ্গতিপূর্ণ এক বা একাধিক স্কোপ নির্দিষ্ট করতে হবে।

নিম্নলিখিত টেবিলটি প্রতিটি ইভেন্টের ধরণের জন্য কোন অনুমোদনের স্কোপগুলি সমর্থিত তা প্রদর্শন করে:

ইভেন্টগুলি ইভেন্টের ধরণ অনুমোদনের সুযোগ সমর্থিত
গুগল চ্যাট
একটি বার্তা পোস্ট বা আপডেট করা হয়েছে।
  • google.workspace.chat.message.v1.created
  • google.workspace.chat.message.v1.updated
 ব্যবহারকারী প্রমাণীকরণের সাথে:
  • chat.messages
  • chat.messages.readonly
অ্যাপ প্রমাণীকরণ এবং প্রশাসকের অনুমোদনের সাথে ( ডেভেলপার প্রিভিউতে উপলব্ধ):
  • chat.app.messages.readonly
একটি প্রতিক্রিয়া যোগ করা বা মুছে ফেলা হয়, অথবা একাধিক প্রতিক্রিয়া পরিবর্তন করা হয়।
  • google.workspace.chat.reaction.v1.created
  • google.workspace.chat.reaction.v1.deleted
  • google.workspace.chat.reaction.v1.batchChanged
  • chat.messages.reactions
  • chat.messages.reactions.readonly
  • chat.messages
  • chat.messages.readonly
একটি সদস্যপদ তৈরি, আপডেট, বা অপসারণ করা হয়, অথবা একাধিক সদস্যপদ পরিবর্তন করা হয়।
  • google.workspace.chat.membership.v1.created
  • google.workspace.chat.membership.v1.updated
  • google.workspace.chat.membership.v1.deleted
  • google.workspace.chat.membership.v1.batchChanged
 ব্যবহারকারী প্রমাণীকরণের সাথে:
  • chat.memberships
  • chat.memberships.readonly
অ্যাপ প্রমাণীকরণ এবং প্রশাসকের অনুমোদনের সাথে ( ডেভেলপার প্রিভিউতে উপলব্ধ):
  • chat.app.memberships
একটি স্থান আপডেট করা হয়েছে অথবা মুছে ফেলা হয়েছে।
  • google.workspace.chat.space.v1.updated
  • google.workspace.chat.space.v1.deleted
 ব্যবহারকারী প্রমাণীকরণের সাথে:
  • chat.spaces
  • chat.spaces.readonly
অ্যাপ প্রমাণীকরণ এবং প্রশাসকের অনুমোদনের সাথে ( ডেভেলপার প্রিভিউতে উপলব্ধ):
  • chat.app.spaces
গুগল ড্রাইভ
একটি ফাইল তৈরি করা, পরিবর্তন করা, সরানো, মুছে ফেলা, ট্র্যাশে পাঠানো, অথবা ট্র্যাশ থেকে সরানো হয়।
  • google.workspace.drive.file.v3.added
  • google.workspace.drive.file.v3.moved
  • google.workspace.drive.file.v3.contentChanged
  • google.workspace.drive.file.v3.deleted
  • google.workspace.drive.file.v3.trashed
  • google.workspace.drive.file.v3.untrashed
  • drive
  • drive.file
  • drive.metadata
একটি অ্যাক্সেস প্রস্তাব একটি ফাইলে তৈরি বা সমাধান করা হয়।
  • google.workspace.drive.accessProposal.v3.created
  • google.workspace.drive.accessProposal.v3.resolved
  • drive
  • drive.file
  • drive.metadata
  • drive.metadata
  • drive.metadata.readonly
গুগল মিট
একটি সম্মেলন শুরু বা শেষ হয়।
  • google.workspace.meet.conference.v2.started
  • google.workspace.meet.conference.v2.ended
  • meetings.space.created
  • meetings.space.readonly
একজন অংশগ্রহণকারী একটি সম্মেলনে যোগদান করেন বা ছেড়ে যান।
  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left
  • meetings.space.created
  • meetings.space.readonly
একটি রেকর্ডিং তৈরি করা হয়েছিল।
  • google.workspace.meet.recording.v2.fileGenerated
  • meetings.space.created
  • meetings.space.readonly
একটি প্রতিলিপি তৈরি করা হয়েছিল।
  • google.workspace.meet.transcript.v2.fileGenerated
  • meetings.space.created
  • meetings.space.readonly