YouTube ডেটা API ওভারভিউ

ভূমিকা

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

আপনি শুরু করার আগে

1. Google API কনসোল অ্যাক্সেস করতে, একটি API কী অনুরোধ করতে এবং আপনার অ্যাপ্লিকেশন নিবন্ধন করতে আপনার একটি Google অ্যাকাউন্ট প্রয়োজন৷

2. Google বিকাশকারী কনসোলে একটি প্রকল্প তৈরি করুন এবং অনুমোদনের শংসাপত্রগুলি পান যাতে আপনার অ্যাপ্লিকেশন API অনুরোধগুলি জমা দিতে পারে৷

3. আপনার প্রোজেক্ট তৈরি করার পরে, নিশ্চিত করুন যে YouTube ডেটা API হল সেই পরিষেবাগুলির মধ্যে একটি যেগুলি ব্যবহার করার জন্য আপনার অ্যাপ্লিকেশন নিবন্ধিত হয়েছে:

   1. API কনসোলে যান এবং আপনি এইমাত্র নিবন্ধিত প্রকল্পটি নির্বাচন করুন।
   2. সক্রিয় APIs পৃষ্ঠায় যান। API-এর তালিকায়, YouTube Data API v3- এর জন্য স্ট্যাটাস চালু আছে কিনা তা নিশ্চিত করুন।

4. আপনার অ্যাপ্লিকেশন যদি এমন কোনো API পদ্ধতি ব্যবহার করে যার জন্য ব্যবহারকারীর অনুমোদনের প্রয়োজন হয়, তাহলে OAuth 2.0 অনুমোদন কীভাবে প্রয়োগ করতে হয় তা জানতে প্রমাণীকরণ নির্দেশিকা পড়ুন।

5. আপনার API বাস্তবায়নকে সহজ করতে একটি ক্লায়েন্ট লাইব্রেরি নির্বাচন করুন।

6. JSON (জাভাস্ক্রিপ্ট অবজেক্ট নোটেশন) ডেটা ফর্ম্যাটের মূল ধারণাগুলির সাথে নিজেকে পরিচিত করুন৷ JSON হল একটি সাধারণ, ভাষা-স্বাধীন ডেটা ফর্ম্যাট যা নির্বিচারে ডেটা স্ট্রাকচারের একটি সাধারণ পাঠ্য উপস্থাপনা প্রদান করে। আরও তথ্যের জন্য, json.org দেখুন।

সম্পদ এবং সম্পদের ধরন

একটি সম্পদ একটি অনন্য শনাক্তকারী সহ একটি পৃথক ডেটা সত্তা। নীচের সারণীতে আপনি API ব্যবহার করে ইন্টারঅ্যাক্ট করতে পারেন এমন বিভিন্ন ধরণের সংস্থান বর্ণনা করে।

উল্লেখ্য যে, অনেক ক্ষেত্রে, একটি সম্পদে অন্যান্য সম্পদের উল্লেখ থাকে। উদাহরণ স্বরূপ, একটি playlistItem রিসোর্সের snippet.resourceId.videoId প্রপার্টি এমন একটি ভিডিও রিসোর্সকে শনাক্ত করে যাতে ভিডিওটি সম্পর্কে সম্পূর্ণ তথ্য থাকে। আরেকটি উদাহরণ হিসাবে, একটি অনুসন্ধান ফলাফলে একটি videoId , playlistId বা channelId বৈশিষ্ট্য রয়েছে যা একটি নির্দিষ্ট ভিডিও, প্লেলিস্ট বা চ্যানেল সংস্থানকে চিহ্নিত করে৷

সমর্থিত অপারেশন

নিম্নলিখিত টেবিলটি সবচেয়ে সাধারণ পদ্ধতিগুলি দেখায় যা API সমর্থন করে। কিছু সংস্থান অন্যান্য পদ্ধতিগুলিকেও সমর্থন করে যা সেই সংস্থানগুলির জন্য আরও নির্দিষ্ট ফাংশন সম্পাদন করে। উদাহরণস্বরূপ, videos.rate পদ্ধতিটি একটি ভিডিওর সাথে ব্যবহারকারীর রেটিংকে সংযুক্ত করে এবং thumbnails.set পদ্ধতিটি YouTube-এ একটি ভিডিও থাম্বনেইল চিত্র আপলোড করে এবং এটি একটি ভিডিওর সাথে সংযুক্ত করে৷

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

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

