Method: spaces.messages.create

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

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

  • অনুমোদনের সুযোগ সহ অ্যাপ প্রমাণীকরণ :
    • 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 কীভাবে একটি মেসেজকে অ্যাট্রিবিউট করে তা নিচের ছবিটি দেখায়। চ্যাট চ্যাট অ্যাপটিকে বার্তা প্রেরক হিসাবে প্রদর্শন করে। বার্তার বিষয়বস্তুতে পাঠ্য ( text ), কার্ড ( cardsV2 ) এবং আনুষঙ্গিক উইজেট ( accessoryWidgets উইজেট) থাকতে পারে।

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

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

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

বার্তার বিষয়বস্তু সহ সর্বাধিক বার্তার আকার হল 32,000 বাইট।

ওয়েবহুক অনুরোধের জন্য, প্রতিক্রিয়াটিতে সম্পূর্ণ বার্তা থাকে না। প্রতিক্রিয়াটি অনুরোধে থাকা তথ্য ছাড়াও 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 ব্যবহার করুন। থ্রেড জন্য আইডি. 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

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

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