MembershipsLevels: list

Hinweis: Dieser Endpunkt kann nur von einzelnen Creatorn verwendet werden, um Anfragen für einen eigenen YouTube-Kanal mit aktivierter Kanalmitgliedschaft zu stellen. Wende dich an deinen Google- oder YouTube-Ansprechpartner, um Zugriff anzufordern.

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

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

Auswirkungen auf Kontingente:Ein Aufruf dieser Methode kostet Kontingentkosten von 1 Einheit.

Anfragen

HTTP-Anfrage

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

Für diese Anfrage ist eine Autorisierung in folgendem Umfang erforderlich:

Umfang
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
Der Parameter part gibt die membershipsLevel-Ressourcenattribute an, die die API-Antwort enthält. 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 Aufrufen 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 angezeigt werden:

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

Fehler

In der folgenden Tabelle sind Fehlermeldungen aufgeführt, die von der API möglicherweise als Antwort auf einen Aufruf dieser Methode zurückgegeben werden. 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 Kanalmitgliedschaft nicht aktiviert.