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 |
stringAPI রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#subscription। |
etag |
etagএই রিসোর্সের Etag. |
id |
stringসাবস্ক্রিপশন অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে। |
snippet |
objectsnippet অবজেক্টে সাবস্ক্রিপশন সম্পর্কে প্রাথমিক বিবরণ থাকে, যার মধ্যে এর শীর্ষক এবং ব্যবহারকারী যে চ্যানেলে সাবস্ক্রাইব করেছেন সেটি অন্তর্ভুক্ত থাকে। |
snippet.publishedAt |
datetimeযে তারিখ ও সময়ে সাবস্ক্রিপশন তৈরি করা হয়েছে। ভ্যালু ISO 8601 ফর্ম্যাটে উল্লেখ করা হয়েছে। |
snippet.title |
stringসাবস্ক্রিপশনের শীর্ষক। |
snippet.description |
stringসাবস্ক্রিপশনের বিবরণ। |
snippet.resourceId |
objectid অবজেক্টে ব্যবহারকারীর সাবস্ক্রাইব করা চ্যানেল সম্পর্কে তথ্য থাকে। |
snippet.resourceId.kind |
stringAPI রিসোর্সের ধরন। |
snippet.resourceId.channelId |
stringব্যবহারকারী সাবস্ক্রাইব করেছেন এমন চ্যানেলকে অনন্যভাবে শনাক্ত করতে YouTube যে ভ্যালু ব্যবহার করে। |
snippet.channelId |
stringYouTube সাবস্ক্রাইবারের চ্যানেলকে অনন্যভাবে শনাক্ত করতে যে আইডি ব্যবহার করে। resource_id অবজেক্ট ব্যবহারকারী যে চ্যানেল সাবস্ক্রাইব করেছেন সেটি শনাক্ত করে। |
snippet.thumbnails |
objectসাবস্ক্রিপশনের সাথে যুক্ত থাম্বনেল ছবির ম্যাপ। ম্যাপের প্রতিটি অবজেক্টের জন্য, কী হল থাম্বনেল ছবির নাম এবং ভ্যালু হল একটি অবজেক্ট যাতে থাম্বনেল সম্পর্কে অন্যান্য তথ্য থাকে। |
snippet.thumbnails.(key) |
objectসঠিক কী ভ্যালু হল:
|
snippet.thumbnails.(key).url |
stringছবির URL. |
snippet.thumbnails.(key).width |
unsigned integerছবির প্রস্থ। |
snippet.thumbnails.(key).height |
unsigned integerছবির উচ্চতা। |
contentDetails |
objectcontentDetails অবজেক্টে সাবস্ক্রিপশন সম্পর্কে প্রাথমিক পরিসংখ্যান থাকে। |
contentDetails.totalItemCount |
unsigned integerসাবস্ক্রিপশন যতগুলি আইটেমকে নির্দেশ করে তার আনুমানিক সংখ্যা। |
contentDetails.newItemCount |
unsigned integerসাবস্ক্রিপশনের কন্টেন্ট শেষবার পড়ার পর থেকে নতুন আইটেমের সংখ্যা। |
contentDetails.activityType |
stringএই সাবস্ক্রিপশন কোন ধরনের অ্যাক্টিভিটির জন্য (শুধু আপলোড, সবকিছু)। এই প্রপার্টির জন্য সঠিক ভ্যালু হল:
|
subscriberSnippet |
objectsubscriberSnippet অবজেক্টে সাবস্ক্রাইবার সম্পর্কে প্রাথমিক বিবরণ থাকে। |
subscriberSnippet.title |
stringসাবস্ক্রাইবারের চ্যানেলের নাম। |
subscriberSnippet.description |
stringসাবস্ক্রাইবারের চ্যানেলের বিবরণ। |
subscriberSnippet.channelId |
stringসাবস্ক্রাইবারের চ্যানেল অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি অ্যাসাইন করে। |
subscriberSnippet.thumbnails |
objectসাবস্ক্রাইবারের চ্যানেলের জন্য থাম্বনেল ছবি। |
subscriberSnippet.thumbnails.(key) |
objectসঠিক কী ভ্যালু হল:
|
subscriberSnippet.thumbnails.(key).url |
stringছবির URL. |
subscriberSnippet.thumbnails.(key).width |
unsigned integerছবির প্রস্থ। |
subscriberSnippet.thumbnails.(key).height |
unsigned integerছবির উচ্চতা। |