এই পৃষ্ঠাটি বর্ণনা করে যে কীভাবে Google Chat অ্যাপকে Google Chat-এর বাইরের কোনো পরিষেবা বা টুলের সাথে সংযুক্ত করতে হয়। যদিও চ্যাট অ্যাপগুলি নিজেরাই শক্তিশালী, তারা প্রায়শই অন্যান্য সিস্টেমের সাথে একত্রে কাজ করে এবং অ্যাকাউন্টগুলিকে সংযুক্ত করতে, ডেটা অ্যাক্সেস অনুমোদন করতে, অতিরিক্ত ডেটা প্রদর্শন করতে বা ব্যবহারকারীর পছন্দগুলি কনফিগার করতে সহযোগী অ্যাপ্লিকেশনগুলির প্রয়োজন হয়।
একজন ব্যবহারকারীর কাছ থেকে চ্যাট অ্যাপ কনফিগারেশনের অনুরোধ করুন
যদি একটি অনুরোধ সম্পূর্ণ করার জন্য অতিরিক্ত কনফিগারেশনের প্রয়োজন হয় যা সরাসরি চ্যাট অ্যাপে সম্পূর্ণ করা যায় না, তাহলে একটি সাধারণ উত্তরের অংশ হিসাবে ব্যবহারকারীকে একটি কনফিগারেশন URL ফেরত দিন বা নিম্নলিখিত ফর্মে এটি ব্যক্তিগতভাবে উপস্থাপন করুন:
{ "actionResponse": { "type": "REQUEST_CONFIG", "url": "CONFIGURATION_URL" } }
এটি Google চ্যাটকে একটি ব্যক্তিগত প্রম্পট সহ ব্যবহারকারীকে উপস্থাপন করতে বলে, যেখানে অতিরিক্ত প্রমাণীকরণ, অনুমোদন বা কনফিগারেশনের জন্য ব্যবহারকারীকে দেখার জন্য CONFIGURATION_URL
একটি লিঙ্ক। একটি REQUEST_CONFIG
প্রতিক্রিয়া একটি নিয়মিত প্রতিক্রিয়া বার্তার সাথে পারস্পরিকভাবে একচেটিয়া। কোনো পাঠ্য, কার্ড, বা অন্যান্য বৈশিষ্ট্য উপেক্ষা করা হয়.
কনফিগারেশন অনুরোধ সম্পূর্ণ করুন
প্রতিটি MESSAGE
ইন্টারঅ্যাকশন ইভেন্ট যা আপনার চ্যাট অ্যাপ গ্রহণ করে তার মধ্যে একটি configCompleteRedirectUrl
প্যারামিটার অন্তর্ভুক্ত থাকে। এই ইউআরএলটি আপনার কনফিগারেশন ইউআরএলে এনকোড করা উচিত যাতে প্রক্রিয়াটি সম্পূর্ণ হওয়ার পরে ব্যবহার করা যায়। এই ইউআরএলে রিডাইরেক্ট করা হলে তা Google Chat-এ ইঙ্গিত দেয় যে কনফিগারেশনের অনুরোধ পূরণ হয়েছে।
যখন আপনার চ্যাট অ্যাপ শুরু হয়, প্রবাহটি প্রাপ্ত নির্দিষ্ট বার্তার উপর নির্ভর করে। @app help
মত একটি বার্তার প্রতিক্রিয়া হিসাবে, একটি চ্যাট অ্যাপের অতিরিক্ত কনফিগারেশনের প্রয়োজন ছাড়াই একটি বার্তার সাথে প্রতিক্রিয়া জানানো উচিত।
যখন একজন ব্যবহারকারী সফলভাবে মূল বার্তায় প্রদত্ত configCompleteRedirectUrl
এ পুনঃনির্দেশিত হয়, তখন Google Chat নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করে:
- সূচনাকারী ব্যবহারকারীর কাছে প্রদর্শিত প্রম্পটটি মুছুন।
- মূল বার্তাটিকে সর্বজনীনে রূপান্তর করুন, এটি স্থানের অন্যান্য সদস্যদের কাছে দৃশ্যমান করে৷
- একই চ্যাট অ্যাপে মূল বার্তাটি দ্বিতীয়বার পাঠান।
একটি configCompleteRedirectUrl
পরিদর্শন শুধুমাত্র একটি একক ব্যবহারকারী বার্তা প্রভাবিত করে। যদি কোনও ব্যবহারকারী একাধিকবার একটি চ্যাট অ্যাপকে মেসেজ করার চেষ্টা করে থাকে এবং ফলস্বরূপ একাধিক প্রম্পট পেয়ে থাকে, তাহলে একটি নির্দিষ্ট প্রম্পটের মাধ্যমে ক্লিক করা এবং প্রমাণীকরণ এবং কনফিগারেশন প্রক্রিয়া সম্পূর্ণ করা শুধুমাত্র সেই নির্দিষ্ট বার্তাটিকে প্রভাবিত করে। অন্যান্য বার্তা পরিবর্তন করা হয় না.
যখন একটি MESSAGE
ইন্টারঅ্যাকশন ইভেন্ট এইভাবে রিসেন্ট করা হয়, তখন এটি মূল ইভেন্টের সাথে অভিন্ন হওয়া উচিত; যাইহোক, কিছু পরিস্থিতিতে আছে যেখানে MESSAGE
ইন্টারঅ্যাকশন ইভেন্টগুলি ভিন্ন হতে পারে। উদাহরণস্বরূপ, যখন একটি বার্তা চ্যাট অ্যাপ A এবং চ্যাট অ্যাপ বি উভয়ের উল্লেখ করে, ব্যবহারকারী বার্তাটি সম্পাদনা করতে সক্ষম হয় যদি চ্যাট অ্যাপ A চ্যাট অ্যাপ B এর সাথে প্রমাণীকরণের আগে একটি নিয়মিত বার্তার সাথে সাড়া দেয়। এই ক্ষেত্রে, চ্যাট অ্যাপ বি সম্পাদনা গ্রহণ করে ব্যবহারকারী প্রমাণীকরণ এবং কনফিগারেশন সম্পূর্ণ করার পরে বার্তা পাঠ্য।
চ্যাটের বাইরে চ্যাট ব্যবহারকারীকে প্রমাণীকরণ করুন
কিছু ক্ষেত্রে, যেমন একটি API-এর জন্য OAuth অনুমোদনের অনুরোধ করা, ব্যবহারকারীর পরিচয় বজায় রাখার সময় আপনার অ্যাপকে চ্যাটের বাইরে একটি URL-এর সাথে লিঙ্ক করতে হবে। এই ক্ষেত্রে ব্যবহারকারীকে শনাক্ত করার সর্বোত্তম উপায় হল Google সাইন-ইন এর মাধ্যমে গন্তব্য অ্যাপটিকে রক্ষা করা।
ব্যবহারকারী আইডি পেতে সাইন-ইন করার সময় ইস্যু করা পরিচয় টোকেন ব্যবহার করুন। sub
ক্লেইমে ব্যবহারকারীর ইউনিক আইডি থাকে এবং Google চ্যাটের ইউজার আইডির সাথে সম্পর্কযুক্ত হতে পারে।
যদিও দুটি আইডি ঠিক অভিন্ন নয়, সেগুলি জোরপূর্বক করা যেতে পারে। একজন Google Chat users/{user}
এর কাছে sub
ক্লেমের মান জোরপূর্বক করার জন্য, users/
। উদাহরণস্বরূপ, 123
-এর দাবির মান আপনার চ্যাট অ্যাপের মেসেজে ব্যবহারকারীর নাম users/123
এর সমতুল্য।
সম্পর্কিত বিষয়
- MyProfile অ্যাপের উদাহরণ ব্যবহারকারীকে শনাক্ত করতে Google সাইন-ইন প্রতিক্রিয়া থেকে পরিচয় টোকেন ব্যবহার করে।