Videos: rate

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:
  • dislike – rejestruje, że film nie podobał się uwierzytelnionemu użytkownikowi.
  • like – rejestruje, że uwierzytelniony użytkownik polubił film.
  • none – usuwa wszystkie oceny, które uwierzytelniony użytkownik ustawił wcześniej dla filmu.

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.