Method: spaces.setup

একটি স্পেস তৈরি করে এবং এতে নির্দিষ্ট ব্যবহারকারীদের যুক্ত করে। অনুরোধকারী ব্যবহারকারী স্বয়ংক্রিয়ভাবে স্পেসটিতে যুক্ত হয়ে যান, এবং অনুরোধে তাকে সদস্যপদ হিসেবে উল্লেখ করার প্রয়োজন নেই। একটি উদাহরণের জন্য, ‘প্রাথমিক সদস্যদের নিয়ে একটি স্পেস তৈরি করুন’ দেখুন।

যোগ করার জন্য মানব সদস্যদের নির্দিষ্ট করতে, উপযুক্ত membership.member.name সহ সদস্যপদ যোগ করুন। একজন মানব ব্যবহারকারী যোগ করতে, users/{user} ব্যবহার করুন, যেখানে {user} ব্যবহারকারীর ইমেল ঠিকানা হতে পারে। একই Workspace সংস্থার ব্যবহারকারীদের জন্য {user} People API থেকে ব্যক্তির id , অথবা Directory API-তে ব্যবহারকারীর id হতে পারে। উদাহরণস্বরূপ, যদি user@example.com এর জন্য People API পার্সন প্রোফাইল আইডি 123456789 হয়, তাহলে আপনি membership.member.name কে users/user@example.com অথবা users/123456789 সেট করে ব্যবহারকারীকে স্পেসে যোগ করতে পারেন।

যোগ করার জন্য গুগল গ্রুপগুলো নির্দিষ্ট করতে, উপযুক্ত membership.group_member.name ব্যবহার করে মেম্বারশিপ যোগ করুন। একটি গুগল গ্রুপ যোগ করতে বা আমন্ত্রণ জানাতে, groups/{group} ব্যবহার করুন, যেখানে {group} হলো ক্লাউড আইডেন্টিটি গ্রুপস এপিআই (Cloud Identity Groups API) থেকে প্রাপ্ত গ্রুপটির id । উদাহরণস্বরূপ, আপনি গ্রুপ ইমেল group@example.com এর জন্য আইডি 123456789 পেতে ক্লাউড আইডেন্টিটি গ্রুপস লুকআপ এপিআই (Cloud Identity Groups lookup API) ব্যবহার করতে পারেন, তারপর membership.group_member.name কে groups/123456789 এ সেট করে গ্রুপটিকে স্পেসে যোগ করতে পারেন। গ্রুপ ইমেল সমর্থিত নয়, এবং গুগল গ্রুপগুলোকে শুধুমাত্র নেমড স্পেসে সদস্য হিসেবে যোগ করা যায়।

কোনো নামযুক্ত স্পেস বা গ্রুপ চ্যাটের ক্ষেত্রে, যদি আহ্বানকারী কোনো সদস্যকে ব্লক করেন, বা তিনি কিছু সদস্যের দ্বারা ব্লক হন, অথবা কিছু সদস্যকে যুক্ত করার অনুমতি তাঁর না থাকে, তাহলে সেই সদস্যরা তৈরি করা স্পেসটিতে যুক্ত হন না।

কলকারী ব্যবহারকারী এবং অন্য একজন ব্যবহারকারীর মধ্যে একটি সরাসরি বার্তা (DM) তৈরি করতে, সেই ব্যবহারকারীকে প্রতিনিধিত্ব করার জন্য ঠিক একটি সদস্যপদ নির্দিষ্ট করুন। যদি একজন ব্যবহারকারী অন্যজনকে ব্লক করে, তাহলে অনুরোধটি ব্যর্থ হয় এবং DM তৈরি হয় না।

কলিং ইউজার এবং কলিং অ্যাপের মধ্যে একটি ডিএম (DM) তৈরি করতে, Space.singleUserBotDm কে true সেট করুন এবং কোনো মেম্বারশিপ উল্লেখ করবেন না। আপনি শুধুমাত্র কলিং অ্যাপের সাথে একটি ডিএম সেট আপ করার জন্য এই পদ্ধতিটি ব্যবহার করতে পারবেন। কলিং অ্যাপটিকে কোনো স্পেসের সদস্য হিসেবে অথবা দুজন ব্যবহারকারীর মধ্যে বিদ্যমান কোনো ডিএম-এ যুক্ত করতে, “Invite or add a user or app to a space” দেখুন।

যদি দুই ব্যবহারকারীর মধ্যে আগে থেকেই একটি ডিএম (DM) বিদ্যমান থাকে, তাহলে অনুরোধ করার সময় একজন ব্যবহারকারী অন্যজনকে ব্লক করে রাখলেও, বিদ্যমান ডিএম-টিই ফেরত দেওয়া হয়।

থ্রেডেড রিপ্লাই সহ স্পেস সমর্থিত নয়। স্পেস সেট আপ করার সময় যদি আপনি ALREADY_EXISTS ত্রুটি বার্তাটি পান, তাহলে একটি ভিন্ন displayName ব্যবহার করে দেখুন। Google Workspace সংস্থার মধ্যে থাকা কোনো বিদ্যমান স্পেস হয়তো ইতিমধ্যেই এই display name-টি ব্যবহার করছে।

নিম্নলিখিত অনুমোদন পরিধিগুলির মধ্যে যেকোনো একটির মাধ্যমে ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন:

  • https://www.googleapis.com/auth/chat.spaces.create
  • https://www.googleapis.com/auth/chat.spaces

HTTP অনুরোধ

POST https://chat.googleapis.com/v1/spaces:setup

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "space": {
    object (Space)
  },
  "requestId": string,
  "memberships": [
    {
      object (Membership)
    }
  ]
}
ক্ষেত্র
space

object ( Space )

আবশ্যক। Space.spaceType ফিল্ডটি আবশ্যক।

