LiveChatMessages: insert

লাইভ চ্যাটে মেসেজ বা পোল যোগ করে।

কোটার উপর প্রভাব: এই পদ্ধতিতে কল করার জন্য ২০ ইউনিটের কোটা খরচ হয়।

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

অনুরোধ করুন

HTTP অনুরোধ

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

অনুমোদন

এই অনুরোধের জন্য নিম্নলিখিত স্কোপগুলির মধ্যে অন্তত একটির সাথে অনুমোদনের প্রয়োজন। যাচাইকরণ ও অনুমোদন সম্পর্কে আরও জানতে, OAuth 2.0 যাচাইকরণ প্রয়োগ করা দেখুন।

সুযোগ
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

প্যারামিটারগুলি

এই কোয়েরিতে যেসব প্যারামিটার কাজ করে তা নিম্নলিখিত সারণীতে দেওয়া হল। তালিকায় থাকা সব প্যারামিটারই হল কোয়েরি প্যারামিটার।

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

অনুরোধের বডি

অনুরোধের বডিতে liveChatMessage রিসোর্স প্রদান করুন। সেই রিসোর্সের জন্য, আপনাকে এইসব প্রপার্টির মান উল্লেখ করতে হবে

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

রেসপন্স

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

সমস্যা

এই পদ্ধতিতে কল করার উত্তরে API যেসব সমস্যার মেসেজ পাঠাতে পারে, তা নিম্নলিখিত টেবিলে শনাক্ত করা হয়েছে। আরও জানতে, YouTube Live Streaming 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 কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।