Activities

YouTube চ্যানেল বুলেটিন বৈশিষ্ট্যটি বাতিল করেছে activities.list পদ্ধতি এখনও চ্যানেল বুলেটিন ফেরত দেয় না, এবং activities.insert পদ্ধতি আর সমর্থিত নয়। আরও বিশদ বিবরণের জন্য, অনুগ্রহ করে YouTube সহায়তা কেন্দ্র দেখুন৷

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

পদ্ধতি

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

list
অনুরোধের মানদণ্ডের সাথে মেলে এমন চ্যানেল কার্যকলাপের একটি তালিকা প্রদান করে। উদাহরণস্বরূপ, আপনি একটি নির্দিষ্ট চ্যানেল বা ব্যবহারকারীর নিজস্ব চ্যানেলের সাথে সম্পর্কিত ইভেন্টগুলি পুনরুদ্ধার করতে পারেন৷ এখনই চেষ্টা করে দেখুন

activities.insert পদ্ধতি আর সমর্থিত নয়।

সম্পদ প্রতিনিধিত্ব

নিম্নলিখিত 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 string
API সম্পদের ধরন সনাক্ত করে। মান হবে youtube#activity
etag etag
এই সম্পদের Etag.
id string
ইউটিউব যে আইডি ব্যবহার করে তা স্বতন্ত্রভাবে অ্যাক্টিভিটি শনাক্ত করতে।
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 - ডিফল্ট থাম্বনেইল চিত্র। একটি ভিডিওর জন্য ডিফল্ট থাম্বনেইল - বা একটি সংস্থান যা একটি ভিডিওকে বোঝায়, যেমন একটি প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল - 120px চওড়া এবং 90px লম্বা। একটি চ্যানেলের জন্য ডিফল্ট থাম্বনেইল 88px চওড়া এবং 88px লম্বা।
  • medium - থাম্বনেইল ছবির একটি উচ্চ রেজোলিউশন সংস্করণ। একটি ভিডিওর জন্য (বা একটি সম্পদ যা একটি ভিডিওকে বোঝায়), এই ছবিটি 320px চওড়া এবং 180px লম্বা। একটি চ্যানেলের জন্য, এই ছবিটি 240px চওড়া এবং 240px লম্বা৷
  • high - থাম্বনেইল ছবির একটি উচ্চ রেজোলিউশন সংস্করণ। একটি ভিডিওর জন্য (বা একটি সম্পদ যা একটি ভিডিওকে নির্দেশ করে), এই ছবিটি 480px চওড়া এবং 360px লম্বা। একটি চ্যানেলের জন্য, এই চিত্রটি 800px চওড়া এবং 800px লম্বা৷
  • standard - high রেজোলিউশনের ছবির চেয়ে থাম্বনেল ছবির একটি এমনকি উচ্চ রেজোলিউশন সংস্করণ। এই চিত্রটি কিছু ভিডিও এবং অন্যান্য সংস্থানগুলির জন্য উপলব্ধ যা ভিডিওগুলিকে উল্লেখ করে, যেমন প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল৷ এই ছবিটি 640px চওড়া এবং 480px লম্বা৷
  • maxres - থাম্বনেইল ছবির সর্বোচ্চ রেজোলিউশন সংস্করণ। এই চিত্রের আকার কিছু ভিডিও এবং অন্যান্য সংস্থানগুলির জন্য উপলব্ধ যা ভিডিওগুলিকে উল্লেখ করে, যেমন প্লেলিস্ট আইটেম বা অনুসন্ধান ফলাফল৷ এই ছবিটি 1280px চওড়া এবং 720px লম্বা৷
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 - (বর্তমানে ফেরত দেওয়া হয়নি)
  • favorite
  • like
  • playlistItem
  • promotedItem
  • recommendation
  • social
  • subscription
  • upload
  • bulletin (বঞ্চিত)
snippet. groupId string
কার্যকলাপের সাথে যুক্ত গ্রুপ আইডি। একটি গ্রুপ আইডি ব্যবহারকারীর ইভেন্টগুলি সনাক্ত করে যা একই ব্যবহারকারী এবং সংস্থানের সাথে যুক্ত। উদাহরণস্বরূপ, যদি একজন ব্যবহারকারী একটি ভিডিওকে রেট দেয় এবং একই ভিডিওটিকে একটি প্রিয় হিসাবে চিহ্নিত করে, সেই ইভেন্টগুলির জন্য এন্ট্রিগুলির ব্যবহারকারীর কার্যকলাপ ফিডে একই গ্রুপ আইডি থাকবে৷ আপনার ইউজার ইন্টারফেসে, আপনি একই groupId মান সহ ইভেন্টগুলিকে গোষ্ঠীবদ্ধ করে পুনরাবৃত্তি এড়াতে পারেন।
contentDetails object
contentDetails অবজেক্টে কার্যকলাপের সাথে সম্পর্কিত বিষয়বস্তু সম্পর্কে তথ্য রয়েছে। উদাহরণস্বরূপ, যদি snippet.type মান videoRated হয়, তাহলে contentDetails অবজেক্টের বিষয়বস্তু রেট করা ভিডিওকে শনাক্ত করে।
contentDetails. upload object
upload অবজেক্টে আপলোড করা ভিডিও সম্পর্কে তথ্য থাকে। snippet.type upload হলেই এই বৈশিষ্ট্যটি উপস্থিত থাকে।
contentDetails.upload. videoId string
ইউটিউব আপলোড করা ভিডিওটিকে অনন্যভাবে শনাক্ত করতে যে আইডি ব্যবহার করে।
contentDetails. like object
like অবজেক্টে এমন একটি রিসোর্স সম্পর্কে তথ্য রয়েছে যা একটি ইতিবাচক (লাইক) রেটিং পেয়েছে। এই সম্পত্তি শুধুমাত্র উপস্থিত হয় যদি snippet.type like হয়।
contentDetails.like. resourceId object
resourceId অবজেক্টে এমন তথ্য রয়েছে যা রেট করা সংস্থানকে শনাক্ত করে।
contentDetails.like.resourceId. kind string
API সম্পদের ধরন।
contentDetails.like.resourceId. videoId string
ইউটিউব যে আইডিটি ব্যবহার করে ভিডিওটিকে অনন্যভাবে সনাক্ত করতে, যদি রেট করা সম্পদ একটি ভিডিও হয়। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#video হয়।
contentDetails. favorite object
favorite বস্তুতে একটি ভিডিও সম্পর্কে তথ্য রয়েছে যা একটি প্রিয় ভিডিও হিসাবে চিহ্নিত করা হয়েছিল৷ এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি snippet.type favorite হয়।
contentDetails.favorite. resourceId object
resourceId অবজেক্টে এমন তথ্য রয়েছে যা পছন্দের হিসেবে চিহ্নিত করা রিসোর্সটিকে শনাক্ত করে।
contentDetails.favorite.resourceId. kind string
API সম্পদের ধরন।
contentDetails.favorite.resourceId. videoId string
ইউটিউব যে আইডিটি ব্যবহার করে প্রিয় ভিডিওটিকে অনন্যভাবে শনাক্ত করতে। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#video হয়।

দ্রষ্টব্য: activities.list পদ্ধতি বর্তমানে নতুন মন্তব্যের জন্য সম্পদ ফেরত দেয় না।
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 যে ID ব্যবহার করে। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#channel হয়।
contentDetails. playlistItem object
playlistItem আইটেম অবজেক্টে একটি নতুন প্লেলিস্ট আইটেম সম্পর্কে তথ্য রয়েছে। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি snippet.type হয় playlistItem .
contentDetails.playlistItem. resourceId object
resourceId অবজেক্টে এমন তথ্য থাকে যা প্লেলিস্টে যোগ করা রিসোর্সকে শনাক্ত করে।
contentDetails.playlistItem.resourceId. kind string
API সম্পদের ধরন।
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
API সম্পদের ধরন।
contentDetails.recommendation.resourceId. videoId string
ইউটিউব যে আইডিটি ব্যবহার করে ভিডিওটিকে অনন্যভাবে সনাক্ত করতে, যদি প্রস্তাবিত সংস্থানটি একটি ভিডিও হয়। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#video হয়।
contentDetails.recommendation.resourceId. channelId string
ইউটিউব চ্যানেলটিকে অনন্যভাবে সনাক্ত করতে যে আইডি ব্যবহার করে, যদি প্রস্তাবিত সংস্থানটি একটি চ্যানেল হয়। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি resourceId.kind youtube#channel হয়।
contentDetails.recommendation. reason string
রিসোর্স ব্যবহারকারীর জন্য সুপারিশ করা হয় যে কারণ.

এই সম্পত্তির জন্য বৈধ মান হল:
  • videoFavorited
  • videoLiked
  • videoWatched
contentDetails.recommendation. seedResourceId object
seedResourceId অবজেক্টে সেই সংস্থান সম্পর্কে তথ্য রয়েছে যা সুপারিশ করেছে।
contentDetails.recommendation.seedResourceId. kind string
API সম্পদের ধরন।
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
API সম্পদের ধরন।
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 object
channelItem অবজেক্টে একটি চ্যানেলে যোগ করা একটি সংস্থান সম্পর্কে বিশদ রয়েছে। এই সম্পত্তি শুধুমাত্র উপস্থিত থাকে যদি snippet.type channelItem হয়।
contentDetails.channelItem. resourceId object
resourceId অবজেক্টে এমন তথ্য রয়েছে যা চ্যানেলে যোগ করা সংস্থানকে শনাক্ত করে।