FanFundingEvents: list

Uwaga: to jest tylko komunikat o wycofaniu.

Funkcja finansowania przez fanów została wycofana, a interfejs API finansowania przez fanów zostanie wyłączony 28 lutego 2017 r. To ogłoszenie o wycofaniu zbiegnie się z wprowadzeniem nowej funkcji Superczatu w YouTube.

Wyświetla listę zdarzeń finansowania przez fanów na kanale. Żądanie do interfejsu API musi zostać autoryzowane przez właściciela kanału.

Żądanie

Żądanie HTTP

GET https://www.googleapis.com/youtube/v3/fanFundingEvents

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

Parametry

W poniższej tabeli podano parametry obsługiwane przez to zapytanie. Wszystkie wymienione parametry są parametrami zapytania.

Parametry
Parametry wymagane
part string
Parametr part określa fanFundingEvent części zasobów, które będą uwzględnione w odpowiedzi interfejsu API. Obsługiwane wartości to id i snippet.
Parametry opcjonalne
hl string
Parametr hl nakazuje interfejsowi API pobrać zlokalizowany ciąg znaków waluty dla konkretnego języka aplikacji obsługiwanego przez stronę YouTube. Na przykład w języku angielskim waluta będzie widoczna jako $1.50, ale w języku francuskim będzie widoczna jako 1,50$.

Wartość parametru musi być kodem języka znajdującym się na liście zwróconej metodą i18nLanguages.list.
maxResults unsigned integer
Parametr maxResults określa maksymalną liczbę elementów, które powinny zostać zwrócone w zestawie wyników. Akceptowane wartości to 0–50 (włącznie). Wartością domyślną jest 5.
pageToken string
Parametr pageToken wskazuje konkretną stronę w zestawie wyników, której serwer API prosi o zwrócenie. W odpowiedzi interfejsu API właściwość nextPageToken wskazuje następną stronę wyników żądania.

Treść żądania

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

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w następującym formacie:

{
  "kind": "youtube#fanFundingEventListResponse",
  "etag": etag,
  "nextPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    fanFundingEvent resource
  ]
}

Usługi

Poniższa tabela określa właściwości, które pojawiają się w tym zasobie:

Usługi
kind string
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#fanFundingEventListResponse.
etag etag
Otagowanie tego zasobu.
nextPageToken string
Token, który może zostać użyty jako wartość parametru pageToken, by pobrać następną stronę z zestawu wyników.
pageInfo object
Obiekt pageInfo zawiera informacje o stronicowaniu dla zestawu wyników.
pageInfo.totalResults integer
Łączna liczba wyników w zestawie wyników.
pageInfo.resultsPerPage integer
Liczba wyników zawartych w odpowiedzi interfejsu API.
items[] list
Lista zdarzeń finansowania przez fanów, które spełniają kryteria prośby.

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
forbidden (403) insufficientPermissions Nie masz odpowiednich uprawnień, aby wyświetlić wydarzenia finansowania przez fanów.
invalidValue (400) fanFundingNotEnabledForChannelId Na kanale nie ma włączonego finansowania przez fanów.

Wypróbuj

Użyj interfejsu API Explorer, aby wywołać tę metodę w aktywnych danych i wyświetlić żądanie do interfejsu API oraz odpowiedź.