এই নির্দেশিকা ব্যাখ্যা করে যে Google Chat API-এর Membership
রিসোর্সে create()
মেথড ব্যবহার করে ব্যবহারকারী, Google Group, বা Chat অ্যাপকে আমন্ত্রণ জানাতে বা যোগ করতে হয় যেটিকে মেম্বারশিপ তৈরি করা নামেও পরিচিত। একটি সদস্যপদ তৈরি করার সময়, যদি নির্দিষ্ট সদস্যের স্বতঃ-স্বীকার নীতি বন্ধ থাকে, তাহলে তারা আমন্ত্রিত, এবং যোগদানের আগে অবশ্যই স্পেস আমন্ত্রণ গ্রহণ করতে হবে। অন্যথায়, একটি সদস্যপদ তৈরি করা সদস্যকে সরাসরি নির্দিষ্ট স্থানে যোগ করে।
আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার Google Workspace সংস্থার যেকোনো স্পেসে ব্যবহারকারী, Google Groups বা Chat অ্যাপ যোগ করতে পারেন।
Membership
রিসোর্স প্রতিনিধিত্ব করে যে একজন মানব ব্যবহারকারী বা Google চ্যাট অ্যাপকে আমন্ত্রণ জানানো হয়েছে কিনা, এর অংশ বা কোনো স্থান থেকে অনুপস্থিত।
পূর্বশর্ত
Node.js
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- Node.js ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনি কীভাবে আপনার Google Chat API অনুরোধে প্রমাণীকরণ করতে চান তার উপর ভিত্তি করে অ্যাক্সেসের শংসাপত্র তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং আপনার স্থানীয় ডিরেক্টরিতে
client_secrets.json
নামে একটি JSON ফাইল হিসাবে শংসাপত্রগুলি সংরক্ষণ করুন৷ - চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.json
নামে একটি JSON ফাইল হিসাবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং আপনার স্থানীয় ডিরেক্টরিতে
- আপনি ব্যবহারকারী বা চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে চান কিনা তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
পাইথন
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- পাইথন ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনি কীভাবে আপনার Google Chat API অনুরোধে প্রমাণীকরণ করতে চান তার উপর ভিত্তি করে অ্যাক্সেসের শংসাপত্র তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং আপনার স্থানীয় ডিরেক্টরিতে
client_secrets.json
নামে একটি JSON ফাইল হিসাবে শংসাপত্রগুলি সংরক্ষণ করুন৷ - চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.json
নামে একটি JSON ফাইল হিসাবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং আপনার স্থানীয় ডিরেক্টরিতে
- আপনি ব্যবহারকারী বা চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে চান কিনা তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
জাভা
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- জাভা ক্লাউড ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন।
- আপনি কীভাবে আপনার Google Chat API অনুরোধে প্রমাণীকরণ করতে চান তার উপর ভিত্তি করে অ্যাক্সেসের শংসাপত্র তৈরি করুন:
- চ্যাট ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং আপনার স্থানীয় ডিরেক্টরিতে
client_secrets.json
নামে একটি JSON ফাইল হিসাবে শংসাপত্রগুলি সংরক্ষণ করুন৷ - চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন এবং শংসাপত্রগুলিকে
credentials.json
নামে একটি JSON ফাইল হিসাবে সংরক্ষণ করুন।
- চ্যাট ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন এবং আপনার স্থানীয় ডিরেক্টরিতে
- আপনি ব্যবহারকারী বা চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে চান কিনা তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
অ্যাপস স্ক্রিপ্ট
- Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।
- আপনার পরিবেশ সেট আপ করুন:
- একটি Google ক্লাউড প্রকল্প তৈরি করুন ।
- OAuth সম্মতি স্ক্রিন কনফিগার করুন ।
- আপনার চ্যাট অ্যাপের জন্য একটি নাম, আইকন এবং বিবরণ সহ Google Chat API সক্রিয় এবং কনফিগার করুন ।
- একটি স্বতন্ত্র অ্যাপস স্ক্রিপ্ট প্রকল্প তৈরি করুন এবং উন্নত চ্যাট পরিষেবা চালু করুন।
- এই নির্দেশিকাতে, আপনাকে অবশ্যই ব্যবহারকারী বা অ্যাপ প্রমাণীকরণ ব্যবহার করতে হবে। চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করতে, পরিষেবা অ্যাকাউন্টের শংসাপত্র তৈরি করুন। ধাপগুলির জন্য, একটি Google চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ এবং অনুমোদন দেখুন।
- আপনি ব্যবহারকারী বা চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করতে চান কিনা তার উপর ভিত্তি করে একটি অনুমোদনের সুযোগ বেছে নিন ।
ব্যবহারকারী হিসাবে একটি স্পেসে একজন ব্যবহারকারীকে আমন্ত্রণ জানান বা যুক্ত করুন৷
ব্যবহারকারীর প্রমাণীকরণ সহ একটি স্পেসে একজন ব্যবহারকারীকে আমন্ত্রণ জানাতে বা যুক্ত করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.memberships
অনুমোদনের সুযোগ নির্দিষ্ট করুন। -
CreateMembership()
পদ্ধতিতে কল করুন। - যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নাম হিসাবে
parent
পাস করুন। -
Membership
একটি উদাহরণ হিসাবেmembership
পাস করুন তার ফিল্ডmember
সাথে নিম্নলিখিতগুলি সেট করুন:-
type
ফিল্ডটিHUMAN
এ সেট করা হয়েছে। -
name
ক্ষেত্রটিusers/{user}
এ সেট করা হয়েছে যেখানে{user}
হল সেই ব্যক্তি যাকে আপনি স্পেসে যোগ করতে চান। চ্যাট ব্যবহারকারীকে নির্দিষ্ট করতে ,{user}
পরিবর্তে নিচের যেকোনো একটি দিয়ে দিন:- পিপল এপিআই-এর ব্যক্তির জন্য আইডি। উদাহরণস্বরূপ, যদি People API person
resourceName
হয়people/123456789
, তাহলে user the valueusers/123456789
। - ডিরেক্টরি API-এ ব্যবহারকারীর জন্য আইডি।
- ব্যবহারকারীর ইমেইল ঠিকানা. উদাহরণস্বরূপ,
users/222larabrown@gmail.com
বাusers/larabrown@cymbalgroup.com
। ব্যবহারকারী যদি একটি Google অ্যাকাউন্ট ব্যবহার করেন বা অন্য কোনও Google Workspace সংস্থার অন্তর্ভুক্ত হন, তাহলে আপনাকে অবশ্যই তার ইমেল ঠিকানা ব্যবহার করতে হবে।
- পিপল এপিআই-এর ব্যক্তির জন্য আইডি। উদাহরণস্বরূপ, যদি People API person
-
নিম্নলিখিত উদাহরণটি ব্যবহারকারীর প্রমাণীকরণ সহ একটি স্পেসে ব্যবহারকারীকে যুক্ত করে:
Node.js
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:
-
SPACE_NAME
: স্পেসেরname
থেকে আইডি। আপনিListSpaces()
পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন। -
USER_NAME
: একটি ব্যবহারকারী আইডি।
চ্যাট এপিআই Membership
একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিবরণ দেয়।
একটি স্পেসে একটি Google গ্রুপকে আমন্ত্রণ জানান বা যোগ করুন৷
ব্যবহারকারীর প্রমাণীকরণ সহ একটি স্পেসে একটি Google গ্রুপকে আমন্ত্রণ জানাতে বা যুক্ত করতে ( অ্যাপ প্রমাণীকরণ একটি স্পেসে Google গ্রুপকে আমন্ত্রণ বা যোগ করা সমর্থন করে না), আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.memberships
অনুমোদনের সুযোগ নির্দিষ্ট করুন। -
CreateMembership()
পদ্ধতিতে কল করুন। - যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নাম হিসাবে
parent
পাস করুন। -
Membership
একটি উদাহরণ হিসাবেmembership
পাস করুনgroupMember
এর ফিল্ডname
সাথেgroups/{group}
সেট করুন যেখানে{group}
হল গ্রুপ আইডি যার জন্য আপনি সদস্যতা তৈরি করতে চান। ক্লাউড আইডেন্টিটি API ব্যবহার করে গ্রুপের আইডি পুনরুদ্ধার করা যেতে পারে।
Google Groups একটি গ্রুপ চ্যাট বা সরাসরি বার্তা যোগ করা যাবে না, কিন্তু শুধুমাত্র একটি নামযুক্ত স্থান যোগ করা যাবে.
নিম্নলিখিত উদাহরণটি ব্যবহারকারীর প্রমাণীকরণ সহ একটি নামযুক্ত স্থানে একটি গ্রুপ যুক্ত করে:
Node.js
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:
-
SPACE_NAME
: স্পেসেরname
থেকে আইডি। আপনিListSpaces()
পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন। -
GROUP_NAME
: একটি গ্রুপ আইডি।
চ্যাট এপিআই Membership
একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিবরণ দেয়।
একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করুন
একটি চ্যাট অ্যাপ একটি স্পেসে সদস্য হিসাবে অন্য অ্যাপ যোগ করতে পারে না। একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করতে বা দুটি মানব ব্যবহারকারীর মধ্যে একটি সরাসরি বার্তা যোগ করতে, ব্যবহারকারীর প্রমাণীকরণের সাথে আপনার অনুরোধে নিম্নলিখিতটি পাস করুন ( অ্যাপ প্রমাণীকরণ একটি স্পেসে চ্যাট অ্যাপকে আমন্ত্রণ বা যোগ করা সমর্থন করে না):
-
chat.memberships.app
অনুমোদনের সুযোগ নির্দিষ্ট করুন। -
CreateMembership()
পদ্ধতিতে কল করুন। - যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নাম হিসাবে
parent
পাস করুন। -
Membership
একটি উদাহরণ হিসাবেmembership
পাস করুন তার ফিল্ডmember
সাথে নিম্নলিখিতগুলি সেট করুন:-
type
ফিল্ডBOT
এ সেট করা হয়েছে। -
name
ক্ষেত্রটিusers/app
জন্য সেট করা হয়েছে; একটি উপনাম যা চ্যাট API কলকারী অ্যাপটিকে প্রতিনিধিত্ব করে।
-
নিম্নলিখিত উদাহরণটি একটি স্পেসে একটি চ্যাট অ্যাপ যোগ করে:
Node.js
পাইথন
জাভা
অ্যাপস স্ক্রিপ্ট
নমুনা চালানোর জন্য, স্পেসের name
আইডি দিয়ে SPACE_NAME
প্রতিস্থাপন করুন। আপনি ListSpaces()
পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
চ্যাট এপিআই Membership
একটি উদাহরণ প্রদান করে যা তৈরি করা ব্যবহারকারী সদস্যতার বিবরণ দেয়।
চ্যাট অ্যাপ হিসেবে একটি স্পেসে একজন ব্যবহারকারীকে আমন্ত্রণ জানান বা যোগ করুন
অ্যাপ প্রমাণীকরণের জন্য এককালীন প্রশাসকের অনুমোদন প্রয়োজন।
অ্যাপ প্রমাণীকরণ সহ একটি স্পেসে একজন ব্যবহারকারীকে আমন্ত্রণ জানাতে বা যোগ করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:
-
chat.app.memberships
অনুমোদনের সুযোগ নির্দিষ্ট করুন। -
membership
রিসোর্সেcreate
পদ্ধতিতে কল করুন। - যে স্থানটিতে সদস্যতা তৈরি করতে হবে তার সংস্থান নামের জন্য
parent
সেট করুন। -
member
users/{user}
এ সেট করুন যেখানে{user}
হল সেই ব্যক্তি যার জন্য আপনি সদস্যতা তৈরি করতে চান এবং হয়:- পিপল এপিআই-এর ব্যক্তির জন্য আইডি। উদাহরণস্বরূপ, যদি People API person
resourceName
হয়people/123456789
, তাহলেmembership.member.name
সেট করুনusers/123456789
। - ডিরেক্টরি API-এ ব্যবহারকারীর জন্য আইডি।
- ব্যবহারকারীর ইমেইল ঠিকানা. উদাহরণস্বরূপ,
users/222larabrown@gmail.com
বাusers/larabrown@cymbalgroup.com
। ব্যবহারকারী যদি একটি Google অ্যাকাউন্ট ব্যবহার করেন বা অন্য কোনও Google Workspace সংস্থার অন্তর্ভুক্ত হন, তাহলে আপনাকে অবশ্যই তার ইমেল ঠিকানা ব্যবহার করতে হবে।
- পিপল এপিআই-এর ব্যক্তির জন্য আইডি। উদাহরণস্বরূপ, যদি People API person
একটি API কী তৈরি করুন
একটি বিকাশকারী পূর্বরূপ API পদ্ধতিতে কল করতে, আপনাকে অবশ্যই API আবিষ্কার নথির একটি অ-সর্বজনীন বিকাশকারী পূর্বরূপ সংস্করণ ব্যবহার করতে হবে৷ অনুরোধটি প্রমাণীকরণ করতে, আপনাকে অবশ্যই একটি API কী পাস করতে হবে।
API কী তৈরি করতে, আপনার অ্যাপের Google ক্লাউড প্রকল্পটি খুলুন এবং নিম্নলিখিতগুলি করুন:
- Google ক্লাউড কনসোলে, মেনু > APIs & Services > Credentials- এ যান।
- শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
- আপনার নতুন API কী প্রদর্শিত হয়৷
- আপনার অ্যাপের কোডে ব্যবহারের জন্য আপনার API কী কপি করতে কপি ক্লিক করুন। API কীটি আপনার প্রকল্পের শংসাপত্রের "API কী" বিভাগেও পাওয়া যাবে।
- উন্নত সেটিংস আপডেট করতে এবং আপনার API কী ব্যবহার সীমিত করতে সীমাবদ্ধ কী ক্লিক করুন। আরও বিশদ বিবরণের জন্য, API কী সীমাবদ্ধতা প্রয়োগ করা দেখুন।
একটি স্ক্রিপ্ট লিখুন যা Chat API কল করে
নিম্নলিখিত উদাহরণটি অ্যাপ প্রমাণীকরণ সহ একটি স্পেসে একজন ব্যবহারকারীকে যুক্ত করে:
পাইথন
- আপনার কাজের ডিরেক্টরিতে,
chat_membership_app_create.py
নামে একটি ফাইল তৈরি করুন। chat_membership_app_create.py
এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:from google.oauth2 import service_account from apiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.app.memberships"] def main(): ''' Authenticates with Chat API using app authentication, then adds a user to a Chat space by creating a membership. ''' # Specify service account details. creds = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds, discoveryServiceUrl='https://chat.googleapis.com/$discovery/rest?version=v1&labels=DEVELOPER_PREVIEW&key=API_KEY') # Use the service endpoint to call Chat API. result = chat.spaces().members().create( # The space in which to create a membership. parent = 'spaces/SPACE', # Specify which user the membership is for. body = { 'member': { 'name':'users/USER', 'type': 'HUMAN' } } ).execute() # Prints details about the created membership. print(result) if __name__ == '__main__': main()
কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
API_KEY
: চ্যাট API-এর জন্য পরিষেবার শেষ পয়েন্ট তৈরি করতে আপনি যে API কী তৈরি করেছেন।SPACE
: একটি স্থানের নাম, যা আপনি Chat API-এরspaces.list
পদ্ধতি থেকে বা একটি স্থানের URL থেকে পেতে পারেন।USER
: একটি ব্যবহারকারী আইডি।
আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:
python3 chat_membership_app_create.py
Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে একটি স্পেসে ব্যবহারকারী বা Google Groups যোগ করুন
আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার Google Workspace সংস্থার যেকোনো স্পেসে ব্যবহারকারী, Google Groups বা Chat অ্যাপ যোগ করতে create()
পদ্ধতিতে কল করতে পারেন।
এই পদ্ধতিটিকে Google Workspace অ্যাডমিনিস্ট্রেটর হিসাবে কল করতে, নিম্নলিখিতগুলি করুন:
- ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করে পদ্ধতিতে কল করুন এবং একটি অনুমোদনের সুযোগ নির্দিষ্ট করুন যা প্রশাসকের বিশেষাধিকার ব্যবহার করে পদ্ধতিটিকে কল করা সমর্থন করে।
- আপনার অনুরোধে,
true
ক্যোয়ারী প্যারামিটারuseAdminAccess
নির্দিষ্ট করুন।
আরও তথ্য এবং উদাহরণের জন্য, Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে Google Chat স্পেস পরিচালনা করুন দেখুন।
সীমাবদ্ধতা এবং বিবেচনা
- অ্যাপ প্রমাণীকরণের মাধ্যমে, একটি চ্যাট অ্যাপ ব্যবহারকারীদের আমন্ত্রণ জানাতে বা যোগ করতে পারে, কিন্তু Google গ্রুপ বা চ্যাট অ্যাপ নয়। নিজেকে যোগ করতে, একটি Chat অ্যাপকে অবশ্যই
chat.memberships
অনুমোদনের সুযোগের সাথে ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করতে হবে।
সম্পর্কিত বিষয়
- ব্যবহারকারী বা চ্যাট অ্যাপের সদস্যতা সম্পর্কে বিশদ বিবরণ পান ।
- একটি স্পেসে সদস্যদের তালিকা করুন ।
- একটি Google চ্যাট স্পেসে একজন ব্যবহারকারীর সদস্যতা আপডেট করুন ।
- একটি স্থান থেকে একটি ব্যবহারকারী বা চ্যাট অ্যাপ সরান ।