Method: spaces.messages.create

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

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

  • অনুমোদন পরিধি সহ অ্যাপ প্রমাণীকরণ :
    • https://www.googleapis.com/auth/chat.bot
  • নিম্নলিখিত অনুমোদন পরিধিগুলির মধ্যে একটি ব্যবহার করে ব্যবহারকারীর প্রমাণীকরণ :
    • https://www.googleapis.com/auth/chat.messages.create
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (ইম্পোর্ট মোডে শুধুমাত্র স্পেস)

আপনার অনুরোধে ব্যবহৃত প্রমাণীকরণের ধরনের ওপর নির্ভর করে চ্যাট বার্তা প্রেরককে ভিন্নভাবে চিহ্নিত করে।

নিচের ছবিতে দেখানো হয়েছে, অ্যাপ অথেন্টিকেশন ব্যবহার করার সময় চ্যাট কীভাবে একটি মেসেজকে অ্যাট্রিবিউট করে। চ্যাট অ্যাপটিকে মেসেজ প্রেরক হিসেবে প্রদর্শন করে। মেসেজের কন্টেন্টে টেক্সট ( text ), কার্ড ( cardsV2 ), এবং অ্যাক্সেসরি উইজেট ( accessoryWidgets ) থাকতে পারে।

অ্যাপ প্রমাণীকরণের মাধ্যমে বার্তা পাঠানো হয়েছে।

নিচের ছবিতে দেখানো হয়েছে, ব্যবহারকারী প্রমাণীকরণ ব্যবহার করার সময় চ্যাট কীভাবে একটি বার্তার উৎস নির্ধারণ করে। চ্যাট ব্যবহারকারীকে বার্তার প্রেরক হিসেবে দেখায় এবং বার্তার নাম প্রদর্শন করে চ্যাট অ্যাপটিকে বার্তার উৎস হিসেবে চিহ্নিত করে। বার্তার বিষয়বস্তুতে শুধুমাত্র টেক্সট ( text ) থাকতে পারে।

ব্যবহারকারীর প্রমাণীকরণের মাধ্যমে বার্তা পাঠানো হয়েছে।

বার্তার বিষয়বস্তুসহ সর্বোচ্চ বার্তার আকার হলো ৩২,০০০ বাইট।

ওয়েবহুক অনুরোধের ক্ষেত্রে, প্রতিক্রিয়াতে সম্পূর্ণ বার্তাটি থাকে না। অনুরোধে থাকা তথ্যের পাশাপাশি প্রতিক্রিয়াটি কেবল ' name এবং thread.name ফিল্ডগুলো পূরণ করে।

HTTP অনুরোধ

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

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

পথের পরামিতি

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

string

আবশ্যক। যে স্পেসে বার্তা তৈরি করতে হবে, তার রিসোর্স নাম।

ফর্ম্যাট: spaces/{space}

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

প্যারামিটার
threadKey
(deprecated)

string

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

requestId

string

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

messageReplyOption

enum ( MessageReplyOption )

ঐচ্ছিক। কোনো বার্তা একটি থ্রেড শুরু করবে নাকি তার উত্তর দেবে, তা নির্দিষ্ট করে। শুধুমাত্র নামযুক্ত স্পেসে সমর্থিত।

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

messageId

string

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

এই ফিল্ডের মানকে অবশ্যই নিম্নলিখিত শর্তগুলো পূরণ করতে হবে:

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

বিস্তারিত জানতে, ‘বার্তার নাম দিন’ দেখুন।

createMessageNotificationOptions

object ( CreateMessageNotificationOptions )

ঐচ্ছিক। বার্তা পোস্ট করার সময় নোটিফিকেশনের আচরণ নিয়ন্ত্রণ করে। আরও জানতে, ‘বাধ্যতামূলক নোটিফিকেশন’ অথবা ‘নীরব বার্তা পাঠান’ দেখুন।

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

অনুরোধের বডিতে 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

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

বার্তা উত্তর বিকল্প

বার্তার উত্তর কীভাবে দিতে হবে তা নির্দিষ্ট করে। ভবিষ্যতে আরও অবস্থা যোগ করা হতে পারে।

এনাম
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 ত্রুটি ফেরত দেওয়া হয়।

CreateMessageNotificationOptions

মেসেজ পোস্ট করা হলে নোটিফিকেশনের আচরণের জন্য বিকল্পসমূহ।

JSON উপস্থাপনা 
{
  "notificationType": enum (NotificationType)
}
ক্ষেত্র
notificationType

enum ( NotificationType )

বার্তাটির জন্য বিজ্ঞপ্তির ধরণ।

বিজ্ঞপ্তির ধরণ

বার্তার জন্য বিজ্ঞপ্তির প্রকারের বিকল্পসমূহ।

এনাম
NOTIFICATION_TYPE_NONE ডিফল্ট আচরণ। নোটিফিকেশনের আচরণটি অনেকটা চ্যাট UI ব্যবহার করে কোনো ব্যবহারকারীর বার্তা পাঠানোর মতোই: প্রেরকের কাছে কোনো নোটিফিকেশন পাঠানো হয় না।
NOTIFICATION_TYPE_FORCE_NOTIFY

প্রাপকদের জোরপূর্বক অবহিত করুন। এটি ব্যবহারকারীদের স্পেস নোটিফিকেশন সেটিংস এবং চ্যাট ডু নট ডিস্টার্ব সেটিংসকে বাইপাস করে। এই বিকল্পটি ডিভাইস-স্তরের ডু নট ডিস্টার্ব সেটিংসকে বাইপাস করে না।

অ্যাপের প্রমাণীকরণ প্রয়োজন।

NOTIFICATION_TYPE_SILENT

নোটিফিকেশনটি এমনভাবে সাইলেন্স করুন, যেন প্রাপকদের চ্যাট ডু নট ডিস্টার্ব চালু আছে অথবা তারা স্পেসটি মিউট করে রেখেছেন।

অ্যাপের প্রমাণীকরণ প্রয়োজন।