SuperChatEvents: list

গত ৩০ দিনে কোনও চ্যানেলের লাইভ স্ট্রিম থেকে Super Chat ইভেন্টের তালিকা তৈরি করো।

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

অনুরোধ করুন

HTTP অনুরোধ

GET https://www.googleapis.com/youtube/v3/superChatEvents

অনুমোদন

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

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

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

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

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part	string part প্যারামিটার superChatEvent রিসোর্স পার্ট নির্দিষ্ট করে যা API রেসপন্সে অন্তর্ভুক্ত থাকবে। যেসব ভ্যালু কাজ করে সেগুলি হল id এবং snippet।
ঐচ্ছিক প্যারামিটার
hl	string hl প্যারামিটারটি API সার্ভারকে snippet.displayString প্রপার্টির ভ্যালু ফর্ম্যাট করার নির্দেশ দেয়, যা কোনও নির্দিষ্ট ভাষার কনভেনশন অনুযায়ী Super Chat-এর কেনাকাটার পরিমাণ ও কারেন্সি দেখায়। প্যারামিটারের মান অবশ্যই i18nLanguages.list পদ্ধতি দ্বারা রিটার্ন করা তালিকায় অন্তর্ভুক্ত ভাষা কোড হতে হবে। ডিফল্ট ভ্যালু হল en, যার অর্থ হল, ডিফল্ট আচরণ হল ডিসপ্লে স্ট্রিংগুলিকে এমনভাবে ফর্ম্যাট করা যাতে সেগুলি ইংরেজিতে ব্যবহার করা যায়। যেমন, ডিফল্ট হিসেবে, কোনও স্ট্রিং $1,00-এর পরিবর্তে $1.00 হিসেবে ফর্ম্যাট করা হয়।
maxResults	unsigned integer maxResults প্যারামিটারটি ফলাফল সেটে সর্বাধিক কতগুলি আইটেম দেখানো উচিত তা নির্দিষ্ট করে। গ্রহণযোগ্য ভ্যালু হল 1 থেকে 50, অন্তর্ভুক্ত। ডিফল্ট মান হল 5।
pageToken	string pageToken প্যারামিটার, ফলাফল সেটের মধ্যে এমন একটি নির্দিষ্ট পৃষ্ঠা শনাক্ত করে যা রিটার্ন করা উচিত। API উত্তরের মধ্যে, nextPageToken এবং prevPageToken প্রপার্টি, অন্যান্য যেসব পৃষ্ঠা রিট্রিভ করা যেতে পারে সেগুলিকে শনাক্ত করে।

অনুরোধের বডি

এই পদ্ধতি কল করার সময় অনুরোধের বডি প্রদান করবেন না।

রেসপন্স

সফল হলে, এই পদ্ধতিটি নিম্নলিখিত স্ট্রাকচার সহ একটি রেসপন্স বডি প্রদান করে:

{
  "kind": "youtube#superChatEventListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    superChatEvent resource
  ]
}

প্রপার্টি

নিম্নলিখিত সারণীতে এই রিসোর্সে দেখানো প্রপার্টিগুলি সংজ্ঞায়িত করা হয়েছে:

প্রপার্টি
kind	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু youtube#superChatEventListResponse হবে।
etag	etag এই রিসোর্সের Etag.
nextPageToken	string ফলাফলের সেটে পরবর্তী পৃষ্ঠাটি পেতে pageToken প্যারামিটারের ভ্যালু হিসেবে ব্যবহার করা যেতে পারে এমন টোকেন।
pageInfo	object pageInfo অবজেক্টটি ফলাফল সেটের জন্য পেজিং তথ্য এনক্যাপসুলেট করে।
pageInfo.totalResults	integer ফলাফলের সেটে মোট ফলাফলের সংখ্যা।
pageInfo.resultsPerPage	integer API রেসপন্সে অন্তর্ভুক্ত ফলাফলের সংখ্যা।
items[]	list অনুরোধের মাপকাঠির সাথে মেলে এমন Super Chat কেনাকাটার তালিকা।

সমস্যা

এই পদ্ধতিতে কল করার উত্তরে API যেসব সমস্যার মেসেজ পাঠাতে পারে, তা নিম্নলিখিত টেবিলে শনাক্ত করা হয়েছে। আরও বিবরণের জন্য সমস্যার মেসেজ সংক্রান্ত ডকুমেন্টেশন দেখুন।

সমস্যার ধরন	সমস্যার বিবরণ	বিবরণ
forbidden (403)	insufficientPermissions	Super Chat ইভেন্ট ফিরিয়ে আনার জন্য অনুরোধটি সঠিকভাবে অনুমোদিত নয়।

এটি ব্যবহার করে দেখুন!

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