Videos: rate

একটি ভিডিওতে একটি পছন্দ বা অপছন্দ রেটিং যোগ করুন বা একটি ভিডিও থেকে একটি রেটিং সরান৷

কোটা প্রভাব: এই পদ্ধতিতে একটি কলের কোটা খরচ 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
রেকর্ড করার জন্য রেটিং নির্দিষ্ট করে।

গ্রহণযোগ্য মান হল:
  • dislike - প্রমাণীকৃত ব্যবহারকারী ভিডিওটি অপছন্দ করেছেন এমন রেকর্ড।
  • like - প্রমাণীকৃত ব্যবহারকারী ভিডিওটি পছন্দ করেছে এমন রেকর্ড।
  • none - প্রমাণীকৃত ব্যবহারকারী ভিডিওটির জন্য পূর্বে সেট করেছিলেন এমন কোনো রেটিং সরিয়ে দেয়।

শরীরের অনুরোধ

এই পদ্ধতিতে কল করার সময় একটি অনুরোধের অংশ প্রদান করবেন না।

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

সফল হলে, এই পদ্ধতিটি একটি 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 অনুরোধ এবং প্রতিক্রিয়া দেখুন।

,

একটি ভিডিওতে একটি পছন্দ বা অপছন্দ রেটিং যোগ করুন বা একটি ভিডিও থেকে একটি রেটিং সরান৷

কোটা প্রভাব: এই পদ্ধতিতে একটি কলের কোটা খরচ 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
রেকর্ড করার জন্য রেটিং নির্দিষ্ট করে।

গ্রহণযোগ্য মান হল:
  • dislike - প্রমাণীকৃত ব্যবহারকারী ভিডিওটি অপছন্দ করেছেন এমন রেকর্ড।
  • like - প্রমাণীকৃত ব্যবহারকারী ভিডিওটি পছন্দ করেছে এমন রেকর্ড।
  • none - প্রমাণীকৃত ব্যবহারকারী ভিডিওটির জন্য পূর্বে সেট করেছিলেন এমন কোনো রেটিং সরিয়ে দেয়।

শরীরের অনুরোধ

এই পদ্ধতিতে কল করার সময় একটি অনুরোধের অংশ প্রদান করবেন না।

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

সফল হলে, এই পদ্ধতিটি একটি 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 অনুরোধ এবং প্রতিক্রিয়া দেখুন।