Activities

activity রিসোর্সে কোনও নির্দিষ্ট চ্যানেল বা ব্যবহারকারীর YouTube-এ করা অ্যাকশন সম্পর্কে তথ্য থাকে। অ্যাক্টিভিটি ফিডে রিপোর্ট করা অ্যাকশনের মধ্যে রয়েছে ভিডিও শেয়ার করা, ভিডিও আপলোড করা ইত্যাদি। প্রতিটি activity রিসোর্স অ্যাকশনের ধরন, অ্যাকশনের সাথে যুক্ত চ্যানেল এবং অ্যাকশনের সাথে যুক্ত রিসোর্স শনাক্ত করে, যেমন রেট করা বা আপলোড করা ভিডিও।

পদ্ধতি

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

তালিকা

অনুরোধের মাপকাঠির সাথে মিলে যাওয়া চ্যানেল অ্যাক্টিভিটি ইভেন্টের তালিকা রিটার্ন করে। যেমন, আপনি কোনও নির্দিষ্ট চ্যানেল বা ব্যবহারকারীর নিজের চ্যানেলের সাথে যুক্ত ইভেন্ট পুনরুদ্ধার করতে পারবেন। এখনই এটি ব্যবহার করে দেখুন।

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

নিচে দেওয়া 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
    },
    "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	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#activity।
