members
den Endpunkt sponsors
. Dieser wurde verworfen und wird ab dem 30. September 2020 nicht mehr unterstützt. API-Clients sollten Aufrufe an die Methode sponsors.list
aktualisieren, um stattdessen die Methode members.list
zu verwenden.
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.
Eine member
-Ressource steht für ein Mitglied eines YouTube-Kanals. Ein Mitglied unterstützt einen Creator regelmäßig und erhält besondere Vorteile. Mitglieder können beispielsweise chatten, wenn der Creator den „Nur für Mitglieder“-Modus für einen Chat aktiviert.
Methoden
Die API unterstützt die folgenden Methoden für member
-Ressourcen:
- list
- Listet Mitglieder (früher „Unterstützer“) eines Kanals auf. Die API-Anfrage muss vom Kanalinhaber autorisiert werden.
Ressourcendarstellung
Die folgende JSON-Struktur zeigt das Format einer member
-Ressource:
{ "kind": "youtube#member", "etag": etag, "snippet": { "creatorChannelId": string, "memberDetails": { "channelId": string, "channelUrl": string, "displayName": string, "profileImageUrl": string }, "membershipsDetails": { "highestAccessibleLevel": string, "highestAccessibleLevelDisplayName": string, "accessibleLevels": [ string ], "membershipsDuration": { "memberSince": datetime, "memberTotalDurationMonths": integer, }, "membershipsDurationAtLevel": [ { "level": string, "memberSince": datetime, "memberTotalDurationMonths": integer, } ] } } }
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#member . |
etag |
etag Das ETag dieser Ressource. |
snippet |
object Das Objekt snippet enthält Details zum Mitglied. |
snippet.creatorChannelId |
string Die YouTube-Kanal-ID des Creators, der die Kanalmitgliedschaft anbietet. |
snippet.memberDetails |
object Dieses Objekt enthält Profildaten zu dem YouTube-Kanal, der für die Mitgliedschaft bezahlt. Hinweis: Es kann vorkommen, dass die Mitglieder eines Kanals keine Profildaten haben. Das ist beispielsweise bei Mitgliedern der Fall, die ihre Kanäle gelöscht haben, aber weiterhin für die Kanalmitgliedschaft bezahlen. Diese Mitglieder haben aber weiterhin Zugriff auf ihre Mitgliedschaftsvorteile. API-Antworten enthalten Ressourcen für diese Mitglieder, um eine genaue Zählung zu gewährleisten, auch wenn die Profildetails im memberDetails -Objekt nicht festgelegt sind. Die membershipsDetails werden diesen Mitgliedern weiterhin zur Verfügung gestellt. |
snippet.memberDetails.channelId |
string YouTube-Kanal-ID des Mitgliedskanals. In diesem Fall kann die Kanal-ID auch als eindeutige Kennung für das Mitglied behandelt werden. Wenn sie nicht festgelegt ist, kann das Mitglied nicht eindeutig identifiziert werden. Die Ressource überträgt aber trotzdem Mitgliedschaftsdetails wie die Mitgliedschaftsstufen, auf die das Mitglied zugreifen kann, und die Dauer seiner Mitgliedschaft. |
snippet.memberDetails.channelUrl |
string Die URL des Kanals. |
snippet.memberDetails.displayName |
string Anzeigename des Kanals |
snippet.memberDetails.profileImageUrl |
string Die Avatar-URL des Kanals. |
snippet.membershipsDetails |
object Dieses Objekt enthält Details zur Mitgliedschaft für den Mitgliedskanal. |
snippet.membershipsDetails.highestAccessibleLevel |
string Die ID der höchsten Mitgliedschaftsstufe, auf die der Kanalmitglied derzeit Zugriff hat. Der Wert entspricht dem Attributwert id in einer membershipsLevel -Ressource. |
snippet.membershipsDetails.highestAccessibleLevelDisplayName |
string Der Name der höchsten Mitgliedschaftsstufe, auf die der Kanalmitglied derzeit Zugriff hat. Der Wert entspricht dem Attributwert displayName in einer membershipsLevel -Ressource. |
snippet.membershipsDetails.accessibleLevels[] |
list (of strings) Eine Liste mit IDs für alle Mitgliedschaftsstufen, auf die der Nutzer derzeit zugreifen kann. Die Liste enthält die derzeit aktive Ebene und alle darunter liegenden Ebenen. |
snippet.membershipsDuration |
object Dieses Objekt enthält Informationen zur Gesamtdauer der Mitgliedschaft des aktuellen Mitglieds ohne Berücksichtigung der Preisstufen. Das Attribut snippet.membershipsDetails.membershipsDurationAtLevel[] enthält dann eine Liste von Objekten mit Details zu einem Zeitraum der Mitgliedschaft, in dem das Mitglied Zugriff auf eine bestimmte Mitgliedschaftsstufe hatte.
Das folgende Beispiel zeigt, wie diese Properties funktionieren: Ein Mitglied kauft im Januar eine neue Mitgliedschaft auf Mitgliedschaftsstufe 1 und hat diese bis März. Im April und Mai hat das Mitglied keine Mitgliedschaft. Im Juni wird die Mitgliedschaft dann wieder auf Stufe 1 fortgesetzt. Im August wird die Mitgliedschaft dann auf Stufe 2 umgestellt. Bei einem API-Aufruf im Oktober würde die Ressource member also Folgendes enthalten: "membershipsDetails": { "membershipsDuration": { "memberSince": "2020-06-01T12:00:00", "memberTotalDurationMonths": 7, }, "membershipsDurationAtLevel": [ { "level": "level_1_ID", "memberSince": "2020-06-01T12:00:00", "memberTotalDurationMonths": 7 }, { "level": "level_2_ID", "memberSince": "2020-08-01T12:00:00", "memberTotalDurationMonths": 2 }, ] } |
snippet.membershipsDuration.memberSince |
datetime Datum und Uhrzeit des Beginns der aktuellen Mitgliedschaft des Mitglieds. Mit anderen Worten: Das Mitglied hat seit diesem Datum und dieser Uhrzeit kontinuierlich eine Mitgliedschaft. Es kann allerdings sein, dass unterschiedliche Zeiträume auf unterschiedlichen Mitgliedschaftsstufen ausgegeben wurden. |
snippet.membershipsDuration.memberTotalDurationMonths |
integer Die Anzahl der Monate, abgerundet auf die nächste Ganzzahl, wann der Nutzer Mitglied war. Der Wert spiegelt die Anzahl der vollständigen Monate wider, in denen das Mitglied eine Mitgliedschaft innehatte. Diese Zahl bedeutet jedoch nicht, dass das Mitglied seit diesem Zeitraum kontinuierlich eine Mitgliedschaft hat. |
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel[] |
list (of objects) Eine Liste von Objekten, in der jedes Objekt Details zu einem Zeitraum der Mitgliedschaft enthält, in dem das Mitglied Zugriff auf eine bestimmte Mitgliedschaftsstufe hatte. Die Liste enthält für jede Mitgliedschaftsstufe, auf die das Mitglied derzeit zugreifen kann, ein Objekt. |
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.level |
string Die ID der Mitgliedschaftsstufe. Der Wert entspricht dem Attributwert id in einer Ressource vom Typ membershipsLevel . |
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberSince |
datetime Der Zeitpunkt (Datum und Uhrzeit), ab dem das Mitglied Zugriff auf die angegebene Mitgliedschaftsstufe hatte. Mit anderen Worten: Das Mitglied hatte seit diesem Datum und dieser Uhrzeit kontinuierlich Zugriff auf die Stufe. Es kann sein, dass zu unterschiedlichen Zeiträumen die Mitgliedschaft bei einer höheren Mitgliedschaftsstufe verbraucht wurde. |
snippet.memberDetails.membershipsDetails.membershipsDurationAtLevel.memberTotalDurationMonths |
integer Die Anzahl der Monate, abgerundet auf die nächste Ganzzahl, in der der Nutzer Zugriff auf die angegebene Ebene hatte. Der Wert spiegelt die Anzahl der vollständigen Monate wider, in denen das Mitglied Zugriff auf die Stufe hatte. Die Zahl bedeutet jedoch nicht, dass das Mitglied seit so vielen Monaten ununterbrochen eine Mitgliedschaft hat. |