Sponsors: list

দ্রষ্টব্য: এই পদ্ধতিটি 31 মার্চ, 2020 থেকে অবহেলিত হয়েছে। এটি members.list পদ্ধতি দ্বারা প্রতিস্থাপিত হয়েছে। আপনি YouTube ডেটা API ডকুমেন্টেশনে সেই পদ্ধতি সম্পর্কে তথ্য পেতে পারেন।

30 সেপ্টেম্বর, 2020 তারিখে বা তার পরে sponsors.list পদ্ধতিটি আর সমর্থিত হবে না। API ক্লায়েন্টদের এর পরিবর্তে members.list পদ্ধতি ব্যবহার করতে sponsors.list পদ্ধতিতে কল আপডেট করা উচিত।

একটি চ্যানেলের জন্য সদস্যদের (পূর্বে "স্পন্সর" নামে পরিচিত) তালিকা করে। API অনুরোধ চ্যানেল মালিক দ্বারা অনুমোদিত হতে হবে.

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

অনুরোধ

HTTP অনুরোধ

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

অনুমোদন

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

ব্যাপ্তি
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtube.readonly

পরামিতি

নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।

পরামিতি
প্রয়োজনীয় পরামিতি
part string
part প্যারামিটার sponsor রিসোর্স অংশগুলি নির্দিষ্ট করে যা API প্রতিক্রিয়া অন্তর্ভুক্ত করবে। সমর্থিত মান হল id এবং snippet ।
ঐচ্ছিক পরামিতি
filter string
filter পরামিতি নির্দিষ্ট করে যে কোন চ্যানেল স্পনসররা ফিরে আসবে। ডিফল্ট মান newest ।

গ্রহণযোগ্য মান হল:
  • all - নতুন থেকে পুরাতন সব স্পনসর ফেরত দিন।
  • newest - সাম্প্রতিকতম স্পনসরদের একটি পৃষ্ঠা ফেরত দিন। nextPageToken ব্যবহার করে পরবর্তী অনুরোধগুলি নতুন গ্রাহকদের সাইন আপ করার সাথে সাথে পুনরুদ্ধার করে।
maxResults unsigned integer
maxResults প্যারামিটারটি ফলাফল সেটে সর্বাধিক কতগুলি আইটেম ফেরত দিতে হবে তা নির্দিষ্ট করে। গ্রহণযোগ্য মান হল 0 থেকে 50 , সমেত। ডিফল্ট মান হল 5 ।
pageToken string
pageToken প্যারামিটার ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা চিহ্নিত করে যা ফেরত দেওয়া উচিত। একটি এপিআই প্রতিক্রিয়াতে, nextPageToken এবং prevPageToken বৈশিষ্ট্যগুলি অন্যান্য পৃষ্ঠাগুলি সনাক্ত করে যা পুনরুদ্ধার করা যেতে পারে।

শরীরের অনুরোধ

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

প্রতিক্রিয়া

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

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

বৈশিষ্ট্য

নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:

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

ত্রুটি

নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.

ত্রুটির ধরন ত্রুটি বিস্তারিত বর্ণনা
forbidden (403) insufficientPermissions চ্যানেলের স্পনসরদের দেখার জন্য আপনার কাছে প্রয়োজনীয় অনুমতি নেই।
invalidValue (400) invalidValueInRequest অনুরোধে একটি অবৈধ মান রয়েছে৷
invalidValue (400) sponsorshipNotEnabledForChannelId চ্যানেলটিতে স্পনসরশিপ সক্ষম করা নেই।

এটা চেষ্টা করুন!

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