Dodaj ocenę filmu lub ocenę treści jako „Nie podoba mi się” lub usuń ocenę z filmu.
Wpływ na limit: wywołanie tej metody ma koszt 50 jednostek.
UWAGA: nie ma to wpływu na oficjalną liczbę ocen pozytywnych/negatywnych w filmie.
Typowe przypadki użycia
Prośba
Żądanie HTTP
POST https://www.googleapis.com/youtube/v3/videos/rate
Upoważnienie
To żądanie wymaga autoryzacji z co najmniej jednym z poniższych zakresów (więcej informacji o uwierzytelnianiu i autoryzacji).
Zakres |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parametry
W tabeli poniżej znajdziesz parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.
Parametry | ||
---|---|---|
Parametry wymagane | ||
id |
string Parametr id określa identyfikator filmu w YouTube, który jest oceniany lub usuwany. |
|
rating |
string Określa ocenę do zarejestrowania. Akceptowane wartości to:
|
Treść żądania
Nie podawaj treści żądania podczas wywoływania tej metody.
Odpowiedź
Jeśli operacja się uda, metoda zwróci kod odpowiedzi HTTP 204
(No Content
).
Błędy
W tabeli poniżej znajdziesz komunikaty o błędach, które interfejs API może zwrócić w odpowiedzi na wywołanie tej metody. Więcej szczegółów znajdziesz w dokumentacji komunikatów o błędach.
Typ błędu | Szczegóły błędu | Opis |
---|---|---|
badRequest (400) |
emailNotVerified |
Przed wystawieniem oceny użytkownik musi zweryfikować swój adres e-mail. |
badRequest (400) |
invalidRating |
Żądanie zawiera nieoczekiwaną wartość parametru rating . |
badRequest (400) |
videoPurchaseRequired |
Wypożyczone filmy mogą oceniać tylko użytkownicy, którzy je wypożyczyli. |
forbidden (403) |
forbidden |
Nie można ocenić filmu, który próbujesz ocenić. Żądanie może nie być prawidłowo autoryzowane. |
forbidden (403) |
videoRatingDisabled |
Właściciel filmu, który próbujesz ocenić, wyłączył możliwość oceny tego filmu. |
notFound (404) |
videoNotFound |
Nie można znaleźć filmu, który chcesz ocenić. Sprawdź, czy wartość parametru id żądania jest prawidłowa. |
Wypróbuj
Aby wywołać ten interfejs API i zobaczyć żądanie i odpowiedź do interfejsu API, użyj komponentu APIs Explorer.