API Reference

YouTube Data API আপনাকে নিজের ওয়েবসাইট বা অ্যাপ্লিকেশনে এমন ফাংশন যোগ করতে দেয় যা সাধারণত YouTube ওয়েবসাইটে এক্সিকিউট করা হয়। API ব্যবহার করে আপনি যেসব বিভিন্ন ধরনের রিসোর্স রিট্রিভ করতে পারবেন, নিম্নলিখিত বিভাগে সেগুলি শনাক্ত করা হয়েছে। এছাড়াও, API-তে এইসব রিসোর্সের মধ্যে অনেকগুলি যোগ, আপডেট বা মুছে দেওয়ার পদ্ধতি কাজ করে।

এই রেফারেন্স গাইড থেকে এইসব অপারেশন পারফর্ম করার জন্য API কীভাবে ব্যবহার করতে হয় তা জানতে পারবেন। রিসোর্সের ধরন অনুযায়ী গাইড সাজানো হয়েছে। রিসোর্স হল এক ধরনের আইটেম যা YouTube অভিজ্ঞতার অংশ, যেমন ভিডিও, প্লেলিস্ট বা সাবস্ক্রিপশন। প্রতিটি রিসোর্সের ধরনের জন্য, গাইড এক বা একাধিক ডেটা উপস্থাপনা তালিকাভুক্ত করে এবং রিসোর্সগুলি JSON অবজেক্ট হিসাবে উপস্থাপন করা হয়। এছাড়াও, গাইড প্রতিটি রিসোর্স ধরনের জন্য এক বা একাধিক কাজ করে এমন পদ্ধতি (LIST, POST, DELETE, ইত্যাদি) তালিকাভুক্ত করে এবং আপনার অ্যাপ্লিকেশনে সেইসব পদ্ধতি কীভাবে ব্যবহার করবেন তা ব্যাখ্যা করে।

API কল করা

YouTube Data API সংক্রান্ত অনুরোধের ক্ষেত্রে নিম্নলিখিত প্রয়োজনীয়তা প্রযোজ্য:

1. প্রতিটি অনুরোধে অবশ্যই একটি API কী (key প্যারামিটার সহ) উল্লেখ করতে হবে বা একটি OAuth 2.0 টোকেন প্রদান করতে হবে। আপনার প্রোজেক্টের জন্য Developer Console-এর API অ্যাক্সেস প্যানেলে আপনার API কী উপলভ্য।

2. প্রতিটি ইনসার্ট, আপডেট ও মুছে ফেলার অনুরোধের জন্য আপনাকে অবশ্যই একটি অনুমোদনের টোকেন পাঠাতে হবে। এছাড়াও, যাচাই করা ব্যবহারকারীর ব্যক্তিগত ডেটা পুনরুদ্ধার করে এমন যেকোনও অনুরোধের জন্য আপনাকে অবশ্যই একটি অনুমোদন টোকেন পাঠাতে হবে।

   এছাড়াও, রিসোর্স ফিরিয়ে আনার জন্য কিছু API পদ্ধতিতে এমন প্যারামিটার থাকতে পারে যার জন্য অনুমোদনের প্রয়োজন হয় বা অনুরোধ অনুমোদিত হলে অতিরিক্ত মেটাডেটা থাকতে পারে। যেমন, কোনও ব্যবহারকারীর আপলোড করা ভিডিও রিট্রিভ করার অনুরোধে ব্যক্তিগত ভিডিওও থাকতে পারে, যদি সেই নির্দিষ্ট ব্যবহারকারী অনুরোধটি অনুমোদন করে থাকেন।

3. API, OAuth 2.0 যাচাইকরণ প্রোটোকল সমর্থন করে। আপনি নিম্নলিখিত যেকোনও উপায়ে OAuth 2.0 টোকেন প্রদান করতে পারেন:

   • access_token কোয়েরি প্যারামিটার এইভাবে ব্যবহার করুন: ?access_token=oauth2-token
   • এইভাবে HTTP Authorization হেডার ব্যবহার করুন: Authorization: Bearer oauth2-token

   আপনার অ্যাপ্লিকেশনে OAuth 2.0 যাচাইকরণ প্রয়োগ করার সম্পূর্ণ নির্দেশাবলী যাচাইকরণ নির্দেশিকাতে পাওয়া যাবে।

রিসোর্সের ধরন

অ্যাক্টিভিটি

