MembershipsLevels: list

Hinweis: Dieser Endpunkt kann nur von einzelnen Creatorn verwendet werden, um Anfragen für ihren eigenen, YouTube-Kanal zu stellen, für den die Kanalmitgliedschaft aktiviert ist.

Listet die Mitgliedschaftsstufen für den Kanal auf, der die Anfrage autorisiert hat. Die Stufen werden in impliziten Anzeigereihenfolge zurückgegeben. API-Anfragen an diese Methode führen zu einer der folgenden Antworten:

  • Wenn der Creator die Kanalmitgliedschaft aktiviert und Preisstufen festgelegt hat, enthält die API Antwort die Liste der Stufen.
  • Wenn der Creator die Kanalmitgliedschaft aktiviert, aber keine Preisstufen festgelegt hat, enthält die API-Antwort eine leere Liste.
  • Wenn der Creator die Kanalmitgliedschaft nicht aktiviert hat, gibt die API den channelMembershipsNotEnabled Fehler zurück.

Auswirkungen auf das Kontingent: Ein Aufruf dieser Methode kostet 1 Kontingenteinheit.

Anfrage

HTTP-Anfrage

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

Für diese Anfrage ist eine Autorisierung mit dem folgenden Bereich erforderlich:

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

Parameter

In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.

Parameter
Erforderliche Parameter
part string
Mit dem Parameter part werden die Eigenschaften der Ressource membershipsLevel angegeben, die in der API-Antwort enthalten sein sollen. Der Parameterwert ist eine durch Kommas getrennte Liste von Ressourcenteilen. In der folgenden Liste sind die Teile aufgeführt, die abgerufen werden können:
  • id
  • snippet

Anfragetext

Geben Sie beim Aufruf dieser Methode keinen Anfragetext an.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

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

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource enthalten sind:

Attribute
kind string
Gibt den Typ der API-Ressource an. Der Wert ist youtube#membershipsLevelListResponse.
etag etag
Das ETag dieser Ressource.
items[] list
Eine Liste von membershipsLevel-Ressourcen, die dem Kanal gehören, der die API-Anfrage autorisiert hat.

Fehler

In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) channelMembershipsNotEnabled Für den Creator-Kanal, der die Anfrage autorisiert, ist die Kanal mitgliedschaft nicht aktiviert.