LiveBroadcasts: list

API অনুরোধের প্যারামিটারের সাথে মেলে এমন YouTube ব্রডকাস্টের তালিকা দেখায়।

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

অনুরোধ করুন

HTTP অনুরোধ

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

অনুমোদন

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

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

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

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

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part	string part প্যারামিটারটি এক বা একাধিক liveBroadcast রিসোর্স প্রপার্টির কমা দ্বারা আলাদা করা তালিকা নির্দিষ্ট করে যা API রেসপন্সে অন্তর্ভুক্ত থাকবে। প্যারামিটারের মানে আপনি যেসব part নাম যোগ করতে পারবেন সেগুলি হল id, snippet, contentDetails, monetizationDetails এবং status।
ফিল্টার (নিম্নলিখিত প্যারামিটারগুলির মধ্যে ঠিক একটি নির্দিষ্ট করুন)
broadcastStatus	string broadcastStatus প্যারামিটার API উত্তর ফিল্টার করে যাতে শুধু নির্দিষ্ট স্ট্যাটাস সহ ব্রডকাস্ট অন্তর্ভুক্ত থাকে। গ্রহণযোগ্য মান হল: active – বর্তমান লাইভ ব্রডকাস্ট রিটার্ন করে। all – সব ব্রডকাস্ট ফিরিয়ে দিন। completed – যেসব সম্প্রচার আগেই শেষ হয়ে গেছে সেগুলি ফিরিয়ে আনা। upcoming – এখনও শুরু হয়নি এমন ব্রডকাস্ট ফিরিয়ে দেয়।
id	string id প্যারামিটারটি YouTube ব্রডকাস্ট আইডির একটি কমা-দ্বারা আলাদা করা তালিকা নির্দিষ্ট করে যা পুনরুদ্ধার করা ব্রডকাস্টগুলিকে শনাক্ত করে। liveBroadcast রিসোর্সে, id প্রপার্টি ব্রডকাস্টের আইডি নির্দিষ্ট করে।
mine	boolean mine প্যারামিটার ব্যবহার করে API-কে নির্দেশ দেওয়া যেতে পারে যাতে সেটি শুধু যাচাই করা ব্যবহারকারীর মালিকানাধীন ব্রডকাস্টই দেখায়। শুধুমাত্র নিজের ব্রডকাস্ট রিট্রিভ করতে প্যারামিটার ভ্যালু true হিসেবে সেট করুন।
ঐচ্ছিক প্যারামিটার
broadcastType	string broadcastType প্যারামিটার API রেসপন্স ফিল্টার করে যাতে শুধুমাত্র নির্দিষ্ট ধরনের ব্রডকাস্ট অন্তর্ভুক্ত থাকে। এই প্যারামিটারটি এমন অনুরোধে ব্যবহার করা উচিত যা mine প্যারামিটারকে true-এ সেট করে বা broadcastStatus প্যারামিটার ব্যবহার করে। ডিফল্ট ভ্যালু হল event। গ্রহণযোগ্য ভ্যালু হল: all – সব ব্রডকাস্ট ফিরিয়ে আনুন। event – শুধুমাত্র শিডিউল করা ইভেন্ট ব্রডকাস্ট দেখায়। persistent – শুধুমাত্র স্থায়ী ব্রডকাস্ট ফেরত দেয়।
maxResults	unsigned integer maxResults প্যারামিটারটি ফলাফল সেটে সর্বাধিক কতগুলি আইটেম দেখানো উচিত তা নির্দিষ্ট করে। গ্রহণযোগ্য ভ্যালু হল 0 থেকে 50, অন্তর্ভুক্ত। ডিফল্ট মান হল 5।
onBehalfOfContentOwner	string এই প্যারামিটার শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য। onBehalfOfContentOwner প্যারামিটারটি দেখায় যে অনুরোধের অনুমোদনের ক্রেডেনশিয়াল একজন YouTube কন্টেন্ট ম্যানেজমেন্ট সিস্টেম (CMS) ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার ভ্যালুতে নির্দিষ্ট করা কন্টেন্ট মালিকের হয়ে কাজ করছেন। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা একাধিক YouTube চ্যানেলের মালিকানা ও ম্যানেজমেন্ট করেন। এটি কন্টেন্টের মালিকদের একবার যাচাইকরণ করার এবং প্রতিটি চ্যানেলের জন্য আলাদাভাবে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটা অ্যাক্সেস করার অনুমতি দেয়। ব্যবহারকারী যে CMS অ্যাকাউন্ট দিয়ে যাচাই করেন সেটি নির্দিষ্ট YouTube কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে।
onBehalfOfContentOwnerChannel	string এই প্যারামিটার শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য। onBehalfOfContentOwnerChannel প্যারামিটারটি সেই চ্যানেলের YouTube চ্যানেল আইডি নির্দিষ্ট করে যেখানে ভিডিও যোগ করা হচ্ছে। কোনও অনুরোধে onBehalfOfContentOwner প্যারামিটারের জন্য কোনও মান নির্দিষ্ট করা হলে এই প্যারামিটারটি প্রয়োজন হয় এবং এটি শুধুমাত্র সেই প্যারামিটারের সাথে একসাথে ব্যবহার করা যেতে পারে। এছাড়াও, onBehalfOfContentOwner প্যারামিটার যে কন্টেন্টের মালিককে নির্দিষ্ট করে, তার সাথে লিঙ্ক করা CMS অ্যাকাউন্ট ব্যবহার করে অনুরোধটি অবশ্যই অনুমোদিত হতে হবে। সবশেষে, onBehalfOfContentOwnerChannel প্যারামিটারের মান যে চ্যানেলকে নির্দিষ্ট করে, সেটি onBehalfOfContentOwner প্যারামিটারের নির্দিষ্ট করা কন্টেন্টের মালিকের সাথে লিঙ্ক করা থাকতে হবে। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং সেগুলি ম্যানেজ করেন। এটি কন্টেন্টের মালিকদের একবার প্রমাণীকরণ করতে এবং প্রতিটি আলাদা চ্যানেলের জন্য প্রমাণীকরণ ক্রেডেনশিয়াল প্রদান না করেই প্যারামিটার ভ্যালুতে নির্দিষ্ট করা চ্যানেলের হয়ে অ্যাকশন পারফর্ম করতে দেয়।
pageToken	string pageToken প্যারামিটারটি ফলাফল সেটের একটি নির্দিষ্ট পৃষ্ঠা শনাক্ত করে যা ফেরত দেওয়া উচিত। API রেসপন্সে, nextPageToken এবং prevPageToken প্রপার্টি অন্যান্য পৃষ্ঠা শনাক্ত করে যা ফিরিয়ে আনা যেতে পারে।

অনুরোধের বডি

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

রেসপন্স

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

{
  "kind": "youtube#liveBroadcastListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    liveBroadcast Resource
  ]
}

প্রপার্টি

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

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

সমস্যা

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

সমস্যার ধরন	সমস্যার বিবরণ	বিবরণ
insufficientPermissions	insufficientLivePermissions	লাইভ ব্রডকাস্ট রিট্রিভ করার জন্য অনুরোধটি অনুমোদিত নয়।
insufficientPermissions	liveStreamingNotEnabled	যে ব্যবহারকারী অনুরোধ অনুমোদন করেছেন তিনি YouTube-এ লাইভ ভিডিও স্ট্রিম করার জন্য উপযুক্ত নন। আরও তথ্যের জন্য, ফিচারের উপযুক্ততা দেখুন।

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

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