Videos: getRating

Pobiera oceny, które autoryzowany użytkownik przyznał filmom z listy.

Wpływ na limit: wywołanie tej metody ma koszt limitu wynoszący 1 jednostkę.

Częste przypadki użycia

Żądanie

Żądanie HTTP

GET https://www.googleapis.com/youtube/v3/videos/getRating

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
https://www.googleapis.com/auth/youtube.readonly

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 zawiera listę rozdzielonych przecinkami identyfikatorów filmów na YouTube, dla których pobierasz dane o ocenach. W zasobie video właściwość id określa identyfikator filmu.
Parametry opcjonalne
onBehalfOfContentOwner string
Tego parametru można używać tylko w odpowiednio autoryzowanym żądaniu. Uwaga: ten parametr jest przeznaczony wyłącznie dla partnerów treści YouTube.

Parametr onBehalfOfContentOwner wskazuje, że dane uwierzytelniające żądania identyfikują użytkownika systemu YouTube CMS, który działa w imieniu właściciela treści określonego w wartości parametru. Ten parametr jest przeznaczony dla partnerów treści YouTube, którzy są właścicielami wielu różnych kanałów YouTube i nimi zarządzają. Dzięki temu właściciele treści mogą uwierzytelnić się raz i uzyskać dostęp do wszystkich danych dotyczących filmów i kanałów bez konieczności podawania danych uwierzytelniających dla każdego kanału. Konto CMS, za pomocą którego użytkownik się uwierzytelnia, musi być połączone z określonym właścicielem treści w YouTube.

Treść żądania

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

Odpowiedź

Jeśli operacja się uda, ta metoda zwróci treść odpowiedzi o tej strukturze:

{
  "kind": "youtube#videoGetRatingResponse",
  "etag": etag,
  "items": [
    {
      "videoId": string,
      "rating": string
    }
  ]
}

Właściwości

W tabeli poniżej opisano właściwości, które występują w tym zasobie:

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#videoGetRatingResponse.
etag etag
Tag Etag tego zasobu.
items[] list
Lista ocen, które spełniają kryteria żądania.
items[].videoId string
Identyfikator, którego YouTube używa do jednoznacznego identyfikowania filmu.
items[].rating string
Ocena, którą autoryzowany użytkownik przyznał filmowi.

Prawidłowe wartości tego atrybutu to:
  • dislike
  • like
  • none
  • unspecified

Błędy

Interfejs API nie definiuje żadnych komunikatów o błędach, które są unikalne dla tej metody interfejsu API. Ta metoda może jednak nadal zwracać ogólne błędy interfejsu API wymienione w dokumentacji komunikatów o błędach.

Wypróbuj

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