API Reference

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

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

API-তে কল করুন

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

  1. প্রতিটি অনুরোধে একটি API কী ( key প্যারামিটার সহ) নির্দিষ্ট করতে হবে অথবা একটি OAuth 2.0 টোকেন প্রদান করতে হবে। আপনার 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 প্রমাণীকরণ বাস্তবায়নের জন্য সম্পূর্ণ নির্দেশাবলী প্রমাণীকরণ নির্দেশিকাতে পাওয়া যাবে।

রিসোর্সের ধরণ

Activities

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

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

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

Captions

একটি 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-এ একটি চ্যানেলের ব্যানার ছবি আপলোড করে। এই পদ্ধতিটি একটি চ্যানেলের ব্যানার ছবি আপডেট করার তিন-পদক্ষেপের প্রক্রিয়ার প্রথম দুটি ধাপ উপস্থাপন করে:
  1. YouTube-এ বাইনারি ছবির ডেটা আপলোড করার জন্য channelBanners.insert পদ্ধতিতে কল করুন। ছবিটির আকৃতির অনুপাত ১৬:৯ হতে হবে এবং কমপক্ষে ২০৪৮x১১৫২ পিক্সেল হতে হবে। আমরা ২৫৬০px x ১৪৪০px মাপের একটি ছবি আপলোড করার পরামর্শ দিচ্ছি।
  2. ধাপ ১ এর জন্য API যে প্রতিক্রিয়া প্রদান করে তা থেকে url প্রোপার্টির মান বের করুন।
  3. চ্যানেলের ব্র্যান্ডিং সেটিংস আপডেট করতে channels.update পদ্ধতিতে কল করুন। ধাপ ২-এ প্রাপ্ত URL-এ brandingSettings.image.bannerExternalUrl প্রোপার্টির মান সেট করুন।

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 একটি চ্যানেল বিভাগ আপডেট করে।

Channels

একটি 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 পদ্ধতি ব্যবহার করুন।

Comments

একটি 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 ওয়েবসাইট যে কন্টেন্ট অঞ্চলগুলিকে সমর্থন করে তার একটি তালিকা প্রদান করে।

Members

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

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

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

MembershipsLevels

একটি membershipsLevel রিসোর্স API অনুরোধ অনুমোদনকারী স্রষ্টার জন্য একটি মূল্য স্তর চিহ্নিত করে।

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

পদ্ধতি HTTP অনুরোধ বিবরণ