প্রয়োগ: রেটিং

ভিডিও রেটিং সংক্রান্ত ফাংশন পারফর্ম করতে YouTube Data API (v3) কীভাবে ব্যবহার করতে হয় তা নিম্নলিখিত উদাহরণ থেকে বোঝা যাবে।

ভিডিওকে রেটিং দিন

কোনও ভিডিওর জন্য ব্যবহারকারীর রেটিং জমা দিতে videos.rate পদ্ধতি কল করুন। এই অনুরোধটি অবশ্যই OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে।

আপনার অনুরোধে নিম্নলিখিত দুটি প্যারামিটার সেট করুন:

• id প্যারামিটারটি সেই ভিডিওর YouTube ভিডিও আইডি নির্দিষ্ট করে যেটিকে রেটিং দেওয়া হচ্ছে (বা যার রেটিং সরিয়ে দেওয়া হচ্ছে)।
• অনুরোধ অনুমোদনকারী ব্যবহারকারী যে রেটিং রেকর্ড করতে চান তা rating প্যারামিটার নির্দিষ্ট করে। সঠিক প্যারামিটার ভ্যালু হল like, dislike এবং none। প্রথম দুটি ভ্যালু রেটিং সেট করে এবং তৃতীয়টি ব্যবহারকারীর জন্য আগে থেকে থাকা যেকোনও রেটিং সরিয়ে দেয়।

নিচের নমুনা অনুরোধে ২০১৪ সালের Google I/O কনফারেন্সে মূল বক্তব্য সম্পর্কিত ভিডিওতে ইতিবাচক (লাইক) রেটিং দেওয়া হয়েছে:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
        id=wtLJPvx7-ys
        &rating=like

ভিডিওর জন্য বর্তমান ব্যবহারকারীর রেটিং রিট্রিভ করা

videos.getRating পদ্ধতি আপনাকে বর্তমানে যাচাই করা ব্যবহারকারীর এক বা একাধিক ভিডিওর রেটিং ফিরিয়ে আনতে দেয়। আপনার অনুরোধে, id প্যারামিটারের মানকে YouTube ভিডিও আইডির কমা দ্বারা আলাদা করা তালিকা হিসেবে সেট করুন, যে রিসোর্সের জন্য আপনি রেটিং ডেটা ফিরিয়ে আনছেন। মনে রাখবেন, এই অনুরোধ OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে।

নিচের স্যাম্পেল অনুরোধটি ২০১৪ Google I/O কনফারেন্সে মূল বক্তৃতার ভিডিওর জন্য বর্তমান ব্যবহারকারীর রেটিং ফিরিয়ে আনে। (আপনি যদি API Explorer-এ আগের উদাহরণটি এক্সিকিউট করে থাকেন, তাহলে API উত্তর থেকে বোঝা যাবে যে রেটিং like।

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys

বর্তমান ব্যবহারকারীর রেট করা ভিডিও ফিরিয়ে আনুন

videos.list পদ্ধতির myRating প্যারামিটার আপনাকে API অনুরোধ অনুমোদনকারী ব্যবহারকারীর রেট করা ভিডিওর তালিকা ফিরিয়ে আনতে দেয়। আপনি লাইক করা বা ডিসলাইক করা ভিডিও পেতে চান কিনা তা প্যারামিটারের ভ্যালু থেকে বোঝা যায়।

নিচের স্যাম্পেল অনুরোধটি এমন ভিডিওর তালিকা নিয়ে আসে যেগুলিতে বর্তমান ব্যবহারকারী like রেটিং দিয়েছেন। অনুরোধটি অবশ্যই OAuth 2.0 ব্যবহার করে অনুমোদিত হতে হবে।

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like

মনে রাখবেন: এছাড়াও, আপনি চ্যানেলের পছন্দের ভিডিও ফিরিয়ে আনার জন্য ফ্লো অনুসরণ করে ব্যবহারকারীর পছন্দ করা ভিডিওর (কিন্তু অপছন্দ করা ভিডিও নয়) তালিকা ফিরিয়ে আনতে পারবেন। সেই প্রসেসের ১ নম্বর ধাপে, চ্যানেলের প্রিয় ভিডিওর প্লেলিস্ট আইডি ফিরিয়ে আনার পরিবর্তে, চ্যানেলের লাইক করা ভিডিওর প্লেলিস্ট আইডি ফিরিয়ে আনুন। contentDetails.relatedPlaylists.likes প্রপার্টিতে ভ্যালু থাকে।

তাই, API আপনাকে videos.list পদ্ধতি বা playlistItems.list পদ্ধতি ব্যবহার করে ব্যবহারকারীর লাইক করা ভিডিওর তালিকা ফিরিয়ে আনার অনুমতি দেয়। video রিসোর্সে playlistItem রিসোর্সের থেকে আলাদা তথ্য পাওয়া যায়, তাই আপনার প্রয়োজন অনুযায়ী সবচেয়ে উপযুক্ত পদ্ধতি বেছে নিতে পারবেন।