ما در حال به‌روزرسانی Data API هستیم تا با نحوه شمارش بازدیدهای YouTube برای Shorts مطابقت داشته باشد.
بیشتر بدانید
پیاده سازی: رتبه بندی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
مثال‌های زیر نحوه استفاده از YouTube Data API (v3) را برای انجام عملکردهای مرتبط با رتبه‌بندی ویدیو نشان می‌دهند.
به یک ویدیو امتیاز دهید
با روش videos.rate تماس بگیرید تا امتیاز یک کاربر را برای یک ویدیو ارسال کنید. این درخواست باید با استفاده از OAuth 2.0 مجاز باشد.
دو پارامتر زیر را در درخواست خود تنظیم کنید:
- پارامتر
id شناسه ویدیوی YouTube را مشخص می کند که در حال رتبه بندی (یا حذف رتبه آن) است. - پارامتر
rating رتبه بندی را مشخص می کند که کاربر مجاز به درخواست می خواهد ثبت کند. مقادیر پارامترهای معتبر like ، dislike و none هستند. دو مقدار اول یک رتبه بندی را تعیین می کنند، و سومی هر رتبه ای را که قبلا برای کاربر وجود داشت حذف می کند.
درخواست نمونه زیر امتیاز مثبت (پسندیدن) را به ویدیوی سخنرانی اصلی در کنفرانس Google I/O 2014 می دهد:
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 2014 را بازیابی می‌کند. (اگر مثال قبلی را در APIs Explorer اجرا کرده اید، پاسخ API باید نشان دهد که رتبه like است.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys
ویدیوهای رتبه بندی شده توسط کاربر فعلی را بازیابی کنید
پارامتر myRating روش videos.list به شما امکان می دهد فهرستی از ویدیوهای رتبه بندی شده توسط کاربر مجاز درخواست API را بازیابی کنید. مقدار پارامتر نشان می دهد که آیا می خواهید ویدیوهای پسندیده یا ناپسند را بازیابی کنید.
درخواست نمونه زیر فهرستی از ویدیوهایی را بازیابی می‌کند که کاربر فعلی به آنها امتیاز like داده است. درخواست باید با استفاده از OAuth 2.0 مجاز باشد.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
توجه: همچنین می‌توانید با دنبال کردن جریان
بازیابی ویدیوهای مورد علاقه یک کانال، فهرستی از ویدیوهای پسندیده کاربر (اما نه ویدیوهای دوست نداشتنی) را بازیابی کنید. در مرحله 1 از آن فرآیند، به جای بازیابی شناسه لیست پخش برای ویدیوهای مورد علاقه کانال، شناسه لیست پخش برای ویدیوهای پسندیده کانال را بازیابی کنید. ویژگی
contentDetails.relatedPlaylists.likes حاوی مقدار است.
بنابراین، API به شما امکان می دهد لیستی از ویدیوهایی را که کاربر دوست داشته است با استفاده از روش
videos.list یا روش
playlistItems.list بازیابی کنید. از آنجایی که اطلاعات متفاوتی در یک منبع
video نسبت به منبع
playlistItem برگردانده می‌شود، می‌توانید بهترین روش را انتخاب کنید که با نیازهای شما مطابقت دارد.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2024-11-23 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2024-11-23 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe YouTube Data API (v3) allows users to rate videos using the \u003ccode\u003evideos.rate\u003c/code\u003e method, with options to \u003ccode\u003elike\u003c/code\u003e, \u003ccode\u003edislike\u003c/code\u003e, or remove a rating (\u003ccode\u003enone\u003c/code\u003e), requiring OAuth 2.0 authorization.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the currently authenticated user's rating for specific videos by using the \u003ccode\u003evideos.getRating\u003c/code\u003e method and providing a comma-separated list of video IDs, also requiring OAuth 2.0.\u003c/p\u003e\n"],["\u003cp\u003eThe API enables the retrieval of a list of videos rated by the current user, either liked or disliked, through the \u003ccode\u003evideos.list\u003c/code\u003e method and its \u003ccode\u003emyRating\u003c/code\u003e parameter, which also requires OAuth 2.0.\u003c/p\u003e\n"],["\u003cp\u003eAlternatively, users can retrieve a list of their liked videos by using the \u003ccode\u003eplaylistItems.list\u003c/code\u003e method and accessing the \u003ccode\u003econtentDetails.relatedPlaylists.likes\u003c/code\u003e property, which offers an alternative to the \u003ccode\u003evideos.list\u003c/code\u003e method.\u003c/p\u003e\n"]]],["The YouTube Data API (v3) facilitates video rating management. Using `videos.rate`, users can set or remove ratings (`like`, `dislike`, `none`) for specific videos via the `id` and `rating` parameters. `videos.getRating` retrieves a user's rating for videos, referencing video IDs. The `videos.list` method, with the `myRating` parameter, fetches videos the user has rated as \"like\", and similar functionality is available via the `playlistItems.list` method. All requests require OAuth 2.0 authorization.\n"],null,["# Implementation: Ratings\n\nThe following examples show how to use the YouTube Data API (v3) to perform functions related to video ratings.\n\nRate a video\n------------\n\nCall the [videos.rate](/youtube/v3/docs/videos/rate) method to submit a user's rating for a video. This request must be authorized using OAuth 2.0.\n\nSet the following two parameters in your request:\n\n\u003cbr /\u003e\n\n- The [id](/youtube/v3/docs/videos/rate#id) parameter specifies the YouTube video ID of the video that is being rated (or having its rating removed).\n- The [rating](/youtube/v3/docs/videos/rate#rating) parameter specifies the rating that the user authorizing the request wishes to record. Valid parameter values are `like`, `dislike`, and `none`. The first two values set a rating, and the third removes any rating that previously existed for the user.\n\n\u003cbr /\u003e\n\nThe sample request below gives a positive (like) rating to the video of the keynote speech at the 2014 Google I/O conference: \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?\n id=wtLJPvx7-ys\n &rating=like\n```\n\nRetrieve the current user's rating of a video\n---------------------------------------------\n\nThe [videos.getRating](/youtube/v3/docs/videos/getRating) method lets you retrieve the currently authenticated user's rating of one or more videos. In your request, set the [id](/youtube/v3/docs/videos/rate#id) parameter's value to a comma-separated list of YouTube video IDs for the resources for which you are retrieving rating data. Note that this request must be authorized using OAuth 2.0.\n\nThe sample request below retrieves the current user's rating of the video of the keynote speech at the 2014 Google I/O conference. (If you executed the previous example in the APIs Explorer, the API response should indicate that the rating is `like`. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?\nid=wtLJPvx7-ys\n```\n\nRetrieve videos rated by the current user\n-----------------------------------------\n\nThe `videos.list` method's [myRating](/youtube/v3/docs/videos/list#myRating) parameter lets you retrieve a list of videos rated by the user authorizing the API request. The parameter value indicates whether you want to retrieve liked or disliked videos.\n\nThe sample request below retrieves a list of videos to which the current user gave a `like` rating. The request must be authorized using OAuth 2.0. \n\n```\nhttps://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?\npart=snippet\n&myRating=like\n``` \n**Note:** You can also retrieve a list of the user's liked videos (but not disliked videos) by following the flow for [retrieving a channel's favorite videos](#favorites). In step 1 of that process, instead of retrieving the playlist ID for the channel's favorite videos, retrieve the playlist ID for the channel's liked videos. The `contentDetails.relatedPlaylists.likes` property contains the value. \n\nThus, the API allows you to retrieve a list of videos that the user liked using either the `videos.list` method or the `playlistItems.list` method. Since different information is returned in a `video` resource than a `playlistItem` resource, you can choose the method that best suits your needs."]]
