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

এই ডকুমেন্টে Google Workspace Events API-নির্দিষ্ট অনুমোদন এবং প্রমাণীকরণ তথ্য রয়েছে। এই ডকুমেন্টটি পড়ার আগে, প্রমাণীকরণ এবং অনুমোদন সম্পর্কে জানুন- এ 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.bot সুযোগ: শুধুমাত্র অ্যাপ প্রমাণীকরণ সমর্থন করে। আপনি এই সুযোগ ব্যবহার করে ব্যবহারকারীর শংসাপত্রগুলি প্রমাণীকরণ করতে পারবেন না৷ ডোমেইন-ওয়াইড ডেলিগেশন সমর্থন করে না।	অ-সংবেদনশীল
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.spaces	Google Chat-এ কথোপকথন এবং স্পেস তৈরি করুন এবং মেটাডেটা (ইতিহাস সেটিংস সহ) দেখুন বা আপডেট করুন।	সংবেদনশীল
https://www.googleapis.com/auth/chat.spaces.readonly	Google চ্যাটে চ্যাট এবং স্পেস দেখুন।	সংবেদনশীল
https://www.googleapis.com/auth/chat.messages.reaction s	চ্যাটে বার্তাগুলির প্রতিক্রিয়াগুলি দেখুন, যুক্ত করুন এবং মুছুন৷	সংবেদনশীল
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 চ্যাটে বার্তা এবং প্রতিক্রিয়া দেখুন।	সীমাবদ্ধ
গুগল মিট
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 স্কোপ ব্যবহার করার জন্য আপনার অ্যাপটিকে Google-এর OAuth যাচাইকরণ প্রক্রিয়ার মাধ্যমে এগিয়ে যেতে হবে। আপনার অ্যাপ কখন যাচাইকরণের মধ্য দিয়ে যেতে হবে এবং কি ধরনের যাচাইকরণ প্রয়োজন তা নির্ধারণ করতে OAuth API যাচাইকরণের FAQ পড়ুন। এছাড়াও Google ড্রাইভ পরিষেবার অতিরিক্ত শর্তাবলী দেখুন।

প্রয়োজনীয় প্রমাণীকরণের ধরন

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

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

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

পদ্ধতি	ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন বা সমর্থিত	অ্যাপ প্রমাণীকরণ সমর্থিত (শুধুমাত্র Google চ্যাট অ্যাপ)	অনুমোদনের সুযোগ সমর্থিত
একটি সদস্যতা তৈরি করুন		-	প্রতিটি ইভেন্ট প্রকারের জন্য একটি সমর্থিত সুযোগ প্রয়োজন: chat.messages chat.messages.readonly chat.messages.reactions chat.messages.reactions.readonly chat.memberships chat.memberships.readonly chat.spaces chat.spaces.readonly meetings.space.created meetings.space.readonly
একটি সাবস্ক্রিপশন পান			ব্যবহারকারীর প্রমাণীকরণের সাথে, এই পদ্ধতির একটি সুযোগ প্রয়োজন যা সদস্যতার জন্য কমপক্ষে একটি ইভেন্ট প্রকার সমর্থন করে । অ্যাপ প্রমাণীকরণ সহ (শুধুমাত্র Google চ্যাট অ্যাপ): chat.bot
তালিকা সদস্যতা			ব্যবহারকারীর প্রমাণীকরণের সাথে, এই পদ্ধতির একটি সুযোগ প্রয়োজন যা সদস্যতার জন্য কমপক্ষে একটি ইভেন্ট প্রকার সমর্থন করে । অ্যাপ প্রমাণীকরণ সহ (শুধুমাত্র Google চ্যাট অ্যাপ): chat.bot
একটি সদস্যতা আপডেট করুন		-	প্রতিটি ইভেন্ট প্রকারের জন্য একটি সমর্থিত সুযোগ প্রয়োজন: chat.messages chat.messages.readonly chat.messages.reactions chat.messages.reactions.readonly chat.memberships chat.memberships.readonly chat.spaces chat.spaces.readonly meetings.space.created meetings.space.readonly
একটি সদস্যতা পুনরায় সক্রিয় করুন		-	প্রতিটি ইভেন্ট প্রকারের জন্য একটি সমর্থিত সুযোগ প্রয়োজন: chat.messages chat.messages.readonly chat.messages.reactions chat.messages.reactions.readonly chat.memberships chat.memberships.readonly chat.spaces chat.spaces.readonly meetings.space.created meetings.space.readonly
একটি সদস্যতা মুছুন			ব্যবহারকারীর প্রমাণীকরণের সাথে, এই পদ্ধতির একটি সুযোগ প্রয়োজন যা সদস্যতার জন্য কমপক্ষে একটি ইভেন্ট প্রকার সমর্থন করে । অ্যাপ প্রমাণীকরণ সহ (শুধুমাত্র Google চ্যাট অ্যাপ): chat.bot

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

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

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

ঘটনা	ইভেন্টের ধরন	অনুমোদনের সুযোগ সমর্থিত
গুগল চ্যাট
একটি বার্তা পোস্ট বা আপডেট করা হয়.	google.workspace.chat.message.v1.created google.workspace.chat.message.v1.updated	chat.messages chat.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
একটি স্থান আপডেট বা মুছে ফেলা হয়।	google.workspace.chat.space.v1.updated google.workspace.chat.space.v1.deleted	chat.spaces chat.spaces.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

সম্পর্কিত বিষয়

• Google চ্যাটের জন্য প্রমাণীকরণ ওভারভিউ
• Google Meet-এর জন্য প্রমাণীকরণ ওভারভিউ