Activities

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

পদ্ধতি

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