Videos: rate

Dodaj do filmu ocenę „Podoba mi się” lub „Nie podoba mi się” lub usuń z niego ocenę.

Wpływ na limit: wywołanie tej metody ma koszt limitu wynoszący 50 jednostek.

UWAGA: nie ma to wpływu na oficjalną liczbę ocen pozytywnych/negatywnych dla filmu.

Typowe przypadki użycia

Prośba

Żądanie HTTP

POST https://www.googleapis.com/youtube/v3/videos/rate

Upoważnienie

To żądanie wymaga autoryzacji z użyciem co najmniej jednego z tych 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 usunięty.
rating string
Określa ocenę do zarejestrowania.

Akceptowane wartości to:
  • dislike – rejestruje, że uwierzytelnionemu użytkownikowi nie podobał się film.
  • like – rejestruje, że uwierzytelnionemu użytkownikowi podobał się film.
  • none – usuwa wszystkie oceny, które wcześniej ustawił uwierzytelniony użytkownik.

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 potwierdzić swój adres e-mail.
badRequest (400) invalidRating Żądanie zawiera nieoczekiwaną wartość parametru rating.
badRequest (400) videoPurchaseRequired Wypożyczone filmy mogą oceniać tylko te użytkowników, którzy je wypożyczyli.
forbidden (403) forbidden Nie można ocenić filmu wideo, który próbujesz ocenić. Żądanie może nie być poprawnie autoryzowane.
forbidden (403) videoRatingDisabled Właściciel filmu, który próbujesz ocenić, wyłączył możliwość oceniania tego filmu.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz ocenić. Sprawdź, czy wartość parametru id żądania jest prawidłowa.

Wypróbuj

Użyj interfejsu APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.