অনুমোদিত ব্যবহারকারী নির্দিষ্ট ভিডিওর তালিকায় যে রেটিং দিয়েছেন তা ফিরিয়ে আনে।
কোটার উপর প্রভাব: এই পদ্ধতিতে কল করলে ১ ইউনিট কোটা খরচ হয়।
সাধারণ ব্যবহারিক ক্ষেত্র
অনুরোধ করুন
HTTP অনুরোধ
GET https://www.googleapis.com/youtube/v3/videos/getRating
অনুমোদন
এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির সাথে অনুমোদন প্রয়োজন (অনুমোদন ও যাচাইকরণ সম্পর্কে আরও জানুন)।
| সুযোগ |
|---|
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 |
stringid প্যারামিটারটি সেইসব রিসোর্সের জন্য কমা-দ্বারা আলাদা করা YouTube ভিডিও আইডির একটি তালিকা নির্দিষ্ট করে যার জন্য আপনি রেটিং ডেটা রিট্রিভ করছেন। video রিসোর্সে, id প্রপার্টি ভিডিওর আইডি নির্দিষ্ট করে। |
|
| ঐচ্ছিক প্যারামিটার | ||
onBehalfOfContentOwner |
stringএই প্যারামিটার শুধুমাত্র যথাযথভাবে অনুমোদিত অনুরোধে ব্যবহার করা যেতে পারে। মনে রাখবেন: এই প্যারামিটারটি শুধুমাত্র YouTube কন্টেন্ট পার্টনারদের জন্য। onBehalfOfContentOwner প্যারামিটারটি নির্দেশ করে যে অনুরোধের অনুমোদনের ক্রেডেনশিয়াল একজন YouTube CMS ব্যবহারকারীকে শনাক্ত করে যিনি প্যারামিটার ভ্যালুতে নির্দিষ্ট করা কন্টেন্টের মালিকের হয়ে কাজ করছেন। এই প্যারামিটারটি YouTube কন্টেন্ট পার্টনারদের জন্য তৈরি করা হয়েছে যারা বিভিন্ন YouTube চ্যানেল ম্যানেজ করেন। এটি কন্টেন্টের মালিকদের একবার যাচাইকরণ করার এবং প্রতিটি চ্যানেলের জন্য আলাদাভাবে যাচাইকরণ সংক্রান্ত ক্রেডেনশিয়াল প্রদান না করেই তাদের সমস্ত ভিডিও এবং চ্যানেল ডেটা অ্যাক্সেস করার অনুমতি দেয়। ব্যবহারকারী যে CMS অ্যাকাউন্ট দিয়ে যাচাইকরণ করবেন সেটি অবশ্যই নির্দিষ্ট YouTube কন্টেন্ট মালিকের সাথে লিঙ্ক করা থাকতে হবে। |
|
অনুরোধের বডি
এই মেথড কল করার সময় কোনও অনুরোধ বডি প্রদান করবেন না।
রেসপন্স
সফল হলে, এই পদ্ধতিটি নিম্নলিখিত গঠন সহ একটি রেসপন্স বডি রিটার্ন করে:
{
"kind": "youtube#videoGetRatingResponse",
"etag": etag,
"items": [
{
"videoId": string,
"rating": string
}
]
}প্রপার্টি
নিম্নলিখিত সারণীতে এই রিসোর্সে দেখানো প্রপার্টিগুলি সংজ্ঞায়িত করা হয়েছে:
| প্রপার্টি | |
|---|---|
kind |
stringAPI রিসোর্সের ধরন শনাক্ত করে। ভ্যালু হবে youtube#videoGetRatingResponse। |
etag |
etagএই রিসোর্সের Etag. |
items[] |
listঅনুরোধের মাপকাঠির সাথে ম্যাচ করা রেটিংয়ের তালিকা। |
items[].videoId |
stringভিডিওটি অনন্যভাবে শনাক্ত করার জন্য YouTube যে আইডি ব্যবহার করে। |
items[].rating |
stringঅনুমোদিত ব্যবহারকারী ভিডিওতে যে রেটিং দিয়েছেন। এই প্রপার্টির জন্য সঠিক ভ্যালু হল:
|
সমস্যা
এই API পদ্ধতিতে অনন্য কোনও সমস্যার মেসেজ API-তে উল্লেখ করা নেই। তবে, এই পদ্ধতি এখনও সমস্যার মেসেজ সংক্রান্ত ডকুমেন্টেশনে তালিকাভুক্ত সাধারণ API সমস্যা দেখাতে পারে।
এটি ব্যবহার করে দেখুন!
এই API কল করতে এবং API অনুরোধ ও উত্তর দেখতে APIs Explorer ব্যবহার করুন।