একটি ভিডিওতে একটি পছন্দ বা অপছন্দ রেটিং যোগ করুন বা একটি ভিডিও থেকে একটি রেটিং সরান৷
কোটা প্রভাব: এই পদ্ধতিতে একটি কলের কোটা খরচ 50 ইউনিট।
দ্রষ্টব্য: এটি ভিডিওটির অফিসিয়াল লাইক/অপছন্দের সংখ্যাকে প্রভাবিত করে না।
সাধারণ ব্যবহারের ক্ষেত্রে
অনুরোধ
HTTP অনুরোধ
POST https://www.googleapis.com/youtube/v3/videos/rate
অনুমোদন
এই অনুরোধের জন্য নিম্নলিখিত স্কোপের মধ্যে অন্তত একটির অনুমোদন প্রয়োজন ( প্রমাণিকরণ এবং অনুমোদন সম্পর্কে আরও পড়ুন )।
ব্যাপ্তি |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
পরামিতি
নিম্নলিখিত সারণীতে এই ক্যোয়ারী সমর্থন করে এমন প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে৷ তালিকাভুক্ত সমস্ত প্যারামিটার হল ক্যোয়ারী প্যারামিটার।
পরামিতি | ||
---|---|---|
প্রয়োজনীয় পরামিতি | ||
id | string id প্যারামিটারটি সেই ভিডিওটির YouTube ভিডিও আইডি নির্দিষ্ট করে যেটিকে রেট দেওয়া হচ্ছে বা এর রেটিং সরানো হচ্ছে৷ | |
rating | string রেকর্ড করার জন্য রেটিং নির্দিষ্ট করে। গ্রহণযোগ্য মান হল:
|
শরীরের অনুরোধ
এই পদ্ধতিতে কল করার সময় একটি অনুরোধের অংশ প্রদান করবেন না।
প্রতিক্রিয়া
সফল হলে, এই পদ্ধতিটি একটি HTTP 204
প্রতিক্রিয়া কোড প্রদান করে ( No Content
)।
ত্রুটি
নিম্নলিখিত সারণী ত্রুটি বার্তাগুলি সনাক্ত করে যা API এই পদ্ধতিতে একটি কলের প্রতিক্রিয়া হিসাবে ফিরে আসতে পারে৷ আরো বিস্তারিত জানার জন্য ত্রুটি বার্তা ডকুমেন্টেশন দেখুন.
ত্রুটির ধরন | ত্রুটি বিস্তারিত | বর্ণনা |
---|---|---|
badRequest (400) | emailNotVerified | রেটিং দেওয়ার আগে ব্যবহারকারীকে অবশ্যই তাদের ই-মেইল ঠিকানা যাচাই করতে হবে। |
badRequest (400) | invalidRating | অনুরোধে rating প্যারামিটারের জন্য একটি অপ্রত্যাশিত মান রয়েছে৷ |
badRequest (400) | videoPurchaseRequired | ভাড়া করা ভিডিওগুলি শুধুমাত্র সেই ব্যবহারকারীদের দ্বারা রেট করা যেতে পারে যারা সেগুলি ভাড়া করেছে৷ |
forbidden (403) | forbidden | আপনি যে ভিডিওটিকে রেট দেওয়ার চেষ্টা করছেন সেটিকে রেট দেওয়া যাবে না৷ অনুরোধ সঠিকভাবে অনুমোদিত নাও হতে পারে. |
forbidden (403) | videoRatingDisabled | আপনি যে ভিডিওটিকে রেট দেওয়ার চেষ্টা করছেন তার মালিক সেই ভিডিওটির জন্য রেটিং অক্ষম করেছে৷ |
notFound (404) | videoNotFound | আপনি রেট করার চেষ্টা করছেন যে ভিডিও খুঁজে পাওয়া যাবে না. অনুরোধের id প্যারামিটারের মান পরীক্ষা করে নিশ্চিত করুন যে এটি সঠিক। |
এটা চেষ্টা করুন!
এই API কল করতে APIs Explorer ব্যবহার করুন এবং API অনুরোধ এবং প্রতিক্রিয়া দেখুন।