activity রিসোর্সে YouTube-এ কোনও নির্দিষ্ট চ্যানেল বা ব্যবহারকারীর নেওয়া অ্যাকশন সম্পর্কে তথ্য থাকে। অ্যাক্টিভিটি ফিডে রিপোর্ট করা অ্যাকশনের মধ্যে রয়েছে ভিডিও রেট করা, ভিডিও শেয়ার করা, ভিডিওকে পছন্দের তালিকায় যোগ করা, ভিডিও আপলোড করা ইত্যাদি। প্রতিটি activity রিসোর্স অ্যাকশনের ধরন, অ্যাকশনের সাথে যুক্ত চ্যানেল এবং অ্যাকশনের সাথে যুক্ত রিসোর্স শনাক্ত করে, যেমন রেটিং দেওয়া বা আপলোড করা ভিডিও।

এই রিসোর্স সম্পর্কে আরও তথ্য পেতে, এর রিসোর্স রেপ্রেজেন্টেশন এবং প্রপার্টির তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
list	GET /activities	অনুরোধের মাপকাঠির সাথে মেলে এমন চ্যানেল অ্যাক্টিভিটি ইভেন্টের তালিকা দেখায়। যেমন, আপনি কোনও নির্দিষ্ট চ্যানেল বা ব্যবহারকারীর নিজস্ব চ্যানেলের সাথে সম্পর্কিত ইভেন্ট ফিরিয়ে আনতে পারেন।

ক্যাপশন

caption রিসোর্স YouTube ক্যাপশন ট্র্যাকের প্রতিনিধিত্ব করে। একটি ক্যাপশন ট্র্যাক ঠিক একটি YouTube ভিডিওর সাথে যুক্ত থাকে।

এই রিসোর্স সম্পর্কে আরও তথ্য পেতে, এর রিসোর্স রেপ্রেজেন্টেশন এবং প্রপার্টির তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
delete	DELETE /captions	নির্দিষ্ট ক্যাপশন ট্র্যাক মুছে দেয়।
download	GET /captions/id	ক্যাপশন ট্র্যাক ডাউনলোড করে। অনুরোধে tfmt প্যারামিটারের কোনও ভ্যালু উল্লেখ করা না থাকলে ক্যাপশন ট্র্যাকটি তার আসল ফর্ম্যাটে এবং tlang প্যারামিটারের কোনও ভ্যালু উল্লেখ করা না থাকলে আসল ভাষাতেই ফেরত দেওয়া হয়।
insert	POST /captions	ক্যাপশন ট্র্যাক আপলোড করে।
list	GET /captions	নির্দিষ্ট ভিডিওর সাথে যুক্ত ক্যাপশন ট্র্যাকের তালিকা রিটার্ন করে। API রেসপন্সে আসল ক্যাপশন থাকে না এবং captions.download পদ্ধতি ক্যাপশন ট্র্যাক ফিরিয়ে আনার সুবিধা প্রদান করে।
update	PUT /captions	ক্যাপশন ট্র্যাক আপডেট করে। ক্যাপশন ট্র্যাক আপডেট করার সময়, আপনি ট্র্যাকের ড্রাফ্ট স্ট্যাটাস পরিবর্তন করতে, ট্র্যাকের জন্য নতুন ক্যাপশন ফাইল আপলোড করতে অথবা এই দু'টিই করতে পারবেন।

ChannelBanners

channelBanner রিসোর্সে URL থাকে যা আপনি চ্যানেলের ব্যানার ছবি হিসেবে নতুন আপলোড করা ছবি সেট করতে ব্যবহার করবেন।

এই রিসোর্স সম্পর্কে আরও তথ্য পেতে, এর রিসোর্স রেপ্রেজেন্টেশন এবং প্রপার্টির তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
insert	POST /channelBanners/insert	YouTube-এ চ্যানেল ব্যানার ছবি আপলোড করে। এই পদ্ধতিটি কোনও চ্যানেলের ব্যানার ছবি আপডেট করার জন্য তিনটি ধাপের প্রক্রিয়ার প্রথম দুটি ধাপকে উপস্থাপন করে: YouTube-এ বাইনারি ইমেজ ডেটা আপলোড করতে channelBanners.insert মেথড কল করুন। ছবির অ্যাস্পেক্ট রেশিও ১৬:৯ এবং সাইজ অন্তত ২০৪৮x১১৫২ পিক্সেল হতে হবে। আমরা ২৫৬০ পিক্সেল X ১৪৪০ পিক্সেলের ছবি আপলোড করার সাজেশন দিই। API, ধাপ ১-এর জন্য যে উত্তর দেয়, সেখান থেকে url প্রপার্টির ভ্যালু এক্সট্র্যাক্ট করুন। চ্যানেলের ব্র্যান্ডিং সেটিংস আপডেট করতে channels.update মেথড কল করুন। brandingSettings.image.bannerExternalUrl প্রপার্টির ভ্যালু ২ নম্বর ধাপে পাওয়া URL-এ সেট করুন।

