Method: spaces.messages.create

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

create() পদ্ধতির জন্য হয় ব্যবহারকারীর প্রমাণীকরণ বা অ্যাপ প্রমাণীকরণ প্রয়োজন। আপনি আপনার অনুরোধে যে প্রমাণীকরণ ব্যবহার করেন তার উপর নির্ভর করে চ্যাট বার্তা প্রেরককে আলাদাভাবে বৈশিষ্ট্যযুক্ত করে।

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

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

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

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

বার্তার বিষয়বস্তু সহ সর্বাধিক বার্তার আকার হল 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 নির্দিষ্ট করুন। উদাহরণ ব্যবহারের জন্য, একটি বার্তা থ্রেডের শুরু বা উত্তর দেখুন।

request Id

string

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

message Reply Option

enum ( MessageReplyOption )

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

message Id

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

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

create() পদ্ধতির জন্য হয় ব্যবহারকারীর প্রমাণীকরণ বা অ্যাপ প্রমাণীকরণ প্রয়োজন। আপনি আপনার অনুরোধে যে প্রমাণীকরণ ব্যবহার করেন তার উপর নির্ভর করে চ্যাট বার্তা প্রেরককে আলাদাভাবে বৈশিষ্ট্যযুক্ত করে।

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

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

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

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

বার্তার বিষয়বস্তু সহ সর্বাধিক বার্তার আকার হল 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 নির্দিষ্ট করুন। উদাহরণ ব্যবহারের জন্য, একটি বার্তা থ্রেডের শুরু বা উত্তর দেখুন।

request Id

string

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

message Reply Option

enum ( MessageReplyOption )

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

message Id

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