MembershipsLevels: list

Uwaga: z tego punktu końcowego mogą korzystać tylko poszczególni twórcy, aby przesyłać prośby dotyczące własnego kanału w YouTube, który wspiera kanał. Skontaktuj się z przedstawicielem Google lub YouTube, aby poprosić o dostęp.

Podaje poziomy wspierania kanału, który autoryzował prośbę. Poziomy są zwracane w domyślnej kolejności wyświetlania. Żądania API wysyłane do tej metody zwracają jedną z tych odpowiedzi:

  • Jeśli twórca włączył wspieranie kanału i ma poziomy cen, odpowiedź interfejsu API będzie zawierać listę poziomów.
  • Jeśli twórca włączył wspieranie kanału, ale nie ma zdefiniowanych poziomów cen, odpowiedź interfejsu API będzie pusta.
  • Jeśli twórca nie włączył wspierania kanału, interfejs API zwróci błąd channelMembershipsNotEnabled.

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

Żądanie

Żądanie HTTP

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

To żądanie wymaga autoryzacji w następującym zakresie:

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

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 właściwości zasobu membershipsLevel, które będą uwzględniane w odpowiedzi interfejsu API. Wartość parametru to rozdzielona przecinkami lista części zasobów. Poniższa lista zawiera elementy, 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 następującym formacie:

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

Właściwości

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

Właściwości
kind string
Określa typ zasobu interfejsu API. Wartość będzie wynosić youtube#membershipsLevelListResponse.
etag etag
Otagowanie tego zasobu.
items[] list
Lista membershipsLevel zasobów 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 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 autoryzował żądanie, nie ma włączonego wspierania.