ChannelSections

channelSection রিসোর্সে, কোনও চ্যানেল ফিচার করার জন্য বেছে নিয়েছে এমন ভিডিওর একটি সেট সম্পর্কে তথ্য থাকে। যেমন, কোনও বিভাগে চ্যানেলের লেটেস্ট আপলোড, সবচেয়ে জনপ্রিয় আপলোড অথবা এক বা একাধিক প্লেলিস্টের ভিডিও ফিচার করা যেতে পারে।

চ্যানেল ব্রাউজ ভিউতে (ফিড ভিউয়ের পরিবর্তে) কন্টেন্ট দেখালে তবেই চ্যানেলের বিভাগ দেখা যায়। ব্রাউজ ভিউতে কন্টেন্ট দেখানোর জন্য কোনও চ্যানেলকে চালু করতে, নির্দিষ্ট চ্যানেলের জন্য brandingSettings.channel.showBrowseView প্রপার্টি true-এ সেট করুন।

একটি চ্যানেল সর্বাধিক ১০টি শেল্ফ তৈরি করতে পারে।

এই রিসোর্স সম্পর্কে আরও তথ্যের জন্য, এর রিসোর্স উপস্থাপনা এবং প্রপার্টি-এর তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
delete	DELETE /channelSections	চ্যানেল বিভাগ মুছে দেয়।
insert	POST /channelSections	যাচাইকৃত ব্যবহারকারীর চ্যানেলে একটি চ্যানেল বিভাগ যোগ করে। একটি চ্যানেল সর্বাধিক ১০টি শেল্ফ তৈরি করতে পারে।
list	GET /channelSections	API অনুরোধের মাপকাঠির সাথে মেলে এমন channelSection রিসোর্সের তালিকা রিটার্ন করে।
update	PUT /channelSections	চ্যানেল বিভাগ আপডেট করে।

চ্যানেল

channel রিসোর্সে YouTube চ্যানেল সম্পর্কে তথ্য থাকে।

এই রিসোর্স সম্পর্কে আরও তথ্য পেতে, এর রিসোর্স রেপ্রেজেন্টেশন এবং প্রপার্টির তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
list	GET /channels	অনুরোধের মাপকাঠি পূরণ করে এমন শূন্য বা তার বেশি channel রিসোর্সের সংগ্রহ রিটার্ন করে।
update	PUT /channels	চ্যানেলের মেটাডেটা আপডেট করে। এই পদ্ধতি শুধুমাত্র channel রিসোর্স brandingSettings এবং invideoPromotion অবজেক্ট ও সেগুলির চাইল্ড প্রপার্টিতে আপডেট করার ক্ষেত্রে কাজ করে।

CommentThreads

commentThread রিসোর্সে YouTube কমেন্ট থ্রেড সম্পর্কে তথ্য থাকে, যার মধ্যে থাকে টপ-লেভেল কমেন্ট এবং সেই কমেন্টের উত্তর, যদি থাকে। commentThread রিসোর্স কোনও ভিডিও বা চ্যানেল সম্পর্কে করা কমেন্টকে উপস্থাপন করতে পারে।

আসলে, টপ-লেভেল কমেন্ট ও উত্তর, দুটিই comment রিসোর্স যা commentThread রিসোর্সের মধ্যে নেস্ট করা থাকে। commentThread রিসোর্সে কোনও কমেন্টের সব উত্তর নাও থাকতে পারে এবং কোনও নির্দিষ্ট কমেন্টের সব উত্তর পেতে চাইলে আপনাকে comments.list পদ্ধতি ব্যবহার করতে হবে। এছাড়াও, কিছু কমেন্টের কোনও উত্তর নেই।