কোটা ব্যবহার

YouTube Data API একটি কোটা ব্যবহার করে তা নিশ্চিত করতে যে ডেভেলপাররা উদ্দেশ্য অনুযায়ী পরিষেবাটি ব্যবহার করে এবং এমন অ্যাপ্লিকেশন তৈরি করে না যা অন্যায়ভাবে পরিষেবার গুণমান হ্রাস করে বা অন্যদের জন্য অ্যাক্সেস সীমিত করে। সব API অনুরোধ, অবৈধ অনুরোধ সহ, অন্তত একটি এক-পয়েন্ট কোটা খরচ বহন করে। আপনি API Console আপনার অ্যাপ্লিকেশনের জন্য উপলব্ধ কোটা খুঁজে পেতে পারেন।

যে প্রকল্পগুলি YouTube ডেটা API সক্ষম করে তাদের প্রতি দিনে 10,000 ইউনিটের একটি ডিফল্ট কোটা বরাদ্দ থাকে, যা আমাদের সিংহভাগ API ব্যবহারকারীদের জন্য যথেষ্ট। ডিফল্ট কোটা, যা পরিবর্তন সাপেক্ষে, আমাদের কোটা বরাদ্দ অপ্টিমাইজ করতে এবং আমাদের পরিকাঠামোকে এমনভাবে স্কেল করতে সাহায্য করে যা আমাদের API ব্যবহারকারীদের জন্য আরও অর্থবহ৷ আপনি API কনসোলের কোটা পৃষ্ঠায় আপনার কোটা ব্যবহার দেখতে পারেন।

দ্রষ্টব্য: আপনি যদি কোটার সীমায় পৌঁছে যান, আপনি YouTube API পরিষেবাগুলির জন্য কোটা এক্সটেনশন অনুরোধ ফর্মটি পূরণ করে অতিরিক্ত কোটার অনুরোধ করতে পারেন৷

কোটা ব্যবহার গণনা করা হচ্ছে

Google প্রতিটি অনুরোধের জন্য একটি খরচ নির্ধারণ করে আপনার কোটা ব্যবহারের হিসাব করে। বিভিন্ন ধরনের অপারেশনের বিভিন্ন কোটা খরচ আছে। যেমন:

• একটি পঠিত ক্রিয়াকলাপ যা সংস্থানগুলির একটি তালিকা পুনরুদ্ধার করে -- চ্যানেল, ভিডিও, প্লেলিস্ট -- সাধারণত 1 ইউনিট খরচ করে৷
• একটি লেখার ক্রিয়াকলাপ যা একটি সংস্থান তৈরি করে, আপডেট করে বা মুছে দেয় তার জন্য সাধারণত 50 ইউনিট খরচ হয়।
• একটি অনুসন্ধান অনুরোধ 100 ইউনিট খরচ.
• একটি ভিডিও আপলোডের দাম 1600 ইউনিট।

API অনুরোধ টেবিলের জন্য কোটা খরচ প্রতিটি API পদ্ধতির কোটা খরচ দেখায়। এই নিয়মগুলি মাথায় রেখে, আপনি আপনার কোটা অতিক্রম না করেই প্রতিদিন আপনার আবেদন পাঠাতে পারে এমন অনুরোধের সংখ্যা অনুমান করতে পারেন৷

আংশিক সম্পদ

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

API দুটি অনুরোধ পরামিতি সমর্থন করে, যা নিম্নলিখিত বিভাগে ব্যাখ্যা করা হয়েছে, যা আপনাকে API প্রতিক্রিয়াগুলিতে অন্তর্ভুক্ত করা উচিত এমন সংস্থান বৈশিষ্ট্যগুলি সনাক্ত করতে সক্ষম করে।

