একটি ভিডিওতে একটি পছন্দ বা অপছন্দ রেটিং যোগ করুন বা একটি ভিডিও থেকে একটি রেটিং সরান৷
কোটা প্রভাব: এই পদ্ধতিতে একটি কলের কোটা খরচ 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 অনুরোধ এবং প্রতিক্রিয়া দেখুন।
একটি ভিডিওতে একটি পছন্দ বা অপছন্দ রেটিং যোগ করুন বা একটি ভিডিও থেকে একটি রেটিং সরান৷
কোটা প্রভাব: এই পদ্ধতিতে একটি কলের কোটা খরচ 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 অনুরোধ এবং প্রতিক্রিয়া দেখুন।