এই রিসোর্স সম্পর্কে আরও তথ্য পেতে, এর রিসোর্স রেপ্রেজেন্টেশন এবং প্রপার্টির তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
list	GET /commentThreads	API অনুরোধের প্যারামিটারের সাথে মিলে যাওয়া কমেন্ট থ্রেডের তালিকা রিটার্ন করে।
insert	POST /commentThreads	নতুন টপ-লেভেল কমেন্ট তৈরি করে। আগে থেকে থাকা কমেন্টে উত্তর যোগ করতে, পরিবর্তে comments.insert পদ্ধতি ব্যবহার করুন।

কমেন্ট

comment রিসোর্সে একটি YouTube কমেন্ট সম্পর্কে তথ্য থাকে। comment রিসোর্স কোনও ভিডিও বা চ্যানেল সম্পর্কে কমেন্ট দেখাতে পারে। এছাড়াও, কমেন্টটি টপ-লেভেল কমেন্ট বা টপ-লেভেল কমেন্টের উত্তর হতে পারে।

এই রিসোর্স সম্পর্কে আরও তথ্যের জন্য, এর রিসোর্স উপস্থাপনা এবং প্রপার্টি-এর তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
list	GET /comments	API অনুরোধের প্যারামিটারের সাথে মেলে এমন কমেন্টের তালিকা দেখায়।
setModerationStatus	POST /comments/setModerationStatus	এক বা একাধিক কমেন্টের মডারেশন স্ট্যাটাস সেট করে। কমেন্টের সাথে যুক্ত চ্যানেল বা ভিডিওর মালিকের থেকে API অনুরোধ অনুমোদিত হতে হবে।
insert	POST /comments	আগে থেকে থাকা কমেন্টের উত্তর তৈরি করে। মনে রাখবেন: টপ-লেভেল কমেন্ট তৈরি করতে, commentThreads.insert পদ্ধতি ব্যবহার করুন।
delete	DELETE /comments	কমেন্ট মুছে দেয়।
update	PUT /comments	কমেন্ট পরিবর্তন করে।

I18nLanguages

i18nLanguage রিসোর্স YouTube ওয়েবসাইটে কাজ করে এমন অ্যাপ্লিকেশন ভাষা শনাক্ত করে। অ্যাপ্লিকেশনের ভাষাকে UI ভাষাও বলা যেতে পারে। YouTube ওয়েবসাইটের জন্য, Google অ্যাকাউন্ট সেটিংস, ব্রাউজারের ভাষা বা IP লোকেশনের উপর ভিত্তি করে অ্যাপ্লিকেশনের ভাষা অটোমেটিক বেছে নেওয়া হতে পারে। এছাড়াও, কোনও ব্যবহারকারী YouTube সাইটের ফুটার থেকে ম্যানুয়ালি UI ভাষা বেছে নিতে পারেন।

প্রতিটি i18nLanguage রিসোর্স একটি ভাষা কোড ও নাম শনাক্ত করে। videoCategories.list-এর মতো API মেথড কল করার সময় ভাষার কোড hl প্যারামিটারের ভ্যালু হিসেবে ব্যবহার করা যেতে পারে।

এই রিসোর্স সম্পর্কে আরও তথ্যের জন্য, এর রিসোর্স উপস্থাপনা এবং প্রপার্টি-এর তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
list	GET /i18nLanguages	YouTube ওয়েবসাইটে কাজ করে এমন অ্যাপ্লিকেশন ভাষার তালিকা দেখায়।

I18nRegions

i18nRegion রিসোর্স এমন একটি ভৌগোলিক অঞ্চলকে শনাক্ত করে যা YouTube ব্যবহারকারী পছন্দের কন্টেন্ট অঞ্চল হিসেবে বেছে নিতে পারেন। কন্টেন্ট অঞ্চলকে কন্টেন্ট লোকেলও বলা যেতে পারে। YouTube ওয়েবসাইটের জন্য, YouTube ডোমেন বা ব্যবহারকারীর IP লোকেশনের মতো হিউরিস্টিক্সের উপর ভিত্তি করে কন্টেন্ট অঞ্চল অটোমেটিক বেছে নেওয়া হতে পারে। এছাড়াও, কোনও ব্যবহারকারী YouTube সাইটের ফুটার থেকে কন্টেন্ট অঞ্চল ম্যানুয়ালি বেছে নিতে পারেন।