• part প্যারামিটার বৈশিষ্ট্যের গোষ্ঠী চিহ্নিত করে যা একটি সম্পদের জন্য ফেরত দেওয়া উচিত।
• fields প্যারামিটার শুধুমাত্র অনুরোধ করা সম্পদ অংশের মধ্যে নির্দিষ্ট বৈশিষ্ট্য ফেরত দিতে API প্রতিক্রিয়া ফিল্টার করে।

part প্যারামিটার কিভাবে ব্যবহার করবেন

part প্যারামিটার হল যেকোন API অনুরোধের জন্য একটি প্রয়োজনীয় প্যারামিটার যা একটি রিসোর্স পুনরুদ্ধার করে বা ফেরত দেয়। প্যারামিটারটি এক বা একাধিক শীর্ষ-স্তরের (নন-নেস্টেড) সম্পদ বৈশিষ্ট্য সনাক্ত করে যা একটি API প্রতিক্রিয়াতে অন্তর্ভুক্ত করা উচিত। উদাহরণস্বরূপ, একটি video সংস্থানের নিম্নলিখিত অংশ রয়েছে:

• snippet
• contentDetails
• fileDetails
• player
• processingDetails
• recordingDetails
• statistics
• status
• suggestions
• topicDetails

এই সমস্ত অংশগুলি এমন বস্তু যেগুলিতে নেস্টেড বৈশিষ্ট্য রয়েছে এবং আপনি এই বস্তুগুলিকে মেটাডেটা ক্ষেত্রগুলির গ্রুপ হিসাবে ভাবতে পারেন যা API সার্ভার পুনরুদ্ধার করতে পারে (বা নাও করতে পারে)৷ যেমন, part প্যারামিটারের জন্য আপনাকে আপনার অ্যাপ্লিকেশন আসলে যে রিসোর্স উপাদানগুলি ব্যবহার করে তা নির্বাচন করতে হবে। এই প্রয়োজনীয়তা দুটি মূল উদ্দেশ্য পরিবেশন করে:

• এটি আপনার অ্যাপ্লিকেশন ব্যবহার করে না এমন মেটাডেটা ক্ষেত্রগুলি পুনরুদ্ধার করতে সময় ব্যয় করতে API সার্ভারকে বাধা দিয়ে বিলম্ব কমায়৷
• এটি আপনার অ্যাপ্লিকেশন পুনরুদ্ধার করতে পারে এমন অপ্রয়োজনীয় ডেটার পরিমাণ হ্রাস করে (বা বাদ দিয়ে) ব্যান্ডউইথের ব্যবহার হ্রাস করে।

সময়ের সাথে সাথে, সংস্থানগুলি আরও অংশ যোগ করার সাথে সাথে, এই সুবিধাগুলি কেবলমাত্র বৃদ্ধি পাবে কারণ আপনার অ্যাপ্লিকেশনটি নতুন প্রবর্তিত বৈশিষ্ট্যগুলির জন্য অনুরোধ করবে না যা এটি সমর্থন করে না।

fields প্যারামিটার কিভাবে ব্যবহার করবেন

fields পরামিতি API প্রতিক্রিয়া ফিল্টার করে, যা শুধুমাত্র part প্যারামিটার মান চিহ্নিত সম্পদ অংশ ধারণ করে, যাতে প্রতিক্রিয়া শুধুমাত্র ক্ষেত্রগুলির একটি নির্দিষ্ট সেট অন্তর্ভুক্ত করে। fields প্যারামিটার আপনাকে একটি API প্রতিক্রিয়া থেকে নেস্টেড বৈশিষ্ট্যগুলি সরাতে দেয় এবং এর ফলে আপনার ব্যান্ডউইথের ব্যবহার আরও কমিয়ে দেয়। (একটি প্রতিক্রিয়া থেকে নেস্টেড বৈশিষ্ট্য ফিল্টার করতে part প্যারামিটার ব্যবহার করা যাবে না।)

নিম্নলিখিত নিয়মগুলি fields প্যারামিটার মানের জন্য সমর্থিত সিনট্যাক্স ব্যাখ্যা করে, যা XPath সিনট্যাক্সের উপর ঢিলেঢালাভাবে ভিত্তি করে:

