এই ডকুমেন্টে গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই-এর জন্য নির্দিষ্ট অনুমোদন এবং প্রমাণীকরণ সংক্রান্ত তথ্য রয়েছে। এই ডকুমেন্টটি পড়ার আগে, 'প্রমাণীকরণ এবং অনুমোদন সম্পর্কে জানুন' অংশে গুগল ওয়ার্কস্পেসের সাধারণ প্রমাণীকরণ এবং অনুমোদন সংক্রান্ত তথ্য অবশ্যই পড়ে নিন।
অনুমোদনের জন্য OAuth 2.0 কনফিগার করুন।
ব্যবহারকারী এবং অ্যাপ পর্যালোচকদের কাছে কোন তথ্য প্রদর্শিত হবে তা নির্ধারণ করতে OAuth সম্মতি স্ক্রিনটি কনফিগার করুন ও স্কোপ নির্বাচন করুন এবং আপনার অ্যাপটি নিবন্ধন করুন যাতে আপনি পরবর্তীতে এটি প্রকাশ করতে পারেন।
গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই স্কোপ
আপনার অ্যাপকে প্রদত্ত অ্যাক্সেসের স্তর নির্ধারণ করতে, আপনাকে অথরাইজেশন স্কোপ শনাক্ত ও ঘোষণা করতে হবে। একটি অথরাইজেশন স্কোপ হলো একটি OAuth 2.0 URI স্ট্রিং, যাতে Google Workspace অ্যাপের নাম, এটি কোন ধরনের ডেটা অ্যাক্সেস করে এবং অ্যাক্সেসের স্তর উল্লেখ থাকে। স্কোপগুলো হলো Google Workspace ডেটার সাথে কাজ করার জন্য আপনার অ্যাপের অনুরোধ, যার মধ্যে ব্যবহারকারীদের Google অ্যাকাউন্টের ডেটাও অন্তর্ভুক্ত।
যখন আপনার অ্যাপটি ইনস্টল করা হয়, তখন ব্যবহারকারীকে অ্যাপটিতে ব্যবহৃত স্কোপগুলো যাচাই করতে বলা হয়। সাধারণত, আপনার যথাসম্ভব সবচেয়ে সুনির্দিষ্ট স্কোপটি বেছে নেওয়া উচিত এবং আপনার অ্যাপের প্রয়োজন নেই এমন স্কোপের জন্য অনুরোধ করা থেকে বিরত থাকা উচিত। ব্যবহারকারীরা সীমিত ও সুস্পষ্টভাবে বর্ণিত স্কোপগুলোতে আরও সহজে অ্যাক্সেস দিয়ে থাকেন।
গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই সেইসব গুগল ওয়ার্কস্পেস অ্যাপ্লিকেশন থেকে স্কোপ ব্যবহার করে যেগুলো সাবস্ক্রিপশন সমর্থন করে। যদি আপনার অ্যাপ ইতিমধ্যেই আপনার সাবস্ক্রিপশনের জন্য প্রয়োজনীয় স্কোপগুলো ব্যবহার করে থাকে, তাহলে গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই ব্যবহার করার জন্য আপনাকে নতুন করে স্কোপ যোগ করতে হবে না। যদি আপনি স্কোপ যোগ করেন, তবে সবচেয়ে কম সংবেদনশীল স্কোপটি বেছে নিন যা আপনার অ্যাপকে সচল রাখবে। স্কোপ ক্যাটাগরি সম্পর্কে বিস্তারিত জানতে, ‘স্কোপ ক্যাটাগরি’ দেখুন।
নিম্নলিখিত সারণিতে গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই-এর সমর্থিত স্কোপগুলো তালিকাভুক্ত করা হলো:
| স্কোপ কোড | বর্ণনা | ব্যবহার | ||
|---|---|---|---|---|
| গুগল চ্যাট | ||||
https://www.googleapis.com/auth/chat.bot | লেটস চ্যাট অ্যাপের মাধ্যমে চ্যাট দেখা ও মেসেজ পাঠানো যায়। এটি চ্যাট অ্যাপের সকল ফিচার ব্যবহারের সুযোগ দেয়। | অসংবেদনশীল | ||
https://www.googleapis.com/auth/chat.memberships | চ্যাটের কথোপকথনগুলিতে সদস্য দেখুন, যোগ করুন এবং সরিয়ে দিন। | সংবেদনশীল | ||
https://www.googleapis.com/auth/chat.memberships.readonly | চ্যাট কথোপকথনে সদস্যদের দেখুন। | সংবেদনশীল | ||
https://www.googleapis.com/auth/chat.app.memberships | একটি চ্যাট অ্যাপ হিসেবে চ্যাট-এর মধ্যে কথোপকথন এবং স্পেস থেকে সদস্যদের দেখুন, যোগ করুন, আপডেট করুন এবং সরিয়ে দিন। প্রশাসকের অনুমোদন প্রয়োজন। এই স্কোপটি শুধুমাত্র সার্ভিস অ্যাকাউন্ট ব্যবহার করে অ্যাপ অথেনটিকেশন সমর্থন করে। এই স্কোপ ব্যবহার করে আপনি ইউজার ক্রেডেনশিয়াল বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে অথেনটিকেশন করতে পারবেন না। | সংবেদনশীল | ||
https://www.googleapis.com/auth/chat.spaces | চ্যাটে কথোপকথন ও স্পেস তৈরি করুন এবং মেটাডেটা (হিস্ট্রি সেটিংস সহ) দেখুন বা আপডেট করুন। | সংবেদনশীল | ||
https://www.googleapis.com/auth/chat.spaces.readonly | চ্যাটে চ্যাট এবং স্পেস দেখুন। | সংবেদনশীল | ||
https://www.googleapis.com/auth/chat.app.spaces | একটি চ্যাট অ্যাপ হিসেবে চ্যাট-এ কথোপকথন ও স্পেস তৈরি করুন এবং মেটাডেটা (হিস্ট্রি সেটিংস সহ) দেখুন বা আপডেট করুন। প্রশাসকের অনুমোদন প্রয়োজন। এই স্কোপটি শুধুমাত্র সার্ভিস অ্যাকাউন্ট ব্যবহার করে অ্যাপ অথেনটিকেশন সমর্থন করে। এই স্কোপ ব্যবহার করে আপনি ইউজার ক্রেডেনশিয়াল বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে অথেনটিকেশন করতে পারবেন না। | সংবেদনশীল | ||
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 | চ্যাটে বার্তা এবং প্রতিক্রিয়াগুলো দেখুন। | সীমাবদ্ধ | ||
https://www.googleapis.com/auth/chat.app.messages.readonly | চ্যাট অ্যাপ হিসেবে চ্যাটে বার্তা এবং প্রতিক্রিয়াগুলো দেখুন। প্রশাসকের অনুমোদন প্রয়োজন। এই স্কোপটি শুধুমাত্র সার্ভিস অ্যাকাউন্ট ব্যবহার করে অ্যাপ অথেনটিকেশন সমর্থন করে। এই স্কোপ ব্যবহার করে আপনি ইউজার ক্রেডেনশিয়াল বা ডোমেন-ওয়াইড ডেলিগেশনের মাধ্যমে অথেনটিকেশন করতে পারবেন না। | সীমাবদ্ধ | ||
| গুগল ড্রাইভ | ||||
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 API Services: User Data Policy and Additional Requirements for Specific API Scopes" দেখুন। আপনি যদি সার্ভারে সীমাবদ্ধ স্কোপের ডেটা সংরক্ষণ করেন (বা প্রেরণ করেন), তাহলে আপনাকে অবশ্যই একটি নিরাপত্তা মূল্যায়নের মধ্য দিয়ে যেতে হবে।
আপনার অ্যাপের যদি অন্য কোনো গুগল এপিআই-তে অ্যাক্সেসের প্রয়োজন হয়, তাহলে আপনি সেই স্কোপগুলোও যোগ করতে পারেন। গুগল এপিআই স্কোপ সম্পর্কে আরও তথ্যের জন্য, “Using OAuth 2.0 to Access Google APIs” দেখুন।
নির্দিষ্ট OAuth 2.0 স্কোপ সম্পর্কে আরও তথ্যের জন্য, Google API-এর জন্য OAuth 2.0 স্কোপ দেখুন।
OAuth যাচাইকরণ
নির্দিষ্ট কিছু OAuth স্কোপ ব্যবহার করার জন্য আপনার অ্যাপকে OAuth অ্যাপ ভেরিফিকেশন হেল্প সেন্টারের মাধ্যমে যেতে হতে পারে। আপনার অ্যাপ কখন ভেরিফিকেশনের মধ্য দিয়ে যাবে এবং কী ধরনের ভেরিফিকেশন প্রয়োজন, তা জানতে OAuth অ্যাপের প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী (FAQs) পড়ুন। এছাড়াও ড্রাইভের পরিষেবার শর্তাবলী (Terms of Service ) দেখুন।
প্রয়োজনীয় প্রমাণীকরণের প্রকারভেদ
এই বিভাগে কোন ধরনের প্রমাণীকরণ প্রয়োজন বা সমর্থিত, তা ব্যাখ্যা করা হয়েছে এবং Google Workspace Events API-এর প্রতিটি পদ্ধতির জন্য সমর্থিত স্কোপগুলো প্রদান করা হয়েছে।
চ্যাট ইভেন্টের সাবস্ক্রিপশনের জন্য, গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই তার কিছু মেথড কল করার ক্ষেত্রে ইউজার এবং অ্যাপ উভয় অথেন্টিকেশনই সমর্থন করে। যদি কোনো এপিআই মেথড উভয় ক্রেডেনশিয়াল সমর্থন করে, তবে কলে ব্যবহৃত ক্রেডেনশিয়ালের ধরনটি ফেরত আসা ফলাফলকে প্রভাবিত করে। উদাহরণস্বরূপ, আপনি যদি ইউজার অথেন্টিকেশন ব্যবহার করে subscriptions.list মেথডটি কল করেন, তাহলে এপিআই সেইসব সাবস্ক্রিপশনের একটি তালিকা ফেরত দেবে যা অথেন্টিকেটেড ইউজার অ্যাক্সেস করতে পারবে। আপনি যদি অ্যাপ অথেন্টিকেশন ব্যবহার করেন, তাহলে এপিআই সেইসব সাবস্ক্রিপশনের একটি তালিকা ফেরত দেবে যা অ্যাপটি অ্যাক্সেস করতে পারবে। চ্যাট অথেন্টিকেশনের প্রকারভেদ সম্পর্কে আরও জানতে, ‘চ্যাট অ্যাপ অথেন্টিকেট ও অথরাইজ করুন’ এবং ‘চ্যাট এপিআই অনুরোধসমূহ’ দেখুন।
নিম্নলিখিত সারণিতে দেখানো হয়েছে যে প্রতিটি গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই পদ্ধতির জন্য কোন স্কোপ এবং ধরণের প্রমাণীকরণ প্রয়োজন বা সমর্থিত:
| পদ্ধতি | ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন বা সমর্থিত | অ্যাপ প্রমাণীকরণ সমর্থিত (শুধুমাত্র চ্যাট অ্যাপের জন্য) | সমর্থিত অনুমোদনের পরিধি | |
|---|---|---|---|---|
| একটি সাবস্ক্রিপশন তৈরি করুন | — | ব্যবহারকারী প্রমাণীকরণের জন্য, প্রতিটি ইভেন্ট টাইপের জন্য একটি সমর্থিত স্কোপ প্রয়োজন:
ডেভেলপার প্রিভিউ : অ্যাপ প্রমাণীকরণ এবং প্রশাসকের অনুমোদন সহ (শুধুমাত্র চ্যাট অ্যাপের জন্য), প্রতিটি ইভেন্ট টাইপের জন্য একটি সমর্থিত স্কোপ প্রয়োজন :
| ||
| একটি সাবস্ক্রিপশন নিন | ব্যবহারকারী প্রমাণীকরণের ক্ষেত্রে, এই পদ্ধতির জন্য এমন একটি স্কোপ প্রয়োজন যা সাবস্ক্রিপশনের জন্য অন্তত একটি ইভেন্ট টাইপ সমর্থন করে । অ্যাপ প্রমাণীকরণের মাধ্যমে (শুধুমাত্র চ্যাট অ্যাপের জন্য):
| |||
| তালিকা সাবস্ক্রিপশন | ব্যবহারকারী প্রমাণীকরণের ক্ষেত্রে, এই পদ্ধতির জন্য এমন একটি স্কোপ প্রয়োজন যা সাবস্ক্রিপশনের জন্য অন্তত একটি ইভেন্ট টাইপ সমর্থন করে । অ্যাপ প্রমাণীকরণের মাধ্যমে (শুধুমাত্র চ্যাট অ্যাপের জন্য):
| |||
| একটি সাবস্ক্রিপশন আপডেট করুন | — | ব্যবহারকারী প্রমাণীকরণের জন্য, প্রতিটি ইভেন্ট টাইপের জন্য একটি সমর্থিত স্কোপ প্রয়োজন:
ডেভেলপার প্রিভিউ : অ্যাপ প্রমাণীকরণ এবং প্রশাসকের অনুমোদন সহ (শুধুমাত্র চ্যাট অ্যাপের জন্য), প্রতিটি ইভেন্ট টাইপের জন্য একটি সমর্থিত স্কোপ প্রয়োজন :
| ||
| একটি সাবস্ক্রিপশন পুনরায় সক্রিয় করুন | — | ব্যবহারকারী প্রমাণীকরণের জন্য, প্রতিটি ইভেন্ট টাইপের জন্য একটি সমর্থিত স্কোপ প্রয়োজন:
ডেভেলপার প্রিভিউ : অ্যাপ প্রমাণীকরণ এবং প্রশাসকের অনুমোদন সহ (শুধুমাত্র চ্যাট অ্যাপের জন্য), প্রতিটি ইভেন্ট টাইপের জন্য একটি সমর্থিত স্কোপ প্রয়োজন :
| ||
| একটি সাবস্ক্রিপশন মুছে ফেলুন | ব্যবহারকারী প্রমাণীকরণের ক্ষেত্রে, এই পদ্ধতির জন্য এমন একটি স্কোপ প্রয়োজন যা সাবস্ক্রিপশনের জন্য অন্তত একটি ইভেন্ট টাইপ সমর্থন করে । অ্যাপ প্রমাণীকরণের মাধ্যমে (শুধুমাত্র চ্যাট অ্যাপের জন্য):
| |||
ইভেন্টের ধরণ অনুযায়ী পরিধি
ব্যবহারকারী প্রমাণীকরণ ব্যবহার করে যখন আপনি গুগল ওয়ার্কস্পেস ইভেন্টস এপিআই কল করেন, তখন আপনাকে অবশ্যই সাবস্ক্রিপশনের ইভেন্ট টাইপগুলোর সাথে সঙ্গতিপূর্ণ এক বা একাধিক স্কোপ নির্দিষ্ট করতে হবে।
নিম্নলিখিত সারণিতে দেখানো হয়েছে যে প্রতিটি ইভেন্ট প্রকারের জন্য কোন কোন অনুমোদন পরিধি সমর্থিত:
| ইভেন্টগুলি | ইভেন্টের প্রকারভেদ | সমর্থিত অনুমোদনের পরিধি | ||||||
|---|---|---|---|---|---|---|---|---|
| চ্যাট | ||||||||
| একটি বার্তা পোস্ট বা আপডেট করা হয়। |
| ব্যবহারকারী প্রমাণীকরণের সাথে :
| ||||||
| একটি বিক্রিয়া যোগ করা বা বাদ দেওয়া হয়, অথবা একাধিক বিক্রিয়া পরিবর্তন করা হয়। |
|
| ||||||
| একটি সদস্যপদ তৈরি, হালনাগাদ বা অপসারণ করা হয়, অথবা একাধিক সদস্যপদ পরিবর্তন করা হয়। |
| ব্যবহারকারী প্রমাণীকরণের সাথে :
| ||||||
| একটি স্থান হালনাগাদ বা মুছে ফেলা হয়। |
| ব্যবহারকারী প্রমাণীকরণের সাথে :
| ||||||
| ড্রাইভ | ||||||||
| একটি ফাইল তৈরি, পরিবর্তন, স্থানান্তর, মুছে ফেলা, নাম পরিবর্তন, ট্র্যাশে পাঠানো বা ট্র্যাশ থেকে সরানো হয়। |
|
| ||||||
| একটি ফাইলের উপর একটি অ্যাক্সেস প্রস্তাব তৈরি বা সমাধান করা হয়। |
|
| ||||||
| একটি অনুমোদন বাতিল, সম্পন্ন, তৈরি, রিসেট করা হয়, পর্যালোচক পরিবর্তন করা হয়, অথবা পর্যালোচকরা কোনো ফাইলে প্রতিক্রিয়া জানান। |
|
| ||||||
| কোনো ফাইলে একটি মন্তব্য তৈরি, মুছে ফেলা, সম্পাদনা, পুনরায় খোলা বা সমাধান করা হয়। |
|
| ||||||
| কোনো ফাইলে একটি উত্তর তৈরি, মুছে ফেলা বা সম্পাদনা করা হয়। |
|
| ||||||
| কোনো ফাইলে একটি অনুমতি তৈরি, মুছে ফেলা বা সম্পাদনা করা হয়। |
|
| ||||||
| সাক্ষাৎ | ||||||||
| একটি সম্মেলন শুরু বা শেষ হয়। |
|
| ||||||
| একজন অংশগ্রহণকারী একটি সম্মেলনে যোগদান করেন বা সম্মেলন ত্যাগ করেন। |
|
| ||||||
| একটি রেকর্ডিং তৈরি করা হয়েছিল। |
|
| ||||||
| একটি প্রতিলিপি তৈরি করা হয়েছিল। |
|
| ||||||