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