প্রতিটি i18nRegion রিসোর্স একটি অঞ্চল কোড ও নাম শনাক্ত করে। search.list, videos.list, activities.list ও videoCategories.list-এর মতো API মেথড কল করার সময়, অঞ্চল কোড regionCode প্যারামিটারের ভ্যালু হিসেবে ব্যবহার করা যেতে পারে।

এই রিসোর্স সম্পর্কে আরও তথ্যের জন্য, এর রিসোর্স উপস্থাপনা এবং প্রপার্টি-এর তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
list	GET /i18nRegions	YouTube ওয়েবসাইট কাজ করে এমন কন্টেন্ট অঞ্চলের তালিকা রিটার্ন করে।

সদস্য

member রিসোর্স YouTube চ্যানেলের মেম্বারকে উপস্থাপিত করে। একজন মেম্বার কোনও ক্রিয়েটরকে নিয়মিত আর্থিক সহায়তা প্রদান করেন এবং বিশেষ সুবিধা পান। যেমন, ক্রিয়েটর কোনও চ্যাটের জন্য শুধুমাত্র মেম্বারদের জন্য মোড চালু করলে, মেম্বাররা চ্যাট করতে পারবেন।

এই রিসোর্স সম্পর্কে আরও তথ্য পেতে, এর রিসোর্স রিপ্রেজেন্টেশন এবং প্রপার্টি-এর তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
list	GET /members	কোনও চ্যানেলের মেম্বারদের (আগে "স্পনসর" নামে পরিচিত ছিল) তালিকা দেখায়। API অনুরোধটি অবশ্যই চ্যানেলের মালিকের দ্বারা অনুমোদিত হতে হবে।

MembershipsLevels

membershipsLevel রিসোর্স সেই ক্রিয়েটরের জন্য দামের লেভেল শনাক্ত করে যিনি API অনুরোধ অনুমোদন করেছেন।

এই রিসোর্স সম্পর্কে আরও তথ্য পেতে, এর রিসোর্স রিপ্রেজেন্টেশন এবং প্রপার্টি-এর তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
list	GET /membershipsLevels	API অনুরোধ অনুমোদনকারী চ্যানেলের মালিকানাধীন membershipsLevel জিরো বা তার বেশি রিসোর্সের সংগ্রহ রিটার্ন করে। লেভেলগুলি অন্তর্নিহিত ডিসপ্লে অর্ডারে ফেরত দেওয়া হয়।

PlaylistItems

playlistItem রিসোর্স অন্য রিসোর্সকে শনাক্ত করে, যেমন প্লেলিস্টে অন্তর্ভুক্ত ভিডিও। এছাড়াও, playlistItem রিসোর্সে অন্তর্ভুক্ত রিসোর্স সম্পর্কে বিবরণ থাকে যা নির্দিষ্টভাবে সেই রিসোর্স সেই প্লেলিস্টে কীভাবে ব্যবহার করা হয় তার সাথে সম্পর্কিত।

এছাড়াও, YouTube কোনও চ্যানেলের আপলোড করা ভিডিওর তালিকা শনাক্ত করতে প্লেলিস্ট ব্যবহার করে, যেখানে playlistItem-এর প্রতিটি আইটেম একটি করে আপলোড করা ভিডিওকে বোঝায়। আপনি কোনও চ্যানেলের জন্য channel resource থেকে সেই তালিকার প্লেলিস্ট আইডি ফিরিয়ে আনতে পারবেন। তারপর আপনি playlistItems.list পদ্ধতি ব্যবহার করে তালিকা পুনরুদ্ধার করতে পারবেন।

এই রিসোর্স সম্পর্কে আরও তথ্যের জন্য, এর রিসোর্স উপস্থাপনা এবং প্রপার্টি-এর তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
delete	DELETE /playlistItems	প্লেলিস্টের আইটেম মুছে দেয়।
insert	POST /playlistItems	প্লেলিস্টে রিসোর্স যোগ করে।
list	GET /playlistItems	API অনুরোধের প্যারামিটারের সাথে মিলে যাওয়া প্লেলিস্ট আইটেমের সংগ্রহ রিটার্ন করে। আপনি নির্দিষ্ট প্লেলিস্টের সব আইটেম অথবা অনন্য আইডি ব্যবহার করে এক বা একাধিক প্লেলিস্ট আইটেম ফিরিয়ে আনতে পারবেন।
update	PUT /playlistItems	প্লেলিস্ট আইটেম পরিবর্তন করে। যেমন, আপনি প্লেলিস্টে আইটেমের পজিশন আপডেট করতে পারেন।

