Implementierung: Channels

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

• Setze den Wert des Parameters mine auf true, um Informationen zum YouTube-Kanal des aktuell authentifizierten Nutzers abzurufen. Deine Anfrage muss mit OAuth 2.0 autorisiert werden.

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

• Setze den Parameter forUsername auf einen YouTube-Nutzernamen, um Informationen zum Kanal abzurufen, der mit diesem Nutzernamen verknüpft ist. In diesem Beispiel wird der Wert des Parameters forUsername auf Google gesetzt, um Informationen zum offiziellen YouTube-Kanal von Google abzurufen.

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
          part=snippet,contentDetails
          &forUsername=Google

• Setze den Parameter id auf die YouTube-Kanal-ID, die den Kanal eindeutig identifiziert, für den du Informationen abrufst. In diesem Beispiel wird der Parameter id auf UCK8sQmJBp8GCxrOtXWBpyEA gesetzt, was ebenfalls den offiziellen YouTube-Kanal von Google identifiziert.

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

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
  

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.

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.