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 প্যারামিটারের জন্য একটি মান নির্দিষ্ট করে এবং এটি শুধুমাত্র সেই প্যারামিটারের সাথে ব্যবহার করা যেতে পারে। এছাড়াও, অনুরোধটি অবশ্যই একটি CMS অ্যাকাউন্ট ব্যবহার করে অনুমোদিত হতে হবে যা সামগ্রীর মালিকের সাথে লিঙ্কযুক্ত যা onBehalfOfContentOwner প্যারামিটার নির্দিষ্ট করে৷ অবশেষে, onBehalfOfContentOwnerChannel প্যারামিটার মান যে চ্যানেলটি নির্দিষ্ট করে সেটি অবশ্যই সামগ্রীর মালিকের সাথে লিঙ্ক করতে হবে যা onBehalfOfContentOwner প্যারামিটার নির্দিষ্ট করে।

এই প্যারামিটারটি YouTube বিষয়বস্তু অংশীদারদের জন্য উদ্দিষ্ট যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং পরিচালনা করে৷ এটি প্রতিটি পৃথক চ্যানেলের জন্য প্রমাণীকরণের শংসাপত্র প্রদান না করেই বিষয়বস্তুর মালিকদের একবার প্রমাণীকরণ করতে এবং প্যারামিটার মানতে নির্দিষ্ট চ্যানেলের পক্ষে ক্রিয়া সম্পাদন করতে দেয়।
pageToken string
pageToken প্যারামিটার ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা চিহ্নিত করে যা ফেরত দেওয়া উচিত। একটি এপিআই প্রতিক্রিয়াতে, 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 কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।