Videos: rate

Dodawanie oceny (polubienia lub głosu na nie) filmu albo usuwanie oceny filmu

Wpływ na limit: wywołanie tej metody wiąże się z kosztem limitu wynoszącym 50 jednostek.

UWAGA: nie ma to wpływu na oficjalną liczbę polubień i głosów na nie filmu.

Częste zastosowania

Żądanie

Żądanie HTTP

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

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym 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 którego ocena jest usuwana.
rating string
Określa ocenę, która ma zostać zapisana.

Akceptowane wartości:
  • dislike – zapisuje, że uwierzytelniony użytkownik nie polubił filmu.
  • like – zapisuje, że uwierzytelniony użytkownik polubił film.
  • none – usuwa ocenę, którą uwierzytelniony użytkownik wcześniej ustawił dla filmu.

Treść żądania

Podczas wywoływania tej metody nie podawaj treści żądania.

Odpowiedź

Jeśli operacja się powiedzie, ta metoda zwraca 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 informacji znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
badRequest (400) emailNotVerified Przed oceną użytkownik musi potwierdzić swój adres e-mail.
badRequest (400) invalidRating Żądanie zawierało nieoczekiwaną wartość parametru rating.
badRequest (400) videoPurchaseRequired Filmy do wypożyczenia 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ł ocenianie tego filmu.
notFound (404) videoNotFound Nie można znaleźć filmu, który próbujesz ocenić. Sprawdź wartość parametru id żądania, aby upewnić się, że jest prawidłowa.

Wypróbuj

Aby wywołać ten interfejs API i zobaczyć żądanie do interfejsu API oraz odpowiedź, użyj APIs Explorer.