Subscriptions

Eine subscription-Ressource enthält Informationen zu einem YouTube-Nutzerabo. Ein Abo benachrichtigt einen Nutzer, wenn einem Kanal neue Videos hinzugefügt werden oder wenn ein anderer Nutzer eine von mehreren Aktionen auf YouTube ausführt, z. B. ein Video hochlädt, ein Video bewertet oder ein Video kommentiert.

Methoden

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

list
Gibt Aboressourcen zurück, die den Kriterien der API-Anfrage entsprechen. Hier kannst du die Funktion ausprobieren.
insert
Fügt dem Kanal des authentifizierten Nutzers ein Abo hinzu. Hier kannst du die Funktion ausprobieren.
Delete
Löscht ein Abo. Hier kannst du die Funktion ausprobieren.

Ressourcendarstellung

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

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource enthalten sind:

Attribute
kind string
Gibt den Typ der API-Ressource an. Der Wert ist youtube#subscription.
etag etag
Das ETag dieser Ressource.
id string
Die ID, die YouTube zur eindeutigen Identifizierung des Abos verwendet.
snippet object
Das snippet-Objekt enthält grundlegende Details zum Abo, einschließlich des Titels und des Kanals, den der Nutzer abonniert hat.
snippet.publishedAt datetime
Datum und Uhrzeit der Erstellung des Abos. Der Wert wird im ISO 8601-Format angegeben.
snippet.title string
Der Titel des Abos.
snippet.description string
Details zum Abo.
snippet.resourceId object
Das id-Objekt enthält Informationen zum Kanal, den der Nutzer abonniert hat.
snippet.resourceId.kind string
Der Typ der API-Ressource.
snippet.resourceId.channelId string
Der Wert, den YouTube verwendet, um den Kanal, den der Nutzer abonniert hat, eindeutig zu identifizieren.
snippet.channelId string
Die ID, die YouTube verwendet, um den Kanal des Abonnenten eindeutig zu identifizieren. Das resource_id-Objekt identifiziert den Channel, den der Nutzer abonniert hat.
snippet.thumbnails object
Eine Karte mit Miniaturansichten, die dem Abo zugeordnet sind. Für jedes Objekt auf der Karte ist der Schlüssel der Name des Vorschaubilds und der Wert ein Objekt, das weitere Informationen zum Vorschaubild enthält.
snippet.thumbnails.(key) object
Gültige Schlüsselwerte sind:
  • default: Das Standard-Miniaturbild für diese Ressource. Die Standard-Miniaturansicht für ein Video oder eine Ressource, die auf ein Video verweist, z. B. ein Playlistenelement oder ein Suchergebnis, ist 120 Pixel breit und 90 Pixel hoch. Das Standard-Thumbnail für einen Channel ist 88 Pixel breit und 88 Pixel hoch.
  • medium – Eine Version des Thumbnails mit höherer Auflösung. Bei einem Video (oder einer Ressource, die auf ein Video verweist) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Für einen Kanal ist dieses Bild 240 Pixel breit und 240 Pixel hoch.
  • high – Eine Version des Thumbnail-Bilds mit hoher Auflösung. Bei einem Video (oder einer Ressource, die auf ein Video verweist) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Für einen Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch.
snippet.thumbnails.(key).url string
Die URL des Bildes.
snippet.thumbnails.(key).width unsigned integer
Die Breite des Bildes.
snippet.thumbnails.(key).height unsigned integer
Die Höhe des Bildes.
contentDetails object
Das contentDetails-Objekt enthält grundlegende Statistiken zum Abo.
contentDetails.totalItemCount unsigned integer
Die ungefähre Anzahl der Elemente, auf die das Abo verweist.
contentDetails.newItemCount unsigned integer
Die Anzahl der neuen Elemente im Abo seit dem letzten Lesen der Inhalte.
contentDetails.activityType string
Der Aktivitätstyp, für den dieses Abo gilt (nur Uploads, alles).

Gültige Werte für diese Eigenschaft sind:
  • all
  • uploads
subscriberSnippet object
Das subscriberSnippet-Objekt enthält grundlegende Details zum Abonnenten.
subscriberSnippet.title string
Der Titel des Kanals des Abonnenten.
subscriberSnippet.description string
Die Beschreibung des Kanals des Abonnenten.
subscriberSnippet.channelId string
Die ID, die YouTube dem Kanal des Abonnenten zuweist, um ihn eindeutig zu identifizieren.
subscriberSnippet.thumbnails object
Miniaturansichten für den Kanal des Abonnenten.
subscriberSnippet.thumbnails.(key) object
Gültige Schlüsselwerte sind:
  • default: Das Standard-Miniaturbild für diese Ressource. Die Standard-Miniaturansicht für ein Video oder eine Ressource, die auf ein Video verweist, z. B. ein Playlistenelement oder ein Suchergebnis, ist 120 Pixel breit und 90 Pixel hoch. Das Standard-Thumbnail für einen Channel ist 88 Pixel breit und 88 Pixel hoch.
  • medium – Eine Version des Thumbnails mit höherer Auflösung. Bei einem Video (oder einer Ressource, die auf ein Video verweist) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Für einen Kanal ist dieses Bild 240 Pixel breit und 240 Pixel hoch.
  • high – Eine Version des Thumbnail-Bilds mit hoher Auflösung. Bei einem Video (oder einer Ressource, die auf ein Video verweist) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Für einen Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch.
subscriberSnippet.thumbnails.(key).url string
Die URL des Bildes.
subscriberSnippet.thumbnails.(key).width unsigned integer
Die Breite des Bildes.
subscriberSnippet.thumbnails.(key).height unsigned integer
Die Höhe des Bildes.