Implementierung: Channels

Auf dieser Seite wird erläutert, 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 mit „Mag ich“ bewerteten Videos eines Kanals identifizieren. Wenn du diese Informationen beim Aufrufen der Methode channels.list abrufen möchtest, 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 mehrere Möglichkeiten, den Kanal zu identifizieren:

Branding-Informationen für einen Kanal festlegen

In diesem Beispiel werden die Branding-Optionen eines Kanals aktualisiert. Das Beispiel besteht aus zwei Schritten:

  • Schritt 1: Branding-Optionen des Kanals abrufen

    Rufe die Methode channels.list auf und setze den Parameterwert part auf brandingSettings und den Parameterwert mine auf true.

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

    Deine Anwendung kann die abgerufenen Einstellungen anzeigen, damit der Nutzer sie ändern kann.

  • Schritt 2: Branding-Optionen des Kanals aktualisieren

    Rufe die Methode channels.list auf und setze die folgenden Werte:

    • Setze die Property id auf die eindeutige YouTube-Kanal-ID des Kanals. Die ID kann in Schritt 1 aus der API-Antwort extrahiert werden.
    • Setze den Parameterwert part auf brandingSettings.

    Über den Link zum API Explorer unten wird eine channel-Ressource mit den folgenden Markeneinstellungen 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"
    }
  }
}

    Um die Anfrage im API Explorer abzuschließen, musst du den Wert der Property id auf die Kanal-ID des Kanals des authentifizierten Nutzers setzen. Außerdem solltest du die Bild-Properties an deine 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 präsentiert werden. Ein Abschnitt kann beispielsweise die neuesten Uploads, die beliebtesten Uploads oder Videos aus einer oder mehreren Playlists eines Kanals enthalten.

Im folgenden Beispiel werden die Kanalabschnitte für den offiziellen YouTube-Kanal von Google abgerufen. Die Anfrage ruft die Methode channelSections.list auf und setzt den Parameterwert channelId auf UCK8sQmJBp8GCxrOtXWBpyEA, 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 du anstelle des Parameters channelId den Parameterwert des Parameters mine auf true setzt. Dieser Parameter gibt an, dass du Kanalabschnitte für den Kanal des aktuell authentifizierten Nutzers abrufst.

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 von Videos des angegebenen Kanals angezeigt. Du kannst auch einen Zielkanal angeben, mit dem das Bild verknüpft werden soll, sowie Timing-Details, die bestimmen, 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 API Explorer getestet werden, da der API Explorer das Hochladen von Mediendateien nicht unterstützt. Dies ist jedoch für diese Methode erforderlich.