একটি activity সংস্থানটিতে একটি নির্দিষ্ট চ্যানেল বা ব্যবহারকারী YouTube-এ নেওয়া একটি পদক্ষেপ সম্পর্কে তথ্য রয়েছে৷ অ্যাক্টিভিটি ফিডগুলিতে রিপোর্ট করা ক্রিয়াগুলির মধ্যে রয়েছে একটি ভিডিও রেটিং করা, একটি ভিডিও ভাগ করা, একটি ভিডিওকে প্রিয় হিসাবে চিহ্নিত করা, একটি ভিডিও আপলোড করা এবং আরও অনেক কিছু৷ প্রতিটি activity সংস্থান কর্মের ধরণ, ক্রিয়াটির সাথে যুক্ত চ্যানেল এবং কর্মের সাথে যুক্ত সংস্থান(গুলি) চিহ্নিত করে, যেমন ভিডিওটি রেট করা বা আপলোড করা হয়েছে৷
পদ্ধতি
API activities সংস্থানগুলির জন্য নিম্নলিখিত পদ্ধতিগুলিকে সমর্থন করে:
- list
- অনুরোধের মানদণ্ডের সাথে মেলে এমন চ্যানেল কার্যকলাপের একটি তালিকা প্রদান করে। উদাহরণস্বরূপ, আপনি একটি নির্দিষ্ট চ্যানেল বা ব্যবহারকারীর নিজস্ব চ্যানেলের সাথে সম্পর্কিত ইভেন্টগুলি পুনরুদ্ধার করতে পারেন৷ এখনই চেষ্টা করে দেখুন ।
সম্পদ প্রতিনিধিত্ব
নিম্নলিখিত JSON গঠন একটি activities সম্পদের বিন্যাস দেখায়:
{
"kind": "youtube#activity",
"etag": etag,
"id": string,
"snippet": {
"publishedAt": datetime,
"channelId": string,
"title": string,
"description": string,
"thumbnails": {
(key): {
"url": string,
"width": unsigned integer,
"height": unsigned integer
}
},
"channelTitle": string,
"type": string,
"groupId": string
},
"contentDetails": {
"upload": {
"videoId": string
},
"like": {
"resourceId": {
"kind": string,
"videoId": string,
}
},
"favorite": {
"resourceId": {
"kind": string,
"videoId": string,
}
},
"comment": {
"resourceId": {
"kind": string,
"videoId": string,
"channelId": string,
}
},
"subscription": {
"resourceId": {
"kind": string,
"channelId": string,
}
},
"playlistItem": {
"resourceId": {
"kind": string,
"videoId": string,
},
"playlistId": string,
"playlistItemId": string
},
"recommendation": {
"resourceId": {
"kind": string,
"videoId": string,
"channelId": string,
},
"reason": string,
"seedResourceId": {
"kind": string,
"videoId": string,
"channelId": string,
"playlistId": string
}
},
"social": {
"type": string,
"resourceId": {
"kind": string,
"videoId": string,
"channelId": string,
"playlistId": string
},
"author": string,
"referenceUrl": string,
"imageUrl": string
},
"channelItem": {
"resourceId": {
}
},
}
}বৈশিষ্ট্য
নিম্নলিখিত সারণী এই সম্পদে প্রদর্শিত বৈশিষ্ট্যগুলিকে সংজ্ঞায়িত করে:
| বৈশিষ্ট্য | |
|---|---|
kind | stringAPI সম্পদের ধরন সনাক্ত করে। মান হবে youtube#activity । |
etag | etagএই সম্পদের Etag. |
id | stringইউটিউব যে আইডি ব্যবহার করে তা স্বতন্ত্রভাবে অ্যাক্টিভিটি শনাক্ত করতে। |
snippet | objectsnippet অবজেক্টে অ্যাক্টিভিটির ধরন এবং গ্রুপ আইডি সহ অ্যাক্টিভিটি সম্পর্কে প্রাথমিক বিবরণ থাকে। |
snippet. publishedAt | datetimeকার্যকলাপ ঘটেছে যে তারিখ এবং সময়. মানটি ISO 8601 বিন্যাসে নির্দিষ্ট করা হয়েছে। |
snippet. channelId | stringYouTube যে আইডিটি ব্যবহার করে কার্যকলাপের সাথে যুক্ত চ্যানেলটিকে অনন্যভাবে সনাক্ত করতে। |
snippet. title | stringসম্পদের শিরোনাম প্রাথমিকভাবে কার্যকলাপের সাথে যুক্ত। |
snippet. description | stringসম্পদের বর্ণনা প্রাথমিকভাবে কার্যকলাপের সাথে যুক্ত। |
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ছবির উচ্চতা। |
snippet. channelTitle | stringএই কার্যকলাপের জন্য দায়ী চ্যানেলের জন্য চ্যানেলের শিরোনাম |
snippet. type | stringসম্পদ বর্ণনা করে কার্যকলাপের ধরন। এই সম্পত্তির জন্য বৈধ মান হল:
|
snippet. groupId | stringকার্যকলাপের সাথে যুক্ত গ্রুপ আইডি। একটি গ্রুপ আইডি ব্যবহারকারীর ইভেন্টগুলি সনাক্ত করে যা একই ব্যবহারকারী এবং সংস্থানের সাথে যুক্ত। উদাহরণস্বরূপ, যদি একজন ব্যবহারকারী একটি ভিডিওকে রেট দেয় এবং একই ভিডিওটিকে একটি প্রিয় হিসাবে চিহ্নিত করে, সেই ইভেন্টগুলির জন্য এন্ট্রিগুলির ব্যবহারকারীর কার্যকলাপ ফিডে একই গ্রুপ আইডি থাকবে৷ আপনার ইউজার ইন্টারফেসে, আপনি একই groupId মান সহ ইভেন্টগুলিকে গোষ্ঠীবদ্ধ করে পুনরাবৃত্তি এড়াতে পারেন। |
contentDetails | objectcontentDetails অবজেক্টে কার্যকলাপের সাথে সম্পর্কিত বিষয়বস্তু সম্পর্কে তথ্য রয়েছে। উদাহরণস্বরূপ, যদি snippet.type মান videoRated হয়, তাহলে contentDetails অবজেক্টের বিষয়বস্তু রেট করা ভিডিওকে শনাক্ত করে। |
contentDetails. upload | objectupload অবজেক্টে আপলোড করা ভিডিও সম্পর্কে তথ্য থাকে। snippet.type upload হলেই এই বৈশিষ্ট্যটি উপস্থিত থাকে। |
contentDetails.upload. videoId | stringইউটিউব আপলোড করা ভিডিওটিকে অনন্যভাবে শনাক্ত করতে যে আইডি ব্যবহার করে। |
contentDetails. like | objectlike অবজেক্টে এমন একটি রিসোর্স সম্পর্কে তথ্য রয়েছে যা একটি ইতিবাচক (লাইক) রেটিং পেয়েছে। এই সম্পত্তি শুধুমাত্র উপস্থিত হয় যদি snippet.type এর like হয়। |
contentDetails.like. resourceId | objectresourceId অবজেক্টে এমন তথ্য রয়েছে যা রেট করা সংস্থানকে শনাক্ত করে। |
contentDetails.like.resourceId. kind | stringAPI সম্পদের ধরন। |
contentDetails.like.resourceId. videoId | stringইউটিউব যে আইডিটি ব্যবহার করে ভিডিওটিকে অনন্যভাবে সনাক্ত করতে, যদি রেট করা সম্পদ একটি ভিডিও হয়। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#video হয়। |
contentDetails. favorite | objectfavorite বস্তুতে একটি ভিডিও সম্পর্কে তথ্য রয়েছে যা একটি প্রিয় ভিডিও হিসাবে চিহ্নিত করা হয়েছিল৷ এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি snippet.type favorite হয়। |
contentDetails.favorite. resourceId | objectresourceId অবজেক্টে এমন তথ্য রয়েছে যা পছন্দের হিসেবে চিহ্নিত করা রিসোর্সটিকে শনাক্ত করে। |
contentDetails.favorite.resourceId. kind | stringAPI সম্পদের ধরন। |
contentDetails.favorite.resourceId. videoId | stringইউটিউব যে আইডিটি ব্যবহার করে প্রিয় ভিডিওটিকে অনন্যভাবে শনাক্ত করতে। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#video হয়।দ্রষ্টব্য: activities.list পদ্ধতি বর্তমানে নতুন মন্তব্যের জন্য সম্পদ ফেরত দেয় না। |
contentDetails. comment | objectcomment বস্তুতে এমন একটি সংস্থান সম্পর্কে তথ্য রয়েছে যা একটি মন্তব্য পেয়েছে। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি snippet.type comment হয়। |
contentDetails.comment. resourceId | objectresourceId অবজেক্টে এমন তথ্য থাকে যা মন্তব্যের সাথে যুক্ত রিসোর্সকে শনাক্ত করে। |
contentDetails.comment.resourceId. kind | stringAPI সম্পদের ধরন। |
contentDetails.comment.resourceId. videoId | stringএকটি মন্তব্যের সাথে যুক্ত ভিডিওটিকে অনন্যভাবে সনাক্ত করতে YouTube ব্যবহার করে আইডি। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#video হয়। |
contentDetails.comment.resourceId. channelId | stringএকটি মন্তব্যের সাথে যুক্ত চ্যানেলটিকে অনন্যভাবে সনাক্ত করতে YouTube যে আইডি ব্যবহার করে। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#channel হয়। |
contentDetails. subscription | objectsubscription অবজেক্টে একটি চ্যানেল সম্পর্কে তথ্য রয়েছে যেটিতে একজন ব্যবহারকারী সদস্যতা নিয়েছেন। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি snippet.type subscription হয়। |
contentDetails.subscription. resourceId | objectresourceId অবজেক্টে এমন তথ্য থাকে যা ব্যবহারকারীর সদস্যতা নেওয়া সংস্থানটিকে চিহ্নিত করে। |
contentDetails.subscription.resourceId. kind | stringAPI সম্পদের ধরন। |
contentDetails.subscription.resourceId. channelId | stringব্যবহারকারীর সদস্যতা নেওয়া চ্যানেলটিকে অনন্যভাবে সনাক্ত করতে YouTube যে ID ব্যবহার করে। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#channel হয়। |
contentDetails. playlistItem | objectplaylistItem আইটেম অবজেক্টে একটি নতুন প্লেলিস্ট আইটেম সম্পর্কে তথ্য রয়েছে। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি snippet.type হয় playlistItem . |
contentDetails.playlistItem. resourceId | objectresourceId অবজেক্টে এমন তথ্য থাকে যা প্লেলিস্টে যোগ করা রিসোর্সকে শনাক্ত করে। |
contentDetails.playlistItem.resourceId. kind | stringAPI সম্পদের ধরন। |
contentDetails.playlistItem.resourceId. videoId | stringপ্লেলিস্টে যোগ করা ভিডিওটিকে অনন্যভাবে সনাক্ত করতে YouTube যে আইডি ব্যবহার করে। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#video হয়। |
contentDetails.playlistItem. playlistId | stringYouTube অনন্যভাবে প্লেলিস্ট সনাক্ত করতে যে মান ব্যবহার করে। |
contentDetails.playlistItem. playlistItemId | stringপ্লেলিস্টের আইটেমটিকে অনন্যভাবে শনাক্ত করতে YouTube ব্যবহার করে মান। |
contentDetails. recommendation | objectrecommendation বস্তুতে একটি প্রস্তাবিত সম্পদ সম্পর্কে তথ্য রয়েছে। snippet.type recommendation হলেই এই সম্পত্তিটি উপস্থিত থাকে। |
contentDetails.recommendation. resourceId | objectresourceId অবজেক্টে এমন তথ্য রয়েছে যা প্রস্তাবিত সংস্থানকে চিহ্নিত করে। |
contentDetails.recommendation.resourceId. kind | stringAPI সম্পদের ধরন। |
contentDetails.recommendation.resourceId. videoId | stringইউটিউব যে আইডিটি ব্যবহার করে ভিডিওটিকে স্বতন্ত্রভাবে সনাক্ত করতে, যদি প্রস্তাবিত সংস্থানটি একটি ভিডিও হয়। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#video হয়। |
contentDetails.recommendation.resourceId. channelId | stringইউটিউব চ্যানেলটিকে অনন্যভাবে সনাক্ত করতে যে আইডি ব্যবহার করে, যদি প্রস্তাবিত সংস্থানটি একটি চ্যানেল হয়। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#channel হয়। |
contentDetails.recommendation. reason | stringরিসোর্স ব্যবহারকারীর জন্য সুপারিশ করা হয় যে কারণ. এই সম্পত্তির জন্য বৈধ মান হল:
|
contentDetails.recommendation. seedResourceId | objectseedResourceId অবজেক্টে সেই সংস্থান সম্পর্কে তথ্য রয়েছে যা সুপারিশ করেছে। |
contentDetails.recommendation.seedResourceId. kind | stringAPI সম্পদের ধরন। |
contentDetails.recommendation.seedResourceId. videoId | stringইউটিউব যে আইডিটি ব্যবহার করে ভিডিওটিকে অনন্যভাবে শনাক্ত করতে, যদি সুপারিশটি কোনো নির্দিষ্ট ভিডিওর কারণে হয়ে থাকে। seedResourceId.kind youtube#video হলেই এই প্রপার্টিটি উপস্থিত থাকে। |
contentDetails.recommendation.seedResourceId. channelId | stringইউটিউব যে আইডিটি ব্যবহার করে চ্যানেলটিকে অনন্যভাবে শনাক্ত করতে, যদি সুপারিশটি কোনো নির্দিষ্ট চ্যানেলের কারণে হয়ে থাকে। seedResourceId.kind youtube#channel হলেই এই প্রপার্টিটি উপস্থিত থাকে। |
contentDetails.recommendation.seedResourceId. playlistId | stringইউটিউব যে আইডিটি ব্যবহার করে প্লেলিস্টকে অনন্যভাবে শনাক্ত করতে, যদি সুপারিশটি কোনো নির্দিষ্ট প্লেলিস্টের কারণে হয়ে থাকে। seedResourceId.kind youtube#playlist হলেই এই প্রপার্টিটি উপস্থিত থাকে। |
contentDetails. social | objectsocial অবজেক্টে একটি সোশ্যাল নেটওয়ার্ক পোস্টের বিশদ বিবরণ রয়েছে৷ এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি snippet.type social হয়। |
contentDetails.social. type | stringসামাজিক নেটওয়ার্কের নাম। এই সম্পত্তির জন্য বৈধ মান হল:
|
contentDetails.social. resourceId | objectresourceId অবজেক্ট তথ্যকে এনক্যাপসুলেট করে যা একটি সোশ্যাল নেটওয়ার্ক পোস্টের সাথে যুক্ত রিসোর্সকে শনাক্ত করে। |
contentDetails.social.resourceId. kind | stringAPI সম্পদের ধরন। |
contentDetails.social.resourceId. videoId | stringইউটিউব যে আইডিটি ব্যবহার করে একটি সামাজিক নেটওয়ার্ক পোস্টে বৈশিষ্ট্যযুক্ত ভিডিওটিকে অনন্যভাবে সনাক্ত করতে, যদি পোস্টটি একটি ভিডিওকে নির্দেশ করে। এই সম্পত্তি শুধুমাত্র উপস্থিত হবে যদি social.resourceId.kind সম্পত্তির মান youtube#video হয়। |
contentDetails.social.resourceId. channelId | stringএকটি সামাজিক নেটওয়ার্ক পোস্টে বৈশিষ্ট্যযুক্ত চ্যানেলটিকে অনন্যভাবে সনাক্ত করতে YouTube যে আইডি ব্যবহার করে, যদি পোস্টটি একটি চ্যানেলকে নির্দেশ করে। যদি social.resourceId.kind প্রপার্টির মান youtube#channel হয় তবেই এই প্রপার্টি উপস্থিত থাকবে। |
contentDetails.social.resourceId. playlistId | stringআইডি যেটি YouTube ব্যবহার করে একটি সোশ্যাল নেটওয়ার্ক পোস্টে বৈশিষ্ট্যযুক্ত প্লেলিস্টকে অনন্যভাবে সনাক্ত করতে, যদি পোস্টটি একটি প্লেলিস্টকে নির্দেশ করে। যদি social.resourceId.kind প্রপার্টির মান youtube#playlist হয় তবেই এই প্রপার্টি উপস্থিত হবে। |
contentDetails.social. author | stringসামাজিক নেটওয়ার্ক পোস্টের লেখক. |
contentDetails.social. referenceUrl | stringসামাজিক নেটওয়ার্ক পোস্টের URL. |
contentDetails.social. imageUrl | stringপোস্টের লেখকের একটি ছবি। |
contentDetails. channelItem | objectchannelItem অবজেক্টে একটি চ্যানেলে যোগ করা একটি সংস্থান সম্পর্কে বিশদ রয়েছে। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি snippet.type channelItem হয়। |
contentDetails.channelItem. resourceId | objectresourceId অবজেক্টে এমন তথ্য রয়েছে যা চ্যানেলে যোগ করা সংস্থানকে শনাক্ত করে। |