Implementierung: Kanäle

Auf dieser Seite wird erläutert, wie Sie mit der YouTube Data API (v3) Funktionen zum Abrufen und Aktualisieren von Kanaldaten ausführen. Eine channel-Ressource enthält Playlist-IDs, die angeben, welche Videos auf einem Kanal hochgeladen und positiv bewertet wurden. Wenn Sie diese Informationen beim Aufrufen der Methode channels.list abrufen möchten, muss der Parameterwert part den Ressourcenteil contentDetails enthalten.

Informationen zu einem Kanal abrufen

Rufen Sie die Methode channels.list auf, um Informationen zu einem bestimmten Kanal abzurufen. Es gibt mehrere Möglichkeiten, den Kanal zu identifizieren:

Branding-Informationen für einen Kanal festlegen

In diesem Beispiel werden die Brandingoptionen eines Kanals aktualisiert. Das Beispiel besteht aus zwei Schritten:

  • Schritt 1: Brandingoptionen des Kanals abrufen

    Rufen Sie die Methode channels.list auf und setzen Sie den Parameterwert part auf brandingSettings und den Parameter mine auf true.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=brandingSettings
        &mine=true

    Ihre Anwendung könnte die abgerufenen Einstellungen anzeigen, sodass der Nutzer die Einstellungen aktualisieren kann, um sie zu aktualisieren.

  • Schritt 2: Brandingoptionen des Kanals aktualisieren

    Rufen Sie die Methode channels.list auf und legen Sie die folgenden Werte fest:

    • Lege für die Property id die eindeutige YouTube-Kanal-ID des Kanals fest. Die ID kann in Schritt 1 aus der API-Antwort extrahiert werden.
    • Legen Sie den Wert des Parameters part auf brandingSettings fest.

    Der Link zum API Explorer unten erstellt eine channel-Ressource mit den folgenden Branding-Einstellungen:

    {
  "id": "CHANNEL_ID",
  "brandingSettings": {
    "channel": {
      "description": "A great channel to be enjoyed by all.",
      "moderateComments": true,
      "showRelatedChannels": true,
      "showBrowseView": true,
      "featuredChannelsTitle": "Featured Channel Stuff",
      "featuredChannelsUrls": [
        "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "UCBR8-60-B28hp2BmDPdntcQ",
        "UCK8sQmJBp8GCxrOtXWBpyEA"
      ],
      "profileColor": "#006600"
    }
  }
}

    Zum Abschließen der Anfrage im APIs Explorer müssen Sie den Wert der Eigenschaft id auf die Kanal-ID des Kanals des authentifizierten Nutzers festlegen. Außerdem sollten Sie die Bildeigenschaften an Ihre aktuellen Einstellungen anpassen.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=brandingSettings

Kanalabschnitte verwalten

Die API unterstützt die Methoden channelSections.list, channelSections.insert, channelSections.update und channelSections.delete zum Verwalten von Kanalabschnitten. Ein Kanalabschnitt ist eine Gruppe von Videos, die auf einem Kanal vorgestellt werden. Ein Abschnitt kann beispielsweise die neuesten Uploads eines Kanals, die beliebtesten Uploads oder Videos aus einer oder mehreren Playlists enthalten.

Im folgenden Beispiel werden die Kanalabschnitte für den offiziellen YouTube-Kanal abgerufen. In der Anfrage wird die Methode channelSections.list aufgerufen und der Parameterwert channelId auf UCK8sQmJBp8GCxrOtXWBpyEA festgelegt. Dies ist die Kanal-ID für den Kanal von Google. 

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

Für diese Anfrage ist eine Autorisierung erforderlich, wenn Sie anstelle des Parameters channelId den Wert des Parameters mine auf true festlegen. Dieser Parameter gibt an, dass Sie Kanalabschnitte für den Kanal des aktuell authentifizierten Nutzers abrufen.

Wasserzeichenbild für einen Kanal hochladen und festlegen

Du kannst die Methode watermarks.set aufrufen, um ein Wasserzeichenbild hochzuladen und es für einen Kanal festzulegen. Das Bild wird dann während der Wiedergabe der Videos des angegebenen Kanals angezeigt. Sie können auch einen Zielkanal angeben, mit dem das Bild verknüpft werden soll, sowie Zeitangaben, die bestimmen, wann und wie lange das Wasserzeichen erscheint.

Mit der Methode watermarks.unset wird das Wasserzeichenbild eines Kanals gelöscht.

Leider kann diese Abfrage nicht mit APIs Explorer getestet werden, da sie für Mediendateien nicht unterstützt wird.