Videos: rate

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

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

Typowe przypadki użycia

Żądanie

Żą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 poniższej tabeli podano 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 usuwana.
rating string
Określa ocenę, którą chcesz zarejestrować.

Akceptowane wartości to:
  • dislike – wskazuje, że uwierzytelnionemu użytkownikowi nie podobał się film.
  • like – wskazuje, że uwierzytelniony użytkownik polubił film.
  • none – powoduje usunięcie wszystkich ocen skonfigurowanych dla uwierzytelnionego użytkownika przez dany film.

Treść żądania

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

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 informacji 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ą być oceniane tylko przez użytkowników, którzy je wypożyczyli.
forbidden (403) forbidden Nie można ocenić filmu, który próbujesz ocenić. Żądanie może nie zostać prawidłowo autoryzowane.
forbidden (403) videoRatingDisabled Właściciel filmu, który próbujesz ocenić, wyłączył oceny 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 APIs Explorer, aby wywołać ten interfejs API i wyświetlić żądanie oraz odpowiedź interfejsu API.