প্লেলিস্ট

playlist রিসোর্স YouTube প্লেলিস্টকে দেখায়। প্লেলিস্ট হল একাধিক ভিডিওর একটি সংগ্রহ যা ক্রমানুসারে দেখা এবং অন্যান্য ব্যবহারকারীর সাথে শেয়ার করা যায়। ডিফল্ট হিসেবে, প্লেলিস্ট অন্যান্য ব্যবহারকারীদের কাছে সর্বজনীনভাবে দৃশ্যমান হয়, তবে প্লেলিস্ট সর্বজনীন বা ব্যক্তিগত হতে পারে।

এছাড়াও, YouTube কোনও চ্যানেলের ভিডিওর বিশেষ সংগ্রহ শনাক্ত করতে প্লেলিস্ট ব্যবহার করে, যেমন:

• আপলোড করা ভিডিও
• পজিটিভ রেটিং দেওয়া (লাইক করা) ভিডিও
• ইতিহাস দেখুন
• পরে দেখুন

আরও নির্দিষ্টভাবে বলতে গেলে, এই তালিকাগুলি একটি চ্যানেলের সাথে যুক্ত থাকে, যা কোনও ব্যক্তি, গ্রুপ বা কোম্পানির ভিডিও, প্লেলিস্ট এবং অন্যান্য YouTube তথ্যের সংগ্রহ। আপনি প্রদত্ত চ্যানেলের জন্য channel resource থেকে এইসব তালিকার প্রতিটির জন্য প্লেলিস্ট আইডি ফিরিয়ে আনতে পারবেন।

তারপরে, আপনি playlistItems.list পদ্ধতি ব্যবহার করে সেইসব তালিকার যেকোনও একটি পুনরুদ্ধার করতে পারবেন। এছাড়াও, আপনি playlistItems.insert এবং playlistItems.delete পদ্ধতি কল করে সেইসব তালিকা থেকে আইটেম যোগ করতে বা সরাতে পারবেন।

এই রিসোর্স সম্পর্কে আরও তথ্য পেতে, এর রিসোর্স রেপ্রেজেন্টেশন এবং প্রপার্টির তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
delete	DELETE /playlists	প্লেলিস্ট মুছে দেয়।
list	GET /playlists	API অনুরোধের প্যারামিটারের সাথে মিলে যায় এমন প্লেলিস্টের সংগ্রহ রিটার্ন করে। যেমন, আপনি যাচাই করা ব্যবহারকারীর মালিকানাধীন সব প্লেলিস্ট রিট্রিভ করতে পারেন অথবা অনন্য আইডি ব্যবহার করে এক বা একাধিক প্লেলিস্ট রিট্রিভ করতে পারেন।
insert	POST /playlists	প্লেলিস্ট তৈরি করে।
update	PUT /playlists	প্লেলিস্ট পরিবর্তন করে। যেমন, আপনি কোনও প্লেলিস্টের নাম, বিবরণ বা গোপনীয়তা স্ট্যাটাস পরিবর্তন করতে পারেন।

সার্চ করুন

সার্চ ফলাফলে YouTube ভিডিও, চ্যানেল বা প্লেলিস্ট সম্পর্কে তথ্য থাকে যা API অনুরোধে নির্দিষ্ট করা সার্চ প্যারামিটারের সাথে মেলে। সার্চ ফলাফল অনন্যভাবে শনাক্তযোগ্য রিসোর্স, যেমন ভিডিওর দিকে ইঙ্গিত করলেও, এটির নিজস্ব স্থায়ী ডেটা থাকে না।

এই রিসোর্স সম্পর্কে আরও তথ্য পেতে, এর রিসোর্স রেপ্রেজেন্টেশন এবং প্রপার্টির তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
list	GET /search	API অনুরোধে নির্দিষ্ট করা কোয়েরি প্যারামিটারের সাথে মেলে এমন সার্চ ফলাফলের একটি সংগ্রহ দেখায়। ডিফল্ট হিসেবে, সার্চ ফলাফলের সেট থেকে ম্যাচ করা video, channel ও playlist রিসোর্স শনাক্ত করা হয়, তবে আপনি কোয়েরি কনফিগার করে শুধুমাত্র নির্দিষ্ট ধরনের রিসোর্সও পেতে পারেন।

