Method: spaces.messages.create

Google Chat স্পেসে মেসেজ তৈরি করে। উদাহরণ হিসেবে, মেসেজ পাঠান বিকল্প দেখুন।

এই ধরনের যাচাইকরণ কাজ করে:

  • অনুমোদনের স্কোপ সহ অ্যাপ যাচাইকরণ:
    • 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 (শুধু ইমপোর্ট মোড স্পেস)

আপনার অনুরোধে ব্যবহার করা যাচাইকরণের ধরনের উপর নির্ভর করে Chat মেসেজ প্রেরককে আলাদাভাবে অ্যাট্রিবিউট করে।

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

অ্যাপ যাচাইকরণের মাধ্যমে মেসেজ পাঠানো হয়েছে

আপনি ব্যবহারকারী যাচাইকরণ ব্যবহার করলে, Chat কীভাবে মেসেজ অ্যাট্রিবিউট করে তা নিম্নলিখিত ছবিতে দেখানো হয়েছে। Chat, ব্যবহারকারীকে মেসেজ প্রেরক হিসেবে দেখায় এবং মেসেজে Chat অ্যাপের নাম দেখিয়ে সেটিকে মেসেজের সাথে অ্যাট্রিবিউট করে। মেসেজের কন্টেন্টে শুধু টেক্সট (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

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

এই ফিল্ডটি কার্যকরভাবে ব্যবহার করতে:

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

enum (MessageReplyOption)

ঐচ্ছিক। কোনও মেসেজ থ্রেড শুরু করে নাকি কোনও থ্রেডের উত্তর দেয় তা উল্লেখ করে। শুধুমাত্র নাম দেওয়া স্পেসে কাজ করে।

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

string

ঐচ্ছিক। মেসেজের জন্য কাস্টম আইডি। মেসেজের রিসোর্স নেমে (মেসেজ name ফিল্ডে দেখানো হয়) সিস্টেম-অ্যাসাইন করা আইডি সেভ না করেই Chat অ্যাপকে মেসেজ পেতে, আপডেট করতে বা মুছে দিতে দেয়।

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

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

আরও জানতে, মেসেজের নাম দিন দেখুন।
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

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

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 সমস্যা দেখানো হয়।

CreateMessageNotificationOptions

মেসেজ পোস্ট করা হলে বিজ্ঞপ্তি সংক্রান্ত আচরণের বিকল্প।

JSON উপস্থাপনা 
{
  "notificationType": enum (NotificationType)
}
ফিল্ড
notificationType

enum (NotificationType)

মেসেজের জন্য বিজ্ঞপ্তির ধরন।

NotificationType

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

Enums
NOTIFICATION_TYPE_NONE ডিফল্ট অ্যাকশন। Chat UI ব্যবহার করে কোনও ব্যক্তি মেসেজ পাঠালে যেভাবে বিজ্ঞপ্তি পাঠানো হয়, এক্ষেত্রেও একইভাবে বিজ্ঞপ্তি পাঠানো হয়: মেসেজ পাঠানো ব্যক্তিকে কোনও বিজ্ঞপ্তি পাঠানো হয় না।
NOTIFICATION_TYPE_FORCE_NOTIFY

প্রাপকদের জোর করে বিজ্ঞপ্তি পাঠান। এটি ব্যবহারকারীর স্পেস বিজ্ঞপ্তি সেটিংস এবং Chat-এর 'বিরক্ত করবে না' সেটিংস বাইপাস করে। এই বিকল্প ডিভাইস-লেভেলে 'বিরক্ত করবে না' সেটিংস বাইপাস করে না।

অ্যাপ যাচাইকরণ প্রয়োজন।
NOTIFICATION_TYPE_SILENT

প্রাপকদের বিজ্ঞপ্তি পাঠাবেন না এবং মেসেজটি 'পড়া হয়নি' হিসেবে চিহ্নিত করবেন না। এটি ব্যবহারকারীর কথোপকথন মিউট করা বা Chat-এ বিরক্ত করবে না ফিচার চালু করার মতোই কাজ করে।

অ্যাপ যাচাইকরণ প্রয়োজন।