• একাধিক ক্ষেত্র নির্বাচন করতে একটি কমা-বিচ্ছিন্ন তালিকা ( fields=a,b ) ব্যবহার করুন।
• সমস্ত ক্ষেত্র সনাক্ত করতে একটি ওয়াইল্ডকার্ড হিসাবে একটি তারকাচিহ্ন ( fields=* ) ব্যবহার করুন।
• API প্রতিক্রিয়াতে অন্তর্ভুক্ত করা হবে এমন নেস্টেড বৈশিষ্ট্যগুলির একটি গ্রুপ নির্দিষ্ট করতে বন্ধনী ( fields=a(b,c) ) ব্যবহার করুন।
• একটি নেস্টেড সম্পত্তি সনাক্ত করতে একটি ফরোয়ার্ড স্ল্যাশ ( fields=a/b ) ব্যবহার করুন।

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

• fields=items/id,playlistItems/snippet/title,playlistItems/snippet/position
• fields=items(id,snippet/title,snippet/position)
• fields=items(id,snippet(title,position))

দ্রষ্টব্য: সমস্ত ক্যোয়ারী প্যারামিটার মানের মতো, fields প্যারামিটার মান অবশ্যই URL এনকোড করা উচিত। ভাল পঠনযোগ্যতার জন্য, এই নথির উদাহরণগুলি এনকোডিং বাদ দেয়।

নমুনা আংশিক অনুরোধ

নীচের উদাহরণগুলি প্রদর্শন করে যে আপনি কীভাবে part এবং fields পরামিতিগুলি ব্যবহার করতে পারেন তা নিশ্চিত করতে API প্রতিক্রিয়াগুলিতে শুধুমাত্র আপনার অ্যাপ্লিকেশন ব্যবহার করা ডেটা অন্তর্ভুক্ত করে:

1. উদাহরণ 1 একটি ভিডিও রিসোর্স প্রদান করে যাতে চারটি অংশের পাশাপাশি kind এবং etag বৈশিষ্ট্য অন্তর্ভুক্ত থাকে।
2. উদাহরণ 2 একটি ভিডিও সংস্থান প্রদান করে যাতে দুটি অংশের পাশাপাশি kind এবং etag বৈশিষ্ট্য অন্তর্ভুক্ত থাকে।
3. উদাহরণ 3 একটি ভিডিও সংস্থান প্রদান করে যা দুটি অংশ অন্তর্ভুক্ত করে কিন্তু kind এবং etag বৈশিষ্ট্যগুলি বাদ দেয়।
4. উদাহরণ 4 একটি ভিডিও রিসোর্স প্রদান করে যা দুটি অংশ অন্তর্ভুক্ত করে কিন্তু রিসোর্সের snippet অবজেক্টে কিছু নেস্টেড বৈশিষ্ট্যের পাশাপাশি kind এবং etag বাদ দেয়।

URL: https://www.googleapis.com/youtube/v3/videos?id=7lCDEYXw3mM&key=YOUR_API_KEY
     &part=snippet,contentDetails,statistics,status

Description: This example retrieves a video resource and identifies several
             resource parts that should be included in the API response.

API response:

{ 
 "kind": "youtube#videoListResponse",
 "etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/sDAlsG9NGKfr6v5AlPZKSEZdtqA\"",
 "videos": [
  {
   "id": "7lCDEYXw3mM",
   "kind": "youtube#video",
   "etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/iYynQR8AtacsFUwWmrVaw4Smb_Q\"",
   "snippet": { 
    "publishedAt": "2012-06-20T22:45:24.000Z",
    "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
    "title": "Google I/O 101: Q&A On Using Google APIs",
    "description": "Antonio Fuentes speaks to us and takes questions on working with Google APIs and OAuth 2.0.",
    "thumbnails": {
     "default": {
      "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/default.jpg"
     },
     "medium": {
      "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/mqdefault.jpg"
     },
     "high": {
      "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/hqdefault.jpg"
     }
    },
    "categoryId": "28"
   },
   "contentDetails": {
    "duration": "PT15M51S",
    "aspectRatio": "RATIO_16_9"
   },
   "statistics": {
    "viewCount": "3057",
    "likeCount": "25",
    "dislikeCount": "0",
    "favoriteCount": "17",
    "commentCount": "12"
   },
   "status": {
    "uploadStatus": "STATUS_PROCESSED",
    "privacyStatus": "PRIVACY_PUBLIC"
   }
  }
 ]
}

