LiveStreams: list

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

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

অনুরোধ করুন

HTTP অনুরোধ

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

অনুমোদন

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

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

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

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

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part	string part প্যারামিটারটি এক বা একাধিক liveStream রিসোর্স প্রপার্টির কমা দ্বারা আলাদা করা তালিকা নির্দিষ্ট করে যা API রেসপন্সে অন্তর্ভুক্ত থাকবে। প্যারামিটার ভ্যালুতে আপনি যেসব part নাম যোগ করতে পারবেন সেগুলি হল id, snippet, cdn ও status।
ফিল্টার (নিম্নলিখিত প্যারামিটারের মধ্যে ঠিক একটি উল্লেখ করুন)
id	string id প্যারামিটারটি YouTube স্ট্রিম আইডির কমা-সেপারেটেড তালিকা নির্দিষ্ট করে যা পুনরুদ্ধার করা হচ্ছে এমন স্ট্রিমকে শনাক্ত করে। liveStream রিসোর্সে, id প্রপার্টি স্ট্রিমের আইডি নির্দিষ্ট করে।
mine	boolean এই প্যারামিটার শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। mine প্যারামিটার ব্যবহার করে API-কে নির্দেশ দেওয়া যেতে পারে যাতে সেটি শুধু যাচাই করা ব্যবহারকারীর মালিকানাধীন স্ট্রিম দেখায়। শুধুমাত্র নিজের স্ট্রিম রিট্রিভ করতে প্যারামিটার ভ্যালু true হিসেবে সেট করুন।
ঐচ্ছিক প্যারামিটার
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#liveStreamListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    liveStream Resource
  ]
}

প্রপার্টি

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

প্রপার্টি
kind	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#liveStreamListResponse।
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-এ লাইভ ভিডিও স্ট্রিম করার জন্য উপযুক্ত নন। ব্যবহারকারী https://www.youtube.com/features থেকে আরও তথ্য পেতে পারেন।

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

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