Activities: list

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

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

কোটার উপর প্রভাব: এই পদ্ধতিতে কল করার জন্য ১ ইউনিট কোটা খরচ হয়।

সাধারণ ব্যবহারিক প্রয়োগ

অনুরোধ করুন

HTTP অনুরোধ

GET https://www.googleapis.com/youtube/v3/activities

প্যারামিটারগুলি

এই কোয়েরিতে যেসব প্যারামিটার কাজ করে তা নিম্নলিখিত সারণীতে দেওয়া হল। তালিকাবদ্ধ সব প্যারামিটার হল কোয়েরি প্যারামিটার।

প্যারামিটারগুলি
প্রয়োজনীয় প্যারামিটার
part	string part প্যারামিটার এক বা একাধিক activity রিসোর্স প্রপার্টির কমা দ্বারা আলাদা করা তালিকা নির্দিষ্ট করে যা API রেসপন্সে অন্তর্ভুক্ত করা হবে। প্যারামিটারটি যদি এমন কোনও প্রপার্টি শনাক্ত করে যাতে চাইল্ড প্রপার্টি আছে, তাহলে চাইল্ড প্রপার্টিগুলি রেসপন্সে অন্তর্ভুক্ত করা হবে। যেমন, activity রিসোর্সে, snippet প্রপার্টিতে অন্যান্য প্রপার্টি থাকে যা অ্যাক্টিভিটির ধরন, অ্যাক্টিভিটির ডিসপ্লে শীর্ষক এবং আরও অনেক কিছু শনাক্ত করে। আপনি part=snippet সেট করলে, API রেসপন্সেও সেইসব নেস্টেড প্রপার্টি থাকবে। নিচের তালিকায় part নাম আছে যা আপনি প্যারামিটারের মানে যোগ করতে পারবেন: contentDetails id snippet
ফিল্টার (নিম্নলিখিত প্যারামিটারগুলির মধ্যে ঠিক একটি নির্দিষ্ট করুন)
channelId	string channelId প্যারামিটারটি একটি অনন্য YouTube চ্যানেল আইডি নির্দিষ্ট করে। API তখন সেই চ্যানেলের অ্যাক্টিভিটির একটি তালিকা রিটার্ন করবে।
home	boolean মনে রাখবেন: এই প্যারামিটারটি বাতিল করা হয়েছে। এই প্যারামিটার সেট করে এমন অনুরোধের জন্য, API রেসপন্সে এমন আইটেম থাকে যা লগ-আউট করা ব্যবহারকারী YouTube হোম পেজে দেখতে পাবেন। মনে রাখবেন যে এই প্যারামিটারটি শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে।
mine	boolean এই প্যারামিটার শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। যাচাইকৃত ব্যবহারকারীর অ্যাক্টিভিটির ফিড পেতে এই প্যারামিটারের ভ্যালু true হিসেবে সেট করুন।
ঐচ্ছিক প্যারামিটার
maxResults	unsigned integer maxResults প্যারামিটারটি ফলাফলের সেটে সর্বাধিক কতগুলি আইটেম রিটার্ন করা উচিত তা নির্দিষ্ট করে। গ্রহণযোগ্য ভ্যালু হল 0 থেকে 50, অন্তর্ভুক্ত। ডিফল্ট ভ্যালু হল 5।
pageToken	string pageToken প্যারামিটারটি ফলাফল সেটের একটি নির্দিষ্ট পৃষ্ঠা শনাক্ত করে যা ফেরত দেওয়া উচিত। API রেসপন্সে, nextPageToken এবং prevPageToken প্রপার্টি অন্যান্য পৃষ্ঠা শনাক্ত করে যা ফিরিয়ে আনা যেতে পারে।
publishedAfter	datetime publishedAfter প্যারামিটারটি সবচেয়ে আগের তারিখ ও সময় নির্দিষ্ট করে, যাতে সেই অ্যাক্টিভিটি API রেসপন্সে অন্তর্ভুক্ত করা যায়। প্যারামিটারের ভ্যালু যদি কোনও দিন নির্দিষ্ট করে, কিন্তু কোনও সময় নির্দিষ্ট না করে, তাহলে সেই দিনে হওয়া যেকোনও অ্যাক্টিভিটি ফলাফল সেটে অন্তর্ভুক্ত করা হবে। মানটি ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) ফর্ম্যাটে নির্দিষ্ট করা আছে।
publishedBefore	datetime publishedBefore প্যারামিটারটি তারিখ ও সময় নির্দিষ্ট করে, যার আগে কোনও অ্যাক্টিভিটি অবশ্যই হতে হবে, যাতে সেই অ্যাক্টিভিটি API উত্তরের মধ্যে অন্তর্ভুক্ত করা যায়। প্যারামিটারের মান যদি কোনও দিন নির্দিষ্ট করে, কিন্তু কোনও সময় নয়, তাহলে সেই দিনে হওয়া যেকোনও অ্যাক্টিভিটি ফলাফল সেট থেকে বাদ দেওয়া হবে। মানটি ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) ফর্ম্যাটে নির্দিষ্ট করা আছে।
regionCode	string regionCode প্যারামিটার API-কে নির্দিষ্ট দেশের জন্য ফলাফল দেখানোর নির্দেশ দেয়। প্যারামিটারের মান হল ISO 3166-1 alpha-2 দেশের কোড। YouTube-এ অনুমোদিত ব্যবহারকারীর আগের অ্যাক্টিভিটি থেকে অ্যাক্টিভিটি ফিড তৈরি করার জন্য পর্যাপ্ত তথ্য না পাওয়া গেলে, YouTube এই ভ্যালু ব্যবহার করে।