URL: https://www.googleapis.com/youtube/v3/videos?id=7lCDEYXw3mM&key=YOUR_API_KEY
     &part=snippet,statistics

Description: This example modifies the part parameter value so that the
             contentDetails and status properties are not included
             in the response.

API response:

{ 
 "kind": "youtube#videoListResponse",
 "etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/sDAlsG9NGKfr6v5AlPZKSEZdtqA\"",
 "videos": [
  {
   "id": "7lCDEYXw3mM",
   "kind": "youtube#video",
   "etag": "\"UCBpFjp2h75_b92t44sqraUcyu0/iYynQR8AtacsFUwWmrVaw4Smb_Q\"",
   "snippet": { 
    "publishedAt": "2012-06-20T22:45:24.000Z",
    "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
    "title": "Google I/O 101: Q&A On Using Google APIs",
    "description": "Antonio Fuentes speaks to us and takes questions on working with Google APIs and OAuth 2.0.",
    "thumbnails": {
     "default": {
      "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/default.jpg"
     },
     "medium": {
      "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/mqdefault.jpg"
     },
     "high": {
      "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/hqdefault.jpg"
     }
    },
    "categoryId": "28"
   },
   "statistics": {
    "viewCount": "3057",
    "likeCount": "25",
    "dislikeCount": "0",
    "favoriteCount": "17",
    "commentCount": "12"
   }
  }
 ]
}

URL: https://www.googleapis.com/youtube/v3/videos?id=7lCDEYXw3mM&key=YOUR_API_KEY
     &part=snippet,statistics&fields=items(id,snippet,statistics)

Description: This example adds the fields parameter to remove all
             kind and etag properties from the API response.

API response:

{ 
 "videos": [
  {
   "id": "7lCDEYXw3mM",
   "snippet": { 
    "publishedAt": "2012-06-20T22:45:24.000Z",
    "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
    "title": "Google I/O 101: Q&A On Using Google APIs",
    "description": "Antonio Fuentes speaks to us and takes questions on working with Google APIs and OAuth 2.0.",
    "thumbnails": {
     "default": {
      "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/default.jpg"
     },
     "medium": {
      "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/mqdefault.jpg"
     },
     "high": {
      "url": "https://i.ytimg.com/vi/7lCDEYXw3mM/hqdefault.jpg"
     }
    },
    "categoryId": "28"
   },
   "statistics": {
    "viewCount": "3057",
    "likeCount": "25",
    "dislikeCount": "0",
    "favoriteCount": "17",
    "commentCount": "12"
   }
  }
 ]
}

URL: https://www.googleapis.com/youtube/v3/videos?id=7lCDEYXw3mM&key=YOUR_API_KEY
     &fields=items(id,snippet(channelId,title,categoryId),statistics)&part=snippet,statistics

Description: This example modifies the fields parameter from example 3
             so that in the API response, each video resource's snippet
             object only includes the channelId, title,
             and categoryId properties.

API response:

{ 
 "videos": [
  {
   "id": "7lCDEYXw3mM",
   "snippet": { 
    "channelId": "UC_x5XG1OV2P6uZZ5FSM9Ttw",
    "title": "Google I/O 101: Q&A On Using Google APIs",
    "categoryId": "28"
   },
   "statistics": {
    "viewCount": "3057",
    "likeCount": "25",
    "dislikeCount": "0",
    "favoriteCount": "17",
    "commentCount": "12"
   }
  }
 ]
}

কর্মক্ষমতা অপ্টিমাইজ করা

Accept-Encoding: gzip
User-Agent: my program (gzip)