প্রয়োগ: সাবস্ক্রিপশন

সাবস্ক্রিপশন সম্পর্কিত ফাংশন পারফর্ম করতে YouTube Data API (v3) কীভাবে ব্যবহার করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে।

কোনও চ্যানেলের সাবস্ক্রিপশন রিট্রিভ করা

নির্দিষ্ট চ্যানেলের সাবস্ক্রিপশন রিট্রিভ করতে subscriptions.list মেথড কল করুন। চ্যানেল শনাক্ত করার দুটি উপায় আছে:

• বর্তমানে যাচাই করা ব্যবহারকারীর সাবস্ক্রিপশন ফিরিয়ে আনতে, mine প্যারামিটারের ভ্যালু true-এ সেট করুন। মনে রাখবেন, mine প্যারামিটার ব্যবহার করা অনুরোধকে OAuth 2.0 ব্যবহার করে অবশ্যই অনুমোদন করতে হবে।

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
          part=snippet,contentDetails
          &mine=true

• অন্য কোনও চ্যানেলের সাবস্ক্রিপশন রিট্রিভ করতে, channelId প্যারামিটারের ভ্যালু সেই চ্যানেলের অনন্য YouTube চ্যানেল আইডিতে সেট করুন। নিচে দেওয়া উদাহরণে YouTube-এ TED চ্যানেল সাবস্ক্রাইব করেছে এমন চ্যানেলের তালিকা পাওয়া যায়।

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
          part=snippet,contentDetails
          &channelId=UCAuUUnT6oDeKwE6v1NGQxug

  মনে রাখবেন: নির্দিষ্ট করা চ্যানেল যদি তার সাবস্ক্রিপশন সর্বজনীনভাবে প্রকাশ না করে এবং চ্যানেলের মালিক যদি অনুরোধ অনুমোদন না করে, তাহলে API একটি 403 (Forbidden) HTTP রেসপন্স কোড রিটার্ন করে।

কোড স্যাম্পেলের জন্য subscriptions.list পদ্ধতির ডকুমেন্টেশন দেখুন।

সাবস্ক্রিপশন যোগ করা

চ্যানেল সাবস্ক্রিপশন যোগ করতে subscriptions.insert পদ্ধতি কল করুন। এই অনুরোধটি অবশ্যই OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে। অনুরোধের প্রধান অংশ হল একটি subscription রিসোর্স যা নিম্নলিখিত মান সেট করে:

• snippet.resourceId.kind-এ youtube#channel ভ্যালু আছে।
• snippet.resourceId.channelId প্রপার্টি সেই চ্যানেলকে শনাক্ত করে যেটিতে সাবস্ক্রাইব করা হচ্ছে। প্রপার্টির ভ্যালু হল একটি অনন্য YouTube চ্যানেল আইডি। channels.list মেথড কল করা বা চ্যানেলের জন্য সার্চ ফলাফল ফিরিয়ে আনা সহ একাধিক উপায়ে চ্যানেল আইডি পাওয়া যেতে পারে।

নিচে দেওয়া API অনুরোধ আপনাকে YouTube-এ TED চ্যানেলে সাবস্ক্রাইব করে:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.insert?
        part=snippet

অনুরোধের বডি হল:

{
  "snippet": {
    "resourceId": {
      "kind": "youtube#channel",
      "videoId": "UCAuUUnT6oDeKwE6v1NGQxug"
    }
  }
}

কোড স্যাম্পেলের জন্য subscriptions.insert পদ্ধতির ডকুমেন্টেশন দেখুন।

সাবস্ক্রিপশন মুছে দেওয়া

এই উদাহরণে একটি সাবস্ক্রিপশন মুছে দেওয়া হয়েছে। এই অনুরোধ OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে। এই উদাহরণে দুটি ধাপ আছে:

• ধাপ ১: যাচাই করা ব্যবহারকারীর চ্যানেলের সাবস্ক্রিপশন ফিরিয়ে আনা

  সাবস্ক্রিপশনের তালিকা পেতে subscriptions.list পদ্ধতি কল করুন। কোনও চ্যানেলের সাবস্ক্রিপশন ফিরিয়ে আনার জন্য উপরে দেওয়া উদাহরণ থেকে বোঝা যায় যে কীভাবে এই অনুরোধ করতে হয়।

  API কল করা অ্যাপ্লিকেশনটি প্রতিটি সাবস্ক্রিপশনের আইডি কী হিসেবে ব্যবহার করে সাবস্ক্রিপশনের তালিকা দেখানোর জন্য API রেসপন্স প্রসেস করতে পারে। উত্তরে, প্রতিটি আইটেমের id প্রপার্টি সাবস্ক্রিপশন আইডি শনাক্ত করে যা সংশ্লিষ্ট সাবস্ক্রিপশনকে অনন্যভাবে শনাক্ত করে। পরবর্তী ধাপে তালিকা থেকে কোনও আইটেম সরানোর জন্য আপনি সেই মান ব্যবহার করবেন।

• ধাপ ২: সাবস্ক্রিপশন মুছে দেওয়া

  সাবস্ক্রিপশন মুছে দিতে subscriptions.delete মেথড কল করুন। আপনি যে সাবস্ক্রিপশন সরাতে চান সেটির সাবস্ক্রিপশন আইডিতে অনুরোধের id প্যারামিটার সেট করুন। এই অনুরোধ OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে।

  APIs Explorer-এ অনুরোধ সম্পূর্ণ করতে, আপনাকে id প্রপার্টির ভ্যালু সেট করতে হবে।

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.delete?
          id=SUBSCRIPTION_ID

কোড স্যাম্পেলের জন্য subscriptions.delete পদ্ধতির ডকুমেন্টেশন দেখুন।

অনুমোদিত ব্যবহারকারীর চ্যানেলের সাবস্ক্রাইবারদের তালিকা ফিরিয়ে আনুন

বর্তমানে যাচাই করা ব্যবহারকারীর চ্যানেলে সাবস্ক্রাইব করা চ্যানেলের তালিকা পেতে, subscriptions.list পদ্ধতি কল করুন এবং mySubscribers প্যারামিটারের মান true-এ সেট করুন। OAuth 2.0 ব্যবহার করে অনুরোধটি অবশ্যই অনুমোদিত হতে হবে।

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.subscriptions.list?
        part=snippet,contentDetails
        &mySubscribers=true