Method: spaces.create

একটি স্পেস তৈরি করে। এটি ব্যবহার করে Import mode একটি নামযুক্ত স্পেস বা গ্রুপ চ্যাট তৈরি করা যায়। একটি উদাহরণের জন্য, ‘একটি স্পেস তৈরি করুন’ দেখুন।

নিম্নলিখিত ধরণের প্রমাণীকরণ সমর্থন করে:

অ্যাপ হিসেবে প্রমাণীকরণের সময়, অনুরোধে space.customer ফিল্ডটি অবশ্যই সেট করতে হবে।

একটি অ্যাপ হিসেবে প্রমাণীকরণের সময়, চ্যাট অ্যাপটি স্পেসের সদস্য হিসেবে যুক্ত হয়। তবে, মানুষের দ্বারা প্রমাণীকরণের মতো নয়, চ্যাট অ্যাপটি স্পেস ম্যানেজার হিসেবে যুক্ত হয় না। ডিফল্টরূপে, স্পেসের সকল সদস্য চ্যাট অ্যাপটিকে স্পেস থেকে সরিয়ে ফেলতে পারে। শুধুমাত্র স্পেস ম্যানেজারদের অ্যাপটিকে স্পেস থেকে সরানোর অনুমতি দিতে, space.permission_settings.manage_apps কে managersAllowed এ সেট করুন।

স্পেস তৈরির সময় এর সদস্যপদ নির্ভর করে স্পেসটি Import mode তৈরি করা হয়েছে কিনা তার উপর।

  • ইম্পোর্ট মোড: কোনো সদস্য তৈরি করা হয়নি।
  • অন্যান্য সকল মোড: কলকারী ব্যবহারকারীকে সদস্য হিসেবে যুক্ত করা হয়। এটি হলো:
    • অ্যাপ অথেন্টিকেশন ব্যবহার করার সময় অ্যাপটি নিজেই।
    • ব্যবহারকারী প্রমাণীকরণ ব্যবহার করার সময় মানব ব্যবহারকারী।

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

HTTP অনুরোধ

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

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

কোয়েরি প্যারামিটার

প্যারামিটার
requestId

string

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

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

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

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

অনুরোধের বডিতে Space এর একটি ইনস্ট্যান্স রয়েছে।

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

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

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

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

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

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