Videos: batchGetStats

এপিআই অনুরোধের প্যারামিটারগুলোর সাথে মেলে এমন ভিডিও পরিসংখ্যানের একটি তালিকা পুনরুদ্ধার করে।

কোটার প্রভাব: এই মেথডটি কল করার জন্য ১ ইউনিট কোটা খরচ রয়েছে।

অনুরোধ

HTTP অনুরোধ

GET https://www.googleapis.com/youtube/v3/videos:batchGetStats

অনুমোদন

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

পরিধি
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtube.readonly

প্যারামিটার

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

প্যারামিটার
প্রয়োজনীয় প্যারামিটার
id	string ` id প্যারামিটারটি পুনরুদ্ধার করা হচ্ছে এমন রিসোর্স(গুলি)র জন্য ইউটিউব ভিডিও আইডি(গুলোর) একটি কমা-দ্বারা-বিভক্ত তালিকা নির্দিষ্ট করে। একটি videoStat রিসোর্সে, ` id প্রপার্টিটি ভিডিওটির আইডি নির্দিষ্ট করে।
part	string part প্যারামিটারটি এক বা একাধিক videoStat রিসোর্স প্রপার্টির একটি কমা-বিভক্ত তালিকা নির্দিষ্ট করে, যা এপিআই (API) রেসপন্সে অন্তর্ভুক্ত থাকবে। নিম্নলিখিত তালিকায় সেই part নামগুলো রয়েছে যা আপনি প্যারামিটার ভ্যালুতে অন্তর্ভুক্ত করতে পারেন: contentDetails id snippet statistics
ঐচ্ছিক পরামিতি
onBehalfOfContentOwner	string এই প্যারামিটারটি শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যাবে। দ্রষ্টব্য: এই প্যারামিটারটি শুধুমাত্র ইউটিউব কন্টেন্ট পার্টনারদের জন্য উদ্দিষ্ট। onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে, অনুরোধের অনুমোদন ক্রেডেনশিয়ালগুলো এমন একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে, যিনি প্যারামিটার ভ্যালুতে উল্লেখিত কন্টেন্ট মালিকের পক্ষ থেকে কাজ করছেন। এই প্যারামিটারটি সেইসব YouTube কন্টেন্ট পার্টনারদের জন্য উদ্দিষ্ট, যারা বিভিন্ন YouTube চ্যানেলের মালিক এবং সেগুলো পরিচালনা করেন। এটি কন্টেন্ট মালিকদের একবার প্রমাণীকরণের মাধ্যমে তাদের সমস্ত ভিডিও এবং চ্যানেলের ডেটাতে অ্যাক্সেস পেতে সাহায্য করে, যার জন্য প্রতিটি চ্যানেলের জন্য আলাদাভাবে প্রমাণীকরণ ক্রেডেনশিয়াল প্রদান করার প্রয়োজন হয় না। ব্যবহারকারী যে CMS অ্যাকাউন্ট দিয়ে প্রমাণীকরণ করেন, সেটি অবশ্যই নির্দিষ্ট YouTube কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে।

অনুরোধকারী শরীর

এই মেথডটি কল করার সময় কোনো রিকোয়েস্ট বডি প্রদান করবেন না।

প্রতিক্রিয়া

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

{
  "kind": "youtube#batchGetStatsResponse",
  "etag": etag,
  "items": [
    {
      "kind": "youtube#videoStats",
      "etag": etag,
      "id": string,
      "snippet": {
        "publishTime": datetime
      },
      "statistics": {
        "viewCount": unsigned long,
        "likeCount": unsigned long,
        "commentCount": unsigned long
      },
      "contentDetails": {
        "duration": string,
        "durationMillis": unsigned long
      }
    }
  ],
  "summary": {
    "requestedVideoCount": unsigned long,
    "succeededVideoCount": unsigned long,
    "failedVideoCount": unsigned long,
    "failedVideoIds": [
      string
    ]
  }
}

বৈশিষ্ট্য

নিম্নলিখিত সারণিতে এই রিসোর্সে প্রদর্শিত বৈশিষ্ট্যগুলো সংজ্ঞায়িত করা হয়েছে:

বৈশিষ্ট্য
kind	string এপিআই রিসোর্সের ধরণ শনাক্ত করে। এর মান হবে youtube#batchGetStatsResponse ।
etag	etag এই রিসোর্সের ই-ট্যাগ।
items[]	list অনুরোধের শর্তের সাথে মেলে এমন ভিডিও পরিসংখ্যানের একটি তালিকা।
items[]. id	string যে আইডিটি ইউটিউব ভিডিওটিকে স্বতন্ত্রভাবে শনাক্ত করতে ব্যবহার করে।
items[].snippet. publishTime	datetime যে তারিখে ও সময়ে ভিডিওটি আপলোড করা হয়েছিল।
items[].statistics. viewCount	unsigned long ভিডিওটি যতবার দেখা হয়েছে।
items[].statistics. likeCount	unsigned long যেসব ব্যবহারকারী ভিডিওটি পছন্দ করেছেন বলে জানিয়েছেন, তাদের সংখ্যা।
items[].statistics. commentCount	unsigned long ভিডিওটির মন্তব্যের সংখ্যা।
items[].contentDetails. duration	string ভিডিওটির দৈর্ঘ্য।
items[].contentDetails. durationMillis	unsigned long ভিডিওটির দৈর্ঘ্য মিলিসেকেন্ডে।
summary	object batchGetStats অনুরোধের সারাংশ।
summary. requestedVideoCount	unsigned long অনুরোধকৃত ভিডিওর সংখ্যা।
summary. succeededVideoCount	unsigned long সফল হওয়া ভিডিওগুলোর সংখ্যা।
summary. failedVideoCount	unsigned long ব্যর্থ হওয়া ভিডিওগুলোর সংখ্যা।
summary. failedVideoIds[]	list যে ভিডিও আইডিগুলো ব্যর্থ হয়েছে।

ত্রুটি

এপিআইটি এমন কোনো ত্রুটি বার্তা সংজ্ঞায়িত করে না যা শুধুমাত্র এই এপিআই পদ্ধতির জন্য স্বতন্ত্র। তবে, এই পদ্ধতিটি ত্রুটি বার্তা ডকুমেন্টেশনে তালিকাভুক্ত সাধারণ এপিআই ত্রুটিগুলো ফেরত দিতে পারে।