Activities: list

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

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

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

সাধারণ ব্যবহারের ক্ষেত্রে

অনুরোধ

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 প্যারামিটার ফলাফল সেটে একটি নির্দিষ্ট পৃষ্ঠা চিহ্নিত করে যা ফেরত দেওয়া উচিত। একটি এপিআই প্রতিক্রিয়াতে, 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 আলফা-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 কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।