Sponsors

Hinweis: Diese Ressource wurde am 31. März 2020 verworfen. Sie wurde durch die Ressource member ersetzt. Informationen zu dieser Ressource finden Sie in der Dokumentation zur YouTube Data API.

Die Methode sponsors.list wird ab dem 30. September 2020 nicht mehr unterstützt. API-Clients sollten Aufrufe der Methode sponsors.list so aktualisieren, dass stattdessen die Methode members.list verwendet wird.

Eine sponsor-Ressource repräsentiert ein Kanalmitglied (früher als „Sponsor“ bezeichnet) für einen YouTube-Kanal. Ein Mitglied bietet einem Creator regelmäßig finanzielle Unterstützung und erhält spezielle Vorteile. Beispielsweise können Mitglieder chatten, wenn der Creator den Chatmodus nur für Mitglieder aktiviert.

Methoden

Die API unterstützt die folgenden Methoden für sponsors-Ressourcen:

list
Listet Sponsoren eines Kanals auf. Die API-Anfrage muss vom Kanalinhaber autorisiert werden. Hier kannst du die Funktion ausprobieren.

Ressourcendarstellung

Die folgende JSON-Struktur zeigt das Format einer sponsors-Ressource:

{
  "kind": "youtube#sponsor",
  "etag": etag,
  "id": string,
  "snippet": {
    "channelId": string,
    "sponsorDetails": {
      "channelId": string,
      "channelUrl": string,
      "displayName": string,
      "profileImageUrl": string
    },
    "sponsorSince": datetime
  }
}

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#sponsor.
etag etag
Das ETag dieser Ressource.
id string
Die ID, die YouTube zur eindeutigen Identifizierung des Sponsors zuweist.
snippet object
Das Objekt snippet enthält Details zum Sponsor.
snippet.channelId string
Diese ID identifiziert den gesponserten Kanal.
snippet.sponsorDetails object
Dieses Objekt enthält Details zum Sponsor.
snippet.sponsorDetails.channelId string
Die YouTube-Kanal-ID.
snippet.sponsorDetails.channelUrl string
Die URL des Kanals
snippet.sponsorDetails.displayName string
Der Anzeigename des Kanals.
snippet.sponsorDetails.profileImageUrl string
Die Avatar-URL des Kanals
snippet.sponsorSince datetime
Datum und Uhrzeit der Unterstützer-Status Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.