MembershipsLevels: list

Uwaga: tego punktu końcowego mogą używać tylko pojedynczy twórcy, aby wysyłać żądania dotyczące własnego kanału YouTube z włączonym wspieraniem.

Wyświetla listę poziomów wspierania kanału, który autoryzował żądanie. Poziomy są zwracane w domyślnej kolejności wyświetlania. Żądania API wysyłane do tej metody mogą zwrócić jedną z tych odpowiedzi:

  • Jeśli twórca włączył wspieranie kanału i ma poziomy cenowe, odpowiedź API zawiera listę poziomów.
  • Jeśli twórca włączył wspieranie kanału, ale nie zdefiniował poziomów cenowych, odpowiedź API zawiera pustą listę.
  • Jeśli twórca nie włączył wspierania kanału, interfejs API zwraca błąd channelMembershipsNotEnabled.

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

Żądanie

Żądanie HTTP

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

To żądanie wymaga autoryzacji z tym zakresem:

Zakres
https://www.googleapis.com/auth/youtube.channel-memberships.creator

Parametry

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

Parametry
Parametry wymagane
part string
Parametr part określa właściwości zasobu membershipsLevel które będą uwzględnione w odpowiedzi API. Wartość parametru to lista części zasobu oddzielonych przecinkami. Oto lista części, które można pobrać:
  • id
  • snippet

Treść żądania

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

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w poniższym formacie:

{
  "kind": "youtube#membershipsLevelListResponse",
  "etag": etag,
  "items": [
    membershipsLevel Resource
  ]
}

Właściwości

W tabeli poniżej znajdziesz definicje właściwości, które pojawiają się w tym zasobie:

Właściwości
kind string
Określa typ zasobu API. Wartość to youtube#membershipsLevelListResponse.
etag etag
Etag tego zasobu.
items[] list
Lista zasobów membershipsLevel należących do kanału, który autoryzował żądanie API.

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) channelMembershipsNotEnabled Kanał twórcy, który autoryzuje żądanie, nie ma włączonego wspierania kanału.