Method: spaces.setup

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

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

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

একটি নামযুক্ত স্থান বা গ্রুপ চ্যাটের জন্য, যদি কলার ব্লক করে, বা কিছু সদস্য দ্বারা অবরুদ্ধ করা হয়, বা কিছু সদস্য যোগ করার অনুমতি না থাকে, তাহলে সেই সদস্যদের তৈরি করা জায়গায় যোগ করা হয় না।

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

কলিং ব্যবহারকারী এবং কলিং অ্যাপের মধ্যে একটি DM তৈরি করতে, Space.singleUserBotDm true সেট করুন এবং কোনো সদস্যতা নির্দিষ্ট করবেন না। আপনি শুধুমাত্র কলিং অ্যাপের সাথে একটি DM সেট আপ করতে এই পদ্ধতিটি ব্যবহার করতে পারেন৷ একটি স্পেসের সদস্য বা দুটি মানব ব্যবহারকারীর মধ্যে বিদ্যমান DM হিসাবে কলিং অ্যাপটিকে যোগ করতে, একটি স্পেসে একটি ব্যবহারকারী বা অ্যাপকে আমন্ত্রণ বা যোগ করুন দেখুন।

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

থ্রেডেড উত্তর সহ স্পেস সমর্থিত নয়। যদি আপনি একটি স্পেস সেট আপ করার সময় ALREADY_EXISTS ত্রুটি বার্তাটি পান তবে একটি ভিন্ন displayName চেষ্টা করুন। Google Workspace সংস্থার মধ্যে আগে থেকেই এই ডিসপ্লে নাম ব্যবহার করা হতে পারে।

ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন।

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 সংস্থার মধ্যে আগে থেকেই এই ডিসপ্লে নাম ব্যবহার করা হতে পারে।

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

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

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

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

request Id

string

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

memberships[]

object ( Membership )

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

সেটটি বর্তমানে 20টি সদস্যপদ (কলার ছাড়াও) অনুমতি দেয়।

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

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

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

Space.spaceType GROUP_CHAT এ সেট করার সময় প্রয়োজন, অন্তত দুটি সদস্যপদ সহ।

ঠিক একটি সদস্যপদ সহ একজন মানব ব্যবহারকারীর সাথে Space.spaceType DIRECT_MESSAGE এ সেট করার সময় প্রয়োজন৷

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

প্রতিক্রিয়া শরীর

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

অনুমোদনের সুযোগ

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

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

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