MembershipsLevels: list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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:
|
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. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-04-26 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2024-04-26 (UTC)."],[[["\u003cp\u003eThis API endpoint allows individual YouTube creators with channel memberships enabled to retrieve a list of their channel's membership levels.\u003c/p\u003e\n"],["\u003cp\u003eThe API response will either include a list of membership levels, an empty list if memberships are enabled but no levels are set, or an error if memberships are not enabled.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns a JSON response containing the resource type, Etag, and a list of \u003ccode\u003emembershipsLevel\u003c/code\u003e resources.\u003c/p\u003e\n"],["\u003cp\u003eRequests to this method have a quota cost of 1 unit and require authorization with the scope \u003ccode\u003ehttps://www.googleapis.com/auth/youtube.channel-memberships.creator\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003epart\u003c/code\u003e parameter with a string value that can contain either \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003esnippet\u003c/code\u003e, or both, as comma separated values.\u003c/p\u003e\n"]]],["This API endpoint allows individual creators to retrieve channel membership levels for their YouTube channel. A `GET` request requires authorization with the `youtube.channel-memberships.creator` scope and the `part` parameter to specify the properties. The response, in JSON format, lists membership levels or an empty list if levels are undefined. If channel memberships aren't enabled, the API returns a `channelMembershipsNotEnabled` error. This method has a quota cost of 1 unit per call.\n"],null,[]]
