MembershipsLevels: list

Uwaga: z tego punktu końcowego mogą korzystać tylko poszczególni twórcy, aby przesyłać prośby o utworzenie własnego kanału w YouTube z włączoną funkcją wspierania kanału. Aby poprosić o dostęp, skontaktuj się ze swoim przedstawicielem Google lub YouTube.

Wyświetla listę poziomów wspierania kanału, który autoryzował prośbę. Poziomy są zwracane w niejawnej kolejności wyświetlania. Żądania API wysyłane za pomocą tej metody zwracają jedną z tych odpowiedzi:

  • Jeśli twórca włączył wspieranie kanału i ma określone poziomy cenowe, odpowiedź interfejsu API zawiera listę poziomów.
  • Jeśli twórca włączył wspieranie kanału, ale nie ma zdefiniowanych poziomów cen, odpowiedź interfejsu 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 ma koszt limitu wynoszący 1 jednostkę.

Prośba

Żądanie HTTP

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

To żądanie wymaga autoryzacji w tym zakresie:

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ędzie zawierać odpowiedź interfejsu API. Wartość parametru ma postać listy części zasobów rozdzielonych przecinkami. Poniższa lista zawiera części, które można pobrać:
  • id
  • snippet

Treść żądania

Nie podawaj treści żądania podczas wywoływania tej metody.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:

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

Właściwości

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

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartością będzie youtube#membershipsLevelListResponse.
etag etag
ETag tego zasobu.
items[] list
Lista zasobów membershipsLevel należących do kanału, który autoryzował żądanie do interfejsu 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 szczegółów znajdziesz w dokumentacji komunikatów o błędach.

Typ błędu Szczegóły błędu Opis
badRequest (400) channelMembershipsNotEnabled Kanał twórcy, który autoryzował prośbę, nie ma włączonego wspierania kanału.