একটি স্পেস তৈরি করতে, Space.spaceType কে SPACE এ এবং Space.displayName সেট করুন। স্পেস সেট আপ করার সময় যদি আপনি ALREADY_EXISTS ত্রুটি বার্তাটি পান, তাহলে একটি ভিন্ন displayName ব্যবহার করে দেখুন। Google Workspace অর্গানাইজেশনের মধ্যে থাকা কোনো বিদ্যমান স্পেস হয়তো ইতিমধ্যেই এই display name-টি ব্যবহার করছে।

গ্রুপ চ্যাট তৈরি করতে, Space.spaceType কে GROUP_CHAT এ সেট করুন। Space.displayName সেট করবেন না।

মানুষের মধ্যে ১:১ কথোপকথন তৈরি করতে, Space.spaceType কে DIRECT_MESSAGE এবং Space.singleUserBotDm কে false সেট করুন। Space.displayName বা Space.spaceDetails সেট করবেন না।

একজন মানুষ এবং কলকারী চ্যাট অ্যাপের মধ্যে সরাসরি কথোপকথন তৈরি করতে, Space.spaceType কে DIRECT_MESSAGE এবং Space.singleUserBotDm কে true সেট করুন। Space.displayName বা Space.spaceDetails সেট করবেন না।

যদি একটি DIRECT_MESSAGE স্পেস আগে থেকেই বিদ্যমান থাকে, তাহলে নতুন স্পেস তৈরি করার পরিবর্তে সেই স্পেসটিই ফেরত দেওয়া হয়।

requestId

string

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

এই ক্ষেত্রটি কার্যকরভাবে ব্যবহার করতে:

  • নিশ্চিত করুন যে পরবর্তী অনুরোধগুলো অভিন্ন হয় এবং মূল অনুরোধের মতো একই প্রমাণীকরণ তথ্য ব্যবহার করা হয়।
  • প্রদত্ত রিকোয়েস্ট আইডি দিয়ে যদি আগে থেকেই কোনো স্পেস তৈরি করা থাকে, তাহলে রিকোয়েস্টটি সেই স্পেসটিই ফেরত দেয়। মনে রাখবেন যে, ফেরত আসা স্পেসটি সম্পূর্ণভাবে পূরণ করা নাও থাকতে পারে; এপিআই আপনার রিকোয়েস্টের স্পেসটিকে সিস্টেম-নির্ধারিত রিসোর্স নামটি দিয়ে পূরণ করে ইকো করে। স্পেসটির সর্বশেষ মেটাডেটা পেতে, spaces.get কল করুন।
  • ভিন্ন কোনো প্রমাণীকৃত ব্যবহারকারীর সাথে বিদ্যমান অনুরোধ আইডি পুনরায় ব্যবহার করলে একটি ত্রুটি দেখা দেয়।
memberships[]

object ( Membership )

ঐচ্ছিক। স্পেসটিতে যোগদানের জন্য যে গুগল চ্যাট ব্যবহারকারী বা গ্রুপগুলোকে আমন্ত্রণ জানাতে চান। কলকারী ব্যবহারকারীকে বাদ দিন, কারণ তারা স্বয়ংক্রিয়ভাবে যুক্ত হয়ে যান।

এই সেটে বর্তমানে (কলকারী ছাড়াও) সর্বোচ্চ ৪৯টি সদস্যপদ যুক্ত করা যায়।

মানব সদস্যপদের জন্য, Membership.member ফিল্ডে অবশ্যই একজন user name পূরণ করা থাকতে হবে (ফরম্যাট: users/{user} ) এবং type User.Type.HUMAN হিসেবে সেট করা থাকতে হবে। আপনি শুধুমাত্র একটি স্পেস সেট আপ করার সময় মানব ব্যবহারকারী যোগ করতে পারবেন (চ্যাট অ্যাপ যোগ করা শুধুমাত্র কলিং অ্যাপের সাথে সরাসরি মেসেজ সেট আপ করার জন্য সমর্থিত)। আপনি {user}-এর জন্য ব্যবহারকারীর ইমেলকে একটি উপনাম (alias) হিসেবেও সদস্য যোগ করতে পারেন। উদাহরণস্বরূপ, user.name হতে পারে users/example@gmail.com । Gmail ব্যবহারকারী বা বাইরের Google Workspace ডোমেইনের ব্যবহারকারীদের আমন্ত্রণ জানাতে, {user} এর জন্য ব্যবহারকারীর ইমেল ব্যবহার করতে হবে।

গুগল গ্রুপ সদস্যতার জন্য, Membership.group_member ফিল্ডে অবশ্যই একটি group name থাকতে হবে (ফরম্যাট: groups/{group} )। আপনি শুধুমাত্র তখনই গুগল গ্রুপ যোগ করতে পারবেন যখন Space.spaceType কে SPACE এ সেট করবেন।

Space.spaceType কে SPACE এ সেট করার সময় এটি ঐচ্ছিক।

Space.spaceType কে GROUP_CHAT এ সেট করার সময় এবং এর সাথে কমপক্ষে দুটি সদস্যপদ থাকা আবশ্যক।

যখন কোনো মানব ব্যবহারকারীর ক্ষেত্রে Space.spaceType কে DIRECT_MESSAGE এ সেট করা হয় এবং তার সাথে ঠিক একটি সদস্যপদ থাকে, তখন এটি আবশ্যক।

কোনো মানুষ এবং কলকারী চ্যাট অ্যাপের মধ্যে ১:১ কথোপকথন তৈরি করার সময় এটি অবশ্যই খালি থাকতে হবে (যখন Space.spaceType কে DIRECT_MESSAGE এবং Space.singleUserBotDm কে true সেট করা হয়)।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে Space এর একটি ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।