Method: spaces.messages.create

একটি Google চ্যাট স্পেসে একটি বার্তা তৈরি করে। পাঠ্য এবং কার্ড সহ সর্বাধিক বার্তার আকার হল 32,000 বাইট৷ একটি উদাহরণের জন্য, একটি বার্তা পাঠান দেখুন।

এই পদ্ধতিতে কল করার জন্য প্রমাণীকরণ প্রয়োজন এবং নিম্নলিখিত প্রমাণীকরণ প্রকারগুলিকে সমর্থন করে:

  • পাঠ্য বার্তাগুলির জন্য, ব্যবহারকারীর প্রমাণীকরণ বা অ্যাপ প্রমাণীকরণ সমর্থিত।
  • কার্ড বার্তাগুলির জন্য, শুধুমাত্র অ্যাপ প্রমাণীকরণ সমর্থিত। (শুধুমাত্র চ্যাট অ্যাপই কার্ড বার্তা তৈরি করতে পারে।)

HTTP অনুরোধ

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

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

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

পরামিতি
parent

string

প্রয়োজন। একটি বার্তা তৈরি করা স্থানের সম্পদের নাম।

বিন্যাস: spaces/{space}

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

পরামিতি
threadKey
(deprecated)

string

ঐচ্ছিক। বাতিল করা হয়েছে: পরিবর্তে thread.thread_key ব্যবহার করুন। থ্রেড জন্য আইডি. 4000 অক্ষর পর্যন্ত সমর্থন করে। একটি থ্রেড শুরু করতে বা যোগ করতে, একটি বার্তা তৈরি করুন এবং একটি threadKey বা thread.name নির্দিষ্ট করুন। উদাহরণ ব্যবহারের জন্য, একটি বার্তা থ্রেডের শুরু বা উত্তর দেখুন।

requestId

string

ঐচ্ছিক। এই বার্তাটির জন্য একটি অনন্য অনুরোধ আইডি। একটি বিদ্যমান অনুরোধ আইডি নির্দিষ্ট করা একটি নতুন বার্তা তৈরি করার পরিবর্তে সেই আইডি দিয়ে তৈরি বার্তাটি ফেরত দেয়।

messageReplyOption

enum ( MessageReplyOption )

ঐচ্ছিক। একটি বার্তা একটি থ্রেড শুরু বা একটি উত্তর দেয় কিনা তা নির্দিষ্ট করে৷ শুধুমাত্র নামযুক্ত স্থানগুলিতে সমর্থিত৷

messageId

string

ঐচ্ছিক। একটি বার্তার জন্য একটি কাস্টম আইডি। চ্যাট অ্যাপগুলিকে মেসেজের রিসোর্স নামে (মেসেজ name ক্ষেত্রে উপস্থাপিত) সিস্টেম-অর্পিত আইডি সঞ্চয় করার প্রয়োজন ছাড়াই একটি বার্তা পেতে, আপডেট করতে বা মুছে দিতে দেয়।

এই ক্ষেত্রের মান নিম্নলিখিত প্রয়োজনীয়তা পূরণ করতে হবে:

  • client- দিয়ে শুরু হয়-। উদাহরণস্বরূপ, client-custom-name একটি বৈধ কাস্টম আইডি, কিন্তু custom-name নয়।
  • 63টি পর্যন্ত অক্ষর এবং শুধুমাত্র ছোট হাতের অক্ষর, সংখ্যা এবং হাইফেন রয়েছে৷
  • একটি স্থান মধ্যে অনন্য. একটি চ্যাট অ্যাপ বিভিন্ন বার্তার জন্য একই কাস্টম আইডি ব্যবহার করতে পারে না।

বিস্তারিত জানার জন্য, একটি বার্তার নাম দেখুন।

শরীরের অনুরোধ

অনুরোধের মূল অংশে Message একটি উদাহরণ রয়েছে।

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

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

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

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

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create

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

MessageReplyOption

কিভাবে একটি বার্তার উত্তর দিতে হবে তা নির্দিষ্ট করে। ভবিষ্যতে আরও রাজ্য যুক্ত হতে পারে।

Enums
MESSAGE_REPLY_OPTION_UNSPECIFIED ডিফল্ট. একটি নতুন থ্রেড শুরু হয়. এই বিকল্পটি ব্যবহার করে যেকোন thread ID বা threadKey অন্তর্ভুক্ত করা হয়েছে তা উপেক্ষা করে।
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD thread ID বা threadKey দ্বারা নির্দিষ্ট থ্রেডের উত্তর হিসাবে বার্তাটি তৈরি করে। এটি ব্যর্থ হলে, বার্তাটি পরিবর্তে একটি নতুন থ্রেড শুরু করে।
REPLY_MESSAGE_OR_FAIL thread ID বা threadKey দ্বারা নির্দিষ্ট থ্রেডের উত্তর হিসাবে বার্তাটি তৈরি করে। যদি একটি নতুন threadKey ব্যবহার করা হয়, একটি নতুন থ্রেড তৈরি করা হয়। বার্তা তৈরি ব্যর্থ হলে, পরিবর্তে একটি NOT_FOUND ত্রুটি ফেরত দেওয়া হয়।