Implementierung: Channels

Auf dieser Seite wird beschrieben, wie du mit der YouTube Data API (v3) Funktionen zum Abrufen und Aktualisieren von Kanaldaten ausführen kannst. Eine channel-Ressource enthält Playlist-IDs, die die hochgeladenen und „Mag ich“-bewerteten Videos eines Kanals identifizieren. 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

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

Brandinginformationen für einen Kanal festlegen

In diesem Beispiel werden die Brandingoptionen eines Kanals aktualisiert. Das Beispiel umfasst zwei Schritte:

  • Schritt 1: Branding-Optionen des Kanals abrufen

    Rufen Sie die Methode channels.list auf und legen Sie den Parameterwert part auf brandingSettings und den Parameterwert mine auf true fest.

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

    Ihre Anwendung kann die abgerufenen Einstellungen anzeigen, sodass der Nutzer die Einstellungen ändern kann, die aktualisiert werden sollen.

  • 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 Parameterwert part auf brandingSettings fest.

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

    {
  "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"
    }
  }
}

    Damit die Anfrage im APIs Explorer abgeschlossen werden kann, müssen Sie den Wert der Property id auf die Kanal-ID des authentifizierten Nutzers festlegen. Außerdem sollten Sie die Bildeigenschaften so festlegen, dass sie Ihren aktuellen Einstellungen entsprechen.

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

Kanalbereiche verwalten

Die API unterstützt die Methoden channelSections.list, channelSections.insert, channelSections.update und channelSections.delete zum Verwalten von Kanalbereichen. Ein Kanalabschnitt besteht aus einer Reihe von Videos, die auf einem Kanal präsentiert werden. Ein Bereich kann beispielsweise die neuesten Uploads, die beliebtesten Uploads oder Videos aus einer oder mehreren Playlists eines Kanals enthalten.

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

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 Parameterwert mine auf true festlegen. Dieser Parameter gibt an, dass du Channelbereiche für den Kanal des aktuell authentifizierten Nutzers abrufen möchtest.

Wasserzeichenbild für einen Kanal hochladen und festlegen

Du kannst die Methode watermarks.set aufrufen, um ein Wasserzeichenbild hochzuladen und für einen Kanal festzulegen. Das Bild wird dann bei der Wiedergabe der Videos des ausgewählten Kanals angezeigt. Du kannst auch einen Zielkanal angeben, mit dem das Bild verknüpft werden soll, sowie Timing-Details, die festlegen, wann das Wasserzeichen angezeigt wird und wie lange es sichtbar ist.

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

Diese Abfrage kann leider nicht mit dem APIs Explorer getestet werden, da der APIs Explorer das Hochladen von Mediendateien nicht unterstützt, was für diese Methode erforderlich ist.