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.