Videos: batchGetStats

API অনুরোধের প্যারামিটারের সাথে ম্যাচ করে এমন ভিডিও পরিসংখ্যানের তালিকা ফিরিয়ে আনে।

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

অনুরোধ করুন

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 প্যারামিটারটি, যে রিসোর্স ফিরিয়ে আনা হচ্ছে তার জন্য YouTube ভিডিও আইডির কমা-দ্বারা আলাদা করা তালিকা নির্দিষ্ট করে। videoStat রিসোর্সে, id প্রপার্টি ভিডিওর আইডি নির্দিষ্ট করে।
part	string part প্যারামিটার, API-এর উত্তরে অন্তর্ভুক্ত থাকবে এমন এক বা একাধিক videoStat রিসোর্স প্রপার্টির কমা-সেপারেটেড তালিকা নির্দিষ্ট করে। নিম্নলিখিত তালিকায় part নাম রয়েছে যা আপনি প্যারামিটার ভ্যালুতে অন্তর্ভুক্ত করতে পারবেন: contentDetails id snippet statistics
ঐচ্ছিক প্যারামিটার
onBehalfOfContentOwner	string এই প্যারামিটার শুধুমাত্র সঠিকভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে। 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 API রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#batchGetStatsResponse।
etag	etag এই রিসোর্সের Etag.
items[]	list ভিডিও পরিসংখ্যানের তালিকা যা অনুরোধের মাপকাঠির সাথে মেলে।
items[].id	string ভিডিওটি অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে।
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 যেসব ভিডিও আইডি কাজ করেনি।

সমস্যা

এই API পদ্ধতিতে অনন্য কোনও সমস্যার মেসেজ API-তে উল্লেখ করা নেই। তবে, এই পদ্ধতিটি এখনও সমস্যার মেসেজ সংক্রান্ত ডকুমেন্টে তালিকাভুক্ত সাধারণ API সংক্রান্ত সমস্যা দেখাতে পারে।