etag	etag এই রিসোর্সের Etag.
id	string অ্যাক্টিভিটি অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে।
snippet	object snippet অবজেক্টে অ্যাক্টিভিটির ধরন ও গ্রুপ আইডি সহ অ্যাক্টিভিটি সম্পর্কিত প্রাথমিক বিবরণ থাকে।
snippet.publishedAt	datetime অ্যাক্টিভিটি হওয়ার তারিখ ও সময়। ভ্যালু ISO 8601 ফর্ম্যাটে উল্লেখ করা হয়েছে।
snippet.channelId	string অ্যাক্টিভিটির সাথে যুক্ত চ্যানেলকে অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে।
snippet.title	string অ্যাক্টিভিটির সাথে প্রাথমিকভাবে যুক্ত রিসোর্সের শীর্ষক।
snippet.description	string অ্যাক্টিভিটির সাথে প্রাথমিকভাবে যুক্ত রিসোর্সের বিবরণ।
snippet.thumbnails	object অ্যাক্টিভিটির সাথে প্রাথমিকভাবে যুক্ত রিসোর্সের সাথে সম্পর্কিত থাম্বনেল ছবির ম্যাপ। ম্যাপের প্রতিটি অবজেক্টের জন্য, 'কী' হল থাম্বনেল ছবির নাম এবং 'ভ্যালু' হল এমন একটি অবজেক্ট যাতে থাম্বনেল সম্পর্কে অন্যান্য তথ্য থাকে।
snippet.thumbnails.(key)	object সঠিক কী ভ্যালু হল: default – ডিফল্ট থাম্বনেল ছবি। ভিডিওর ডিফল্ট থাম্বনেল – অথবা প্লেলিস্ট আইটেম বা সার্চ ফলাফলের মতো ভিডিওর রেফারেন্স দেয় এমন রিসোর্স – ১২০ পিক্সেল চওড়া এবং ৯০ পিক্সেল লম্বা হয়। কোনও চ্যানেলের ডিফল্ট থাম্বনেল ৮৮ পিক্সেল চওড়া ও ৮৮ পিক্সেল লম্বা হয়। medium – থাম্বনেল ছবির আরও উন্নত রেজোলিউশন ভার্সন। ভিডিওর (বা ভিডিওর রেফারেন্স থাকা রিসোর্সের) ক্ষেত্রে, এই ছবির প্রস্থ ৩২০ পিক্সেল এবং উচ্চতা ১৮০ পিক্সেল। কোনও চ্যানেলের জন্য এই ছবিটি ২৪০ পিক্সেল চওড়া ও ২৪০ পিক্সেল লম্বা হয়। high – থাম্বনেল ছবির হাই রেজোলিউশন ভার্সন। ভিডিওর (বা ভিডিওর রেফারেন্স থাকা রিসোর্সের) ক্ষেত্রে, এই ছবির প্রস্থ ৪৮০ পিক্সেল এবং উচ্চতা ৩৬০ পিক্সেল। চ্যানেলের ক্ষেত্রে, এই ছবি ৮০০ পিক্সেল চওড়া ও ৮০০ পিক্সেল লম্বা হয়। standard – high রেজোলিউশনের ছবির চেয়েও আরও বেশি রেজোলিউশনের থাম্বনেল ছবি। এই ছবি কিছু ভিডিও এবং ভিডিওর সাথে সম্পর্কিত অন্যান্য রিসোর্সের জন্য উপলভ্য, যেমন প্লেলিস্ট আইটেম বা সার্চ ফলাফল। এই ছবিটি ৬৪০ পিক্সেল চওড়া এবং ৪৮০ পিক্সেল লম্বা। maxres – থাম্বনেল ছবির হাই রেজোলিউশন ভার্সন। এই ছবির সাইজ কিছু ভিডিও এবং ভিডিওর রেফারেন্স দেয় এমন অন্যান্য রিসোর্সের জন্য উপলভ্য, যেমন প্লেলিস্ট আইটেম বা সার্চ ফলাফল। এই ছবি ১২৮০ পিক্সেল চওড়া এবং ৭২০ পিক্সেল লম্বা। fhd – থাম্বনেল ছবির সম্পূর্ণ হাই ডেফিনেশন (1080p) ভার্সন। এই ছবির সাইজ কিছু ভিডিওর জন্য উপলভ্য। এই ছবিটি ১৯২০ পিক্সেল চওড়া এবং ১০৮০ পিক্সেল লম্বা। qhd – থাম্বনেল ছবির কোয়াড হাই ডেফিনেশন (1440p / 2K) ভার্সন। এই ছবির সাইজ কিছু ভিডিওর জন্য উপলভ্য। এই ছবিটি ২৫৬০ পিক্সেল চওড়া ও ১৪৪০ পিক্সেল লম্বা। uhd – থাম্বনেল ছবির আল্ট্রা-হাই রেজোলিউশন (4K) ভার্সন। এই ছবির সাইজ কিছু ভিডিওর জন্য উপলভ্য। এই ছবিটি ৩৮৪০ পিক্সেল চওড়া এবং ২১৬০ পিক্সেল লম্বা।
snippet.thumbnails.(key).url	string ছবির URL.
snippet.thumbnails.(key).width	unsigned integer ছবির প্রস্থ।
snippet.thumbnails.(key).height	unsigned integer ছবির উচ্চতা।
snippet.channelTitle	string এই অ্যাক্টিভিটির জন্য দায়ী চ্যানেলের নাম
snippet.type	string রিসোর্স যে ধরনের অ্যাক্টিভিটি বর্ণনা করে। এই প্রপার্টির জন্য সঠিক ভ্যালু হল: channelItem comment – (বর্তমানে ফেরত দেওয়া হয়নি) playlistItem promotedItem recommendation social subscription upload
snippet.groupId	string অ্যাক্টিভিটির সাথে যুক্ত গ্রুপ আইডি। গ্রুপ আইডি একই ব্যবহারকারী ও রিসোর্সের সাথে সম্পর্কিত ব্যবহারকারীর ইভেন্ট শনাক্ত করে। যেমন, কোনও ব্যবহারকারী ভিডিও আপলোড করে সেটি দেখলে, ব্যবহারকারীর অ্যাক্টিভিটি ফিডে সেইসব ইভেন্টের এন্ট্রিতে একই গ্রুপ আইডি থাকবে। আপনার ইউজার ইন্টারফেসে, একই groupId ভ্যালু সহ ইভেন্টগুলি গ্রুপ করে আপনি পুনরাবৃত্তি এড়াতে পারেন।
contentDetails	object contentDetails অবজেক্টে অ্যাক্টিভিটির সাথে যুক্ত কন্টেন্ট সম্পর্কে তথ্য থাকে। যেমন, snippet.type-এর ভ্যালু videoRated হলে, contentDetails অবজেক্টের কন্টেন্ট রেটিং দেওয়া ভিডিও শনাক্ত করে।
contentDetails.upload	object upload অবজেক্টে আপলোড করা ভিডিও সম্পর্কে তথ্য থাকে। snippet.type যদি upload হয়, তবেই এই প্রপার্টি থাকে।
contentDetails.upload.videoId	string আপলোড করা ভিডিওকে অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে।
contentDetails.comment	object comment অবজেক্টে এমন রিসোর্স সম্পর্কে তথ্য থাকে যাতে কমেন্ট করা হয়েছে। snippet.type comment হলে তবেই এই প্রপার্টি থাকে।
contentDetails.comment.resourceId	object resourceId অবজেক্টে এমন তথ্য থাকে যা কমেন্টের সাথে যুক্ত রিসোর্স শনাক্ত করে।
contentDetails.comment.resourceId.kind	string API রিসোর্সের ধরন।
contentDetails.comment.resourceId.videoId	string কমেন্টের সাথে যুক্ত ভিডিওকে অনন্যভাবে শনাক্ত করতে YouTube যে আইডি ব্যবহার করে। resourceId.kind যদি youtube#video হয়, তবেই এই প্রপার্টি থাকে।
contentDetails.comment.resourceId.channelId	string কোনও কমেন্টের সাথে যুক্ত চ্যানেলকে অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে। resourceId.kind youtube#channel হলে তবেই এই প্রপার্টি থাকে।
contentDetails.subscription	object subscription অবজেক্টে ব্যবহারকারীর সাবস্ক্রাইব করা চ্যানেল সম্পর্কে তথ্য থাকে। শুধুমাত্র সর্বজনীন সাবস্ক্রিপশন ফেরত দেওয়া হয়। snippet.type যদি subscription হয়, তবেই এই প্রপার্টি থাকে।
contentDetails.subscription.resourceId	object resourceId অবজেক্টে এমন তথ্য থাকে যা ব্যবহারকারীর সাবস্ক্রাইব করা রিসোর্সকে শনাক্ত করে।
contentDetails.subscription.resourceId.kind	string API রিসোর্সের ধরন।
contentDetails.subscription.resourceId.channelId	string ব্যবহারকারী সাবস্ক্রাইব করেছেন এমন চ্যানেলকে অনন্যভাবে শনাক্ত করতে YouTube যে আইডি ব্যবহার করে। resourceId.kind যদি youtube#channel হয়, তবেই এই প্রপার্টি থাকে।
contentDetails.playlistItem	object playlistItem অবজেক্টে নতুন প্লেলিস্ট আইটেম সম্পর্কে তথ্য থাকে। snippet.type যদি playlistItem হয়, তবেই এই প্রপার্টি থাকে।
contentDetails.playlistItem.resourceId	object resourceId অবজেক্টে এমন তথ্য থাকে যা প্লেলিস্টে যোগ করা রিসোর্সকে শনাক্ত করে।
contentDetails.playlistItem.resourceId.kind	string এপিআই রিসোর্সের ধরন।
contentDetails.playlistItem.resourceId.videoId	string প্লেলিস্টে যোগ করা ভিডিওকে অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে। resourceId.kind youtube#video হলে তবেই এই প্রপার্টি থাকে।
contentDetails.playlistItem.playlistId	string প্লেলিস্ট অনন্যভাবে শনাক্ত করার জন্য YouTube যে ভ্যালু ব্যবহার করে।
contentDetails.playlistItem.playlistItemId	string প্লেলিস্টে আইটেমটি অনন্যভাবে শনাক্ত করার জন্য YouTube যে মান ব্যবহার করে।
contentDetails.recommendation	object recommendation অবজেক্টে সাজেস্ট করা রিসোর্স সম্পর্কে তথ্য থাকে। snippet.type যদি recommendation হয়, তবেই এই প্রপার্টি থাকে।
contentDetails.recommendation.resourceId	object resourceId অবজেক্টে সাজেস্ট করা রিসোর্স শনাক্ত করার তথ্য থাকে।
contentDetails.recommendation.resourceId.kind	string এপিআই রিসোর্সের ধরন।
contentDetails.recommendation.resourceId.videoId	string সাজেস্ট করা রিসোর্স ভিডিও হলে, YouTube ভিডিওটিকে অনন্যভাবে শনাক্ত করতে যে আইডি ব্যবহার করে। resourceId.kind youtube#video হলে তবেই এই প্রপার্টি থাকে।
contentDetails.recommendation.resourceId.channelId	string সাজেস্ট করা রিসোর্স চ্যানেল হলে, YouTube চ্যানেলটিকে অনন্যভাবে শনাক্ত করতে যে আইডি ব্যবহার করে। resourceId.kind যদি youtube#channel হয়, তবেই এই প্রপার্টি থাকে।
contentDetails.recommendation.reason	string ব্যবহারকারীকে রিসোর্স সাজেস্ট করার কারণ। এই প্রপার্টির জন্য সঠিক ভ্যালু হল: videoWatched
contentDetails.recommendation.seedResourceId	object seedResourceId অবজেক্টে সেই রিসোর্স সম্পর্কে তথ্য থাকে যার জন্য সাজেশন দেওয়া হয়েছে।
contentDetails.recommendation.seedResourceId.kind	string API রিসোর্সের ধরন।
contentDetails.recommendation.seedResourceId.videoId	string কোনও নির্দিষ্ট ভিডিওর কারণে সাজেশন দেখানো হলে, YouTube যে আইডির মাধ্যমে অনন্যভাবে ভিডিওটি শনাক্ত করে। seedResourceId.kind youtube#video হলে তবেই এই প্রপার্টি থাকে।
contentDetails.recommendation.seedResourceId.channelId	string সাজেশনটি কোনও নির্দিষ্ট চ্যানেলের কারণে হলে, YouTube যে আইডি ব্যবহার করে অনন্যভাবে চ্যানেলটি শনাক্ত করে। seedResourceId.kind youtube#channel হলে তবেই এই প্রপার্টি থাকে।
contentDetails.recommendation.seedResourceId.playlistId	string সাজেশনটি কোনও নির্দিষ্ট প্লেলিস্টের কারণে হলে, YouTube যে আইডি ব্যবহার করে অনন্যভাবে প্লেলিস্টটি শনাক্ত করে। seedResourceId.kind যদি youtube#playlist হয়, তবেই এই প্রপার্টি থাকে।
contentDetails.social	object social অবজেক্টে সোশ্যাল নেটওয়ার্ক পোস্ট সম্পর্কে বিবরণ থাকে। snippet.type যদি social হয়, তবেই এই প্রপার্টি থাকে।
contentDetails.social.type	string সোশ্যাল নেটওয়ার্কের নাম। এই প্রপার্টির জন্য সঠিক ভ্যালু হল: facebook googlePlus twitter unspecified
contentDetails.social.resourceId	object resourceId অবজেক্টটি সোশ্যাল নেটওয়ার্ক পোস্টের সাথে যুক্ত রিসোর্স শনাক্ত করার তথ্য এনক্যাপসুলেট করে।
contentDetails.social.resourceId.kind	string এপিআই রিসোর্সের ধরন।
contentDetails.social.resourceId.videoId	string সোশ্যাল নেটওয়ার্ক পোস্টে ফিচার করা ভিডিওকে অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে, যদি পোস্টটি কোনও ভিডিওকে রেফার করে। 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	object channelItem অবজেক্টে চ্যানেলে যোগ করা রিসোর্স সম্পর্কে বিবরণ থাকে। snippet.type যদি channelItem হয়, তবেই এই প্রপার্টি থাকে।
contentDetails.channelItem.resourceId	object resourceId অবজেক্টে এমন তথ্য থাকে যা চ্যানেলে যোগ করা রিসোর্স শনাক্ত করে।