সাবস্ক্রিপশন

subscription রিসোর্সে YouTube ব্যবহারকারীর সাবস্ক্রিপশন সংক্রান্ত তথ্য থাকে। কোনও চ্যানেলে নতুন ভিডিও যোগ করা হলে অথবা অন্য কোনও ব্যবহারকারী YouTube-এ কোনও অ্যাকশন নিলে, যেমন ভিডিও আপলোড করা, ভিডিওতে রেটিং দেওয়া বা ভিডিওতে কমেন্ট করা, সাবস্ক্রিপশন ব্যবহারকারীকে বিজ্ঞপ্তি পাঠায়।

এই রিসোর্স সম্পর্কে আরও তথ্য পেতে, এর রিসোর্স রেপ্রেজেন্টেশন এবং প্রপার্টির তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
delete	DELETE /subscriptions	সাবস্ক্রিপশন মুছে দেয়।
insert	POST /subscriptions	যাচাইকৃত ব্যবহারকারীর চ্যানেলের জন্য সাবস্ক্রিপশন যোগ করে।
list	GET /subscriptions	API অনুরোধের মাপকাঠির সাথে মেলে এমন সাবস্ক্রিপশন রিসোর্স দেখায়।

থাম্বনেল

thumbnail রিসোর্স, কোনও রিসোর্সের সাথে যুক্ত বিভিন্ন থাম্বনেল ছবির সাইজ শনাক্ত করে। থাম্বনেল ছবিতে নিম্নলিখিত বৈশিষ্ট্যগুলি থাকে:

• রিসোর্সের snippet.thumbnails প্রপার্টি হল এমন একটি অবজেক্ট যা সেই রিসোর্সের জন্য উপলভ্য থাম্বনেল ছবি শনাক্ত করে।
• thumbnail রিসোর্সে অবজেক্টের একটি সিরিজ থাকে। প্রতিটি অবজেক্টের নাম (default, medium, high, ইত্যাদি) থাম্বনেল ছবির সাইজকে বোঝায়।
• বিভিন্ন ধরনের রিসোর্সে থাম্বনেল ছবির বিভিন্ন সাইজ কাজ করতে পারে।
• বিভিন্ন ধরনের রিসোর্স একই নামের থাম্বনেল ছবির জন্য বিভিন্ন সাইজ নির্ধারণ করতে পারে। যেমন, video রিসোর্সের জন্য default থাম্বনেল ছবি সাধারণত ১২০ পিক্সেল x ৯০ পিক্সেল হয় এবং channel রিসোর্সের জন্য default থাম্বনেল ছবি সাধারণত ৮৮ পিক্সেল x ৮৮ পিক্সেল হয়।
• একই ধরনের রিসোর্সের ক্ষেত্রেও, YouTube-এ আপলোড করা আসল ছবি বা কন্টেন্টের রেজোলিউশনের উপর নির্ভর করে নির্দিষ্ট ছবির থাম্বনেল ছবির সাইজ আলাদা হতে পারে। যেমন, HD ভিডিও, নন-HD ভিডিওর তুলনায় আরও ভালো রেজোলিউশনের থাম্বনেল সাপোর্ট করতে পারে।
• থাম্বনেল ছবির সাইজ সম্পর্কে তথ্য আছে এমন প্রতিটি অবজেক্টে একটি width প্রপার্টি এবং একটি height প্রপার্টি থাকে। তবে, সেই ছবির জন্য প্রস্থ ও উচ্চতা প্রপার্টি নাও রিটার্ন করা হতে পারে।
• আপলোড করা থাম্বনেল ছবি প্রয়োজনীয় ডাইমেনশনের সাথে না মিললে, অ্যাস্পেক্ট রেশিও পরিবর্তন না করেই ছবিটির সাইজ সঠিক সাইজের সাথে ম্যাচ করানোর জন্য পরিবর্তন করা হয়। ছবিটি ক্রপ করা হয়নি, তবে সাইজ ঠিক করার জন্য কালো বার যোগ করা হতে পারে।

এই রিসোর্স সম্পর্কে আরও তথ্যের জন্য, এর রিসোর্স উপস্থাপনা এবং প্রপার্টি-এর তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
set	POST /thumbnails/set	YouTube-এ কাস্টম ভিডিও থাম্বনেল আপলোড করে এবং কোনও ভিডিওর জন্য এটি সেট করে।

VideoAbuseReportReasons

videoAbuseReportReason রিসোর্সে এমন একটি কারণ সম্পর্কে তথ্য থাকে যার জন্য কোনও ভিডিওতে আপত্তিজনক কন্টেন্ট থাকার কারণে সেটি ফ্ল্যাগ করা হবে। আপনার অ্যাপ্লিকেশন যখন কোনও অপব্যবহারমূলক ভিডিও সম্পর্কে অভিযোগ জানানোর জন্য videos.reportAbuse মেথড কল করে, তখন ভিডিও সম্পর্কে অভিযোগ জানানোর কারণ শনাক্ত করার জন্য অনুরোধটি videoAbuseReportReason রিসোর্স থেকে তথ্য ব্যবহার করে।

এই রিসোর্স সম্পর্কে আরও তথ্যের জন্য, এর রিসোর্স উপস্থাপনা এবং প্রপার্টি-এর তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
list	GET /videoAbuseReportReasons	অপব্যবহারমূলক ভিডিওর অভিযোগ জানানোর জন্য ব্যবহার করা যেতে পারে এমন কারণের তালিকা ফিরিয়ে আনুন।

VideoCategories

videoCategory রিসোর্স এমন একটি বিভাগকে শনাক্ত করে যা আপলোড করা ভিডিওর সাথে যুক্ত করা হয়েছে বা হতে পারে।

এই রিসোর্স সম্পর্কে আরও তথ্যের জন্য, এর রিসোর্স উপস্থাপনা এবং প্রপার্টি-এর তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
list	GET /videoCategories	YouTube ভিডিওর সাথে যুক্ত করা যেতে পারে এমন বিভাগের তালিকা রিটার্ন করে।

ভিডিও

video রিসোর্স YouTube ভিডিওকে বোঝায়।

এই রিসোর্স সম্পর্কে আরও তথ্যের জন্য, এর রিসোর্স উপস্থাপনা এবং প্রপার্টি-এর তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
insert	POST /videos	YouTube-এ ভিডিও আপলোড করে এবং ঐচ্ছিকভাবে ভিডিওর মেটাডেটা সেট করে।
list	GET /videos	API অনুরোধের প্যারামিটারের সাথে মেলে এমন ভিডিওর তালিকা দেখায়।
delete	DELETE /videos	YouTube ভিডিও মুছে দেয়।
update	PUT /videos	ভিডিওর মেটাডেটা আপডেট করে।
rate	POST /videos/rate	কোনও ভিডিওতে লাইক বা ডিসলাইক রেটিং যোগ করা বা কোনও ভিডিও থেকে রেটিং সরানো।
getRating	GET /videos/getRating	অনুমোদিত ব্যবহারকারী নির্দিষ্ট ভিডিওর তালিকায় যে রেটিং দিয়েছেন তা ফিরিয়ে আনে।
reportAbuse	POST /videos/reportAbuse	গালিগালাজপূর্ণ কন্টেন্ট থাকা ভিডিও সম্পর্কে অভিযোগ জানান।

ওয়াটারমার্ক

watermark রিসোর্স নির্দিষ্ট চ্যানেলের ভিডিও প্লেব্যাক চলাকালীন দেখানো ছবিকে শনাক্ত করে। এছাড়াও, আপনি একটি টার্গেট চ্যানেল নির্দিষ্ট করতে পারেন যার সাথে ছবিটি লিঙ্ক করা হবে, সেইসাথে সময় সংক্রান্ত বিবরণ যা নির্ধারণ করে যে ভিডিও প্লেব্যাকের সময় ওয়াটারমার্ক কখন দেখা যাবে এবং এটি কতক্ষণ দৃশ্যমান থাকবে।

এই রিসোর্স সম্পর্কে আরও তথ্য পেতে, এর রিসোর্স রেপ্রেজেন্টেশন এবং প্রপার্টির তালিকা দেখুন।

পদ্ধতি	HTTP অনুরোধ	বিবরণ
https://www.googleapis.com/youtube/v3-এর সাথে সম্পর্কিত URI
set	POST /watermarks/set	YouTube-এ ওয়াটারমার্ক ছবি আপলোড করে এবং চ্যানেলের জন্য সেট করে।
unset	POST /watermarks/unset	চ্যানেলের ওয়াটারমার্ক ছবি মুছে দেয়।