অনুরোধের বডি

এই পদ্ধতি কল করার সময় অনুরোধের বডি প্রদান করবেন না।

রেসপন্স

সফল হলে, এই পদ্ধতিটি নিম্নলিখিত গঠন সহ একটি রেসপন্স বডি রিটার্ন করে:

{
  "kind": "youtube#activityListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    activity Resource
  ]
}

প্রপার্টি

এই রিসোর্সে যেসব প্রপার্টি দেখা যায়, নিম্নলিখিত সারণীতে সেগুলি সম্পর্কে বলা হয়েছে:

প্রপার্টি
kind	string API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু youtube#activityListResponse হবে।
etag	etag এই রিসোর্সের Etag.
nextPageToken	string ফলাফলের সেটে পরবর্তী পৃষ্ঠাটি পেতে pageToken প্যারামিটারের ভ্যালু হিসেবে ব্যবহার করা যেতে পারে এমন টোকেন।
prevPageToken	string ফলাফলের সেটে আগের পৃষ্ঠা ফিরিয়ে আনতে pageToken প্যারামিটারের ভ্যালু হিসেবে যে টোকেন ব্যবহার করা যেতে পারে।
pageInfo	object pageInfo অবজেক্টটি ফলাফল সেটের জন্য পেজিং তথ্য এনক্যাপসুলেট করে।
pageInfo.totalResults	integer ফলাফলের সেটে ফলাফলের মোট সংখ্যা।
pageInfo.resultsPerPage	integer API রেসপন্সে অন্তর্ভুক্ত ফলাফলের সংখ্যা।
items[]	list অনুরোধের মানদণ্ড পূরণ করে এমন অ্যাক্টিভিটি বা ইভেন্টের তালিকা।

সমস্যা

এই পদ্ধতিতে কল করার উত্তরে API যেসব সমস্যার মেসেজ পাঠাতে পারে, তা নিম্নলিখিত টেবিলে শনাক্ত করা হয়েছে। আরও বিবরণের জন্য সমস্যার মেসেজ সংক্রান্ত ডকুমেন্টেশন দেখুন।

সমস্যার ধরন	সমস্যার বিবরণ	বিবরণ
forbidden (403)	forbidden	অনুরোধটি সঠিকভাবে অনুমোদিত নয়।
forbidden (403)	homeParameterDeprecated	এই API-এর মাধ্যমে ব্যবহারকারীর হোম পেজ অ্যাক্টিভিটি ডেটা উপলভ্য নয়। অননুমোদিত অনুরোধে আপনি home প্যারামিটার true-এ সেট করলে এই সমস্যা হতে পারে।
notFound (404)	channelNotFound	অনুরোধের channelId প্যারামিটার দ্বারা শনাক্ত করা চ্যানেল আইডি খুঁজে পাওয়া যায়নি।
notFound (404)	homeChannelNotFound	বর্তমানে যাচাই করা ব্যবহারকারীর জন্য YouTube হোমপেজ ফিড খুঁজে পাওয়া যাচ্ছে না।
unauthorized (401)	authorizationRequired	অনুরোধে home প্যারামিটার ব্যবহার করা হয়েছে, তবে এটি সঠিকভাবে অনুমোদিত নয়।

এটি ব্যবহার করে দেখুন!

এই API কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।