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:
|
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. |