LiveChatMessages: insert

একটি লাইভ চ্যাটে একটি বার্তা বা একটি পোল যোগ করে৷

সাধারণ ব্যবহারের ক্ষেত্রে

অনুরোধ

HTTP অনুরোধ

POST https://www.googleapis.com/youtube/v3/liveChat/messages

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।

ব্যাপ্তি
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

পরামিতি

নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।

পরামিতি
প্রয়োজনীয় পরামিতি
part string
part প্যারামিটার দুটি উদ্দেশ্য পরিবেশন করে। এটি সেই বৈশিষ্ট্যগুলিকে চিহ্নিত করে যা লেখার ক্রিয়াকলাপ সেট করবে সেইসাথে API প্রতিক্রিয়াতে যে বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করা হবে। প্যারামিটার মান snippet সেট করুন।

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

অনুরোধের অংশে একটি লাইভচ্যাটমেসেজ সংস্থান প্রদান করুন। সেই সম্পদের জন্য, আপনাকে অবশ্যই এই বৈশিষ্ট্যগুলির জন্য মান নির্দিষ্ট করতে হবে

  • snippet.liveChatId
  • snippet.type - নিম্নলিখিত বিকল্পগুলির মধ্যে একটি বেছে নিন: textMessageEvent বা pollEvent
  • টাইপ textMessageEvent হলে, snippet.textMessageDetails.messageText অন্তর্ভুক্ত করুন
  • যদি টাইপ হয় pollEvent , তাহলে নিম্নলিখিত মান সহ snippet.pollDetails অন্তর্ভুক্ত করুন:
    • snippet.pollDetails.metadata.options.questionText
    • snippet.pollDetails.metadata.options.optionText এর তালিকা। আপনাকে অবশ্যই কমপক্ষে দুটি আইটেম এবং পাঁচটির বেশি আইটেম তালিকাভুক্ত করতে হবে। আইটেমগুলি তাদের তালিকাভুক্ত ক্রমানুসারে প্রদর্শিত হয়।

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

সফল হলে, এই পদ্ধতিটি প্রতিক্রিয়া বডিতে একটি liveChatMessage রিসোর্স প্রদান করে।

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
forbidden (403) forbidden নির্দিষ্ট বার্তা তৈরি করার জন্য আপনার কাছে প্রয়োজনীয় অনুমতি নেই।
forbidden (403) liveChatDisabled নির্দিষ্ট লাইভ চ্যাট মালিক দ্বারা নিষ্ক্রিয় করা হয়েছে, যার মানে চ্যাটে বার্তা যোগ করা যাবে না।
forbidden (403) liveChatEnded নির্দিষ্ট লাইভ চ্যাট আর লাইভ নেই।
invalidValue (400) messageTextInvalid বার্তা পাঠ্য ( snippet.textMessageDetails.messageText ) বৈধ নয়৷
notFound (404) liveChatNotFound API অনুরোধে চিহ্নিত লাইভ চ্যাট বিদ্যমান নেই। মালিকের দ্বারা চ্যাট মুছে ফেলা হলে এই ত্রুটি ঘটে।
required (400) liveChatIdRequired liveChatMessage সংস্থান অবশ্যই snippet.liveChatId সম্পত্তির জন্য একটি মান অন্তর্ভুক্ত এবং নির্দিষ্ট করতে হবে।
required (400) messageTextRequired liveChatMessage রিসোর্সে অবশ্যই snippet.textMessageDetails.messageText প্রপার্টির জন্য একটি মান অন্তর্ভুক্ত এবং নির্দিষ্ট করতে হবে।
required (400) typeRequired liveChatMessage রিসোর্সে অবশ্যই snippet.type প্রপার্টির জন্য একটি মান অন্তর্ভুক্ত এবং নির্দিষ্ট করতে হবে। text প্যারামিটার মান সেট করুন
required (400) preconditionCheckFailed একটি পিন করা সক্রিয় পোল ইতিমধ্যেই বিদ্যমান৷
rateLimitExceeded rateLimitExceeded ব্যবহারকারী একটি নির্দিষ্ট সময়সীমার মধ্যে অনেক বেশি চ্যাট বার্তা পোস্ট করেছেন।

এটা চেষ্টা করুন!

এই API কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।