Subscriptions

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

পদ্ধতি

API, subscriptions রিসোর্সের জন্য নিম্নলিখিত পদ্ধতিগুলি সমর্থন করে:

তালিকা
API অনুরোধের মাপকাঠির সাথে ম্যাচ করে এমন সাবস্ক্রিপশন রিসোর্স রিটার্ন করে। এখনই এটি ব্যবহার করে দেখুন।
ইনসার্ট করুন
প্রমাণিত ব্যবহারকারীর চ্যানেলে সাবস্ক্রিপশন যোগ করে। এখনই এটি ব্যবহার করে দেখুন।
মুছে ফেলুন
সাবস্ক্রিপশন মুছে দেয়। এখনই এটি ব্যবহার করে দেখুন।

রিসোর্স রিপ্রেজেন্টেশন

নিম্নলিখিত JSON স্ট্রাকচার subscriptions রিসোর্সের ফর্ম্যাট দেখায়:

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

প্রপার্টি

নিম্নলিখিত সারণীতে এই রিসোর্সে দেখানো প্রপার্টিগুলি সংজ্ঞায়িত করা হয়েছে:

প্রপার্টি
kind string
API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#subscription।
etag etag
এই রিসোর্সের Etag.
id string
সাবস্ক্রিপশন অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে।
snippet object
snippet অবজেক্টে সাবস্ক্রিপশন সম্পর্কে প্রাথমিক বিবরণ থাকে, যার মধ্যে এর শীর্ষক এবং ব্যবহারকারী যে চ্যানেলে সাবস্ক্রাইব করেছেন সেটি অন্তর্ভুক্ত থাকে।
snippet.publishedAt datetime
যে তারিখ ও সময়ে সাবস্ক্রিপশন তৈরি করা হয়েছে। ভ্যালু ISO 8601 ফর্ম্যাটে উল্লেখ করা হয়েছে।
snippet.title string
সাবস্ক্রিপশনের শীর্ষক।
snippet.description string
সাবস্ক্রিপশনের বিবরণ।
snippet.resourceId object
id অবজেক্টে ব্যবহারকারীর সাবস্ক্রাইব করা চ্যানেল সম্পর্কে তথ্য থাকে।
snippet.resourceId.kind string
API রিসোর্সের ধরন।
snippet.resourceId.channelId string
ব্যবহারকারী সাবস্ক্রাইব করেছেন এমন চ্যানেলকে অনন্যভাবে শনাক্ত করতে YouTube যে ভ্যালু ব্যবহার করে।
snippet.channelId string
YouTube সাবস্ক্রাইবারের চ্যানেলকে অনন্যভাবে শনাক্ত করতে যে আইডি ব্যবহার করে। resource_id অবজেক্ট ব্যবহারকারী যে চ্যানেল সাবস্ক্রাইব করেছেন সেটি শনাক্ত করে।
snippet.thumbnails object
সাবস্ক্রিপশনের সাথে যুক্ত থাম্বনেল ছবির ম্যাপ। ম্যাপের প্রতিটি অবজেক্টের জন্য, কী হল থাম্বনেল ছবির নাম এবং ভ্যালু হল একটি অবজেক্ট যাতে থাম্বনেল সম্পর্কে অন্যান্য তথ্য থাকে।
snippet.thumbnails.(key) object
সঠিক কী ভ্যালু হল:
  • default – এই রিসোর্সের জন্য ডিফল্ট থাম্বনেল ছবি। কোনও ভিডিওর ডিফল্ট থাম্বনেল – অথবা কোনও ভিডিওকে রেফার করে এমন রিসোর্স, যেমন প্লেলিস্ট আইটেম বা সার্চ ফলাফল – ১২০ পিক্সেল চওড়া এবং ৯০ পিক্সেল লম্বা হয়। কোনও চ্যানেলের ডিফল্ট থাম্বনেল ৮৮ পিক্সেল চওড়া ও ৮৮ পিক্সেল লম্বা হয়।
  • medium – থাম্বনেল ছবির আরও উন্নত রেজোলিউশন ভার্সন। কোনও ভিডিওর (বা ভিডিওর সাথে সম্পর্কিত রিসোর্স) ক্ষেত্রে, এই ছবি ৩২০ পিক্সেল চওড়া এবং ১৮০ পিক্সেল লম্বা হয়। কোনও চ্যানেলের জন্য এই ছবিটি ২৪০ পিক্সেল চওড়া ও ২৪০ পিক্সেল লম্বা হয়।
  • high – থাম্বনেল ছবির হাই রেজোলিউশন ভার্সন। কোনও ভিডিওর (বা ভিডিও রেফার করে এমন রিসোর্স) জন্য এই ছবি ৪৮০ পিক্সেল চওড়া ও ৩৬০ পিক্সেল লম্বা হয়। কোনও চ্যানেলের জন্য, এই ছবিটি ৮০০ পিক্সেল চওড়া ও ৮০০ পিক্সেল লম্বা হয়।
snippet.thumbnails.(key).url string
ছবির URL.
snippet.thumbnails.(key).width unsigned integer
ছবির প্রস্থ।
snippet.thumbnails.(key).height unsigned integer
ছবির উচ্চতা।
contentDetails object
contentDetails অবজেক্টে সাবস্ক্রিপশন সম্পর্কে প্রাথমিক পরিসংখ্যান থাকে।
contentDetails.totalItemCount unsigned integer
সাবস্ক্রিপশন যতগুলি আইটেমকে নির্দেশ করে তার আনুমানিক সংখ্যা।
contentDetails.newItemCount unsigned integer
সাবস্ক্রিপশনের কন্টেন্ট শেষবার পড়ার পর থেকে নতুন আইটেমের সংখ্যা।
contentDetails.activityType string
এই সাবস্ক্রিপশন কোন ধরনের অ্যাক্টিভিটির জন্য (শুধু আপলোড, সবকিছু)।

এই প্রপার্টির জন্য সঠিক ভ্যালু হল:
  • all
  • uploads
subscriberSnippet object
subscriberSnippet অবজেক্টে সাবস্ক্রাইবার সম্পর্কে প্রাথমিক বিবরণ থাকে।
subscriberSnippet.title string
সাবস্ক্রাইবারের চ্যানেলের নাম।
subscriberSnippet.description string
সাবস্ক্রাইবারের চ্যানেলের বিবরণ।
subscriberSnippet.channelId string
সাবস্ক্রাইবারের চ্যানেল অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি অ্যাসাইন করে।
subscriberSnippet.thumbnails object
সাবস্ক্রাইবারের চ্যানেলের জন্য থাম্বনেল ছবি।
subscriberSnippet.thumbnails.(key) object
সঠিক কী ভ্যালু হল:
  • default – এই রিসোর্সের জন্য ডিফল্ট থাম্বনেল ছবি। কোনও ভিডিওর ডিফল্ট থাম্বনেল – অথবা কোনও ভিডিওকে রেফার করে এমন রিসোর্স, যেমন প্লেলিস্ট আইটেম বা সার্চ ফলাফল – ১২০ পিক্সেল চওড়া এবং ৯০ পিক্সেল লম্বা হয়। কোনও চ্যানেলের ডিফল্ট থাম্বনেল ৮৮ পিক্সেল চওড়া ও ৮৮ পিক্সেল লম্বা হয়।
  • medium – থাম্বনেল ছবির আরও উন্নত রেজোলিউশন ভার্সন। কোনও ভিডিওর (বা ভিডিওর সাথে সম্পর্কিত রিসোর্স) ক্ষেত্রে, এই ছবি ৩২০ পিক্সেল চওড়া এবং ১৮০ পিক্সেল লম্বা হয়। কোনও চ্যানেলের জন্য এই ছবিটি ২৪০ পিক্সেল চওড়া ও ২৪০ পিক্সেল লম্বা হয়।
  • high – থাম্বনেল ছবির হাই রেজোলিউশন ভার্সন। কোনও ভিডিওর (বা ভিডিও রেফার করে এমন রিসোর্স) জন্য এই ছবি ৪৮০ পিক্সেল চওড়া ও ৩৬০ পিক্সেল লম্বা হয়। কোনও চ্যানেলের জন্য, এই ছবিটি ৮০০ পিক্সেল চওড়া ও ৮০০ পিক্সেল লম্বা হয়।
subscriberSnippet.thumbnails.(key).url string
ছবির URL.
subscriberSnippet.thumbnails.(key).width unsigned integer
ছবির প্রস্থ।
subscriberSnippet.thumbnails.(key).height unsigned integer
ছবির উচ্চতা।