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 die Mitgliedschaftsstufen für den Kanal auf, der die Anfrage autorisiert hat. Stufen werden in impliziter Anzeigereihenfolge zurückgegeben. API-Anfragen an diese Methode liefern eine der folgenden Antworten:

  • Wenn der Creator die Kanalmitgliedschaft aktiviert hat und Preisstufen 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.

Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 1 Einheit.

Anfragen

HTTP-Anfrage

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

Für diese Anfrage ist eine Autorisierung mit folgendem 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
Der Parameter part gibt die Attribute der membershipsLevel-Ressource an, die in der API-Antwort enthalten sein sollen. Der Parameterwert ist eine durch Kommas getrennte Liste von Ressourcenteilen. Die folgende Liste zeigt die Teile, 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 dem Kanal gehören, der die API-Anfrage autorisiert hat.

Fehler

In der folgenden Tabelle finden Sie Fehlermeldungen, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. 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.