ChannelSections: update

Aktualisiert einen Kanalabschnitt.

Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode kostet 50 Kontingenteinheiten.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

PUT https://www.googleapis.com/youtube/v3/channelSections

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

Bereich
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parameter

In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.

Parameter
Erforderliche Parameter
part string
Der Parameter part hat bei dieser Operation zwei Funktionen. Er gibt die Eigenschaften an, die durch die Schreiboperation festgelegt werden, sowie die Eigenschaften, die in der API-Antwort enthalten sein sollen.

Die folgende Liste enthält die part Namen, die Sie in den Parameterwert aufnehmen können:
  • contentDetails
  • id
  • snippet
Optionale Parameter
onBehalfOfContentOwner string
Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Hinweis: Dieser Parameter ist ausschließlich für YouTube-Content-Partner vorgesehen.

Der onBehalfOfContentOwner Parameter gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube-CMS-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Content-Inhabers handelt. Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle besitzen und verwalten. So können sich Rechteinhaber einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Authentifizierungsdaten angeben zu müssen. Das CMS-Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.

Anfragetext

Geben Sie im Anfragetext eine channelSection-Ressource an. Für diese Ressource gilt:

  • Sie müssen einen Wert für diese Eigenschaften angeben:

    • snippet.type

  • Sie können Werte für diese Eigenschaften festlegen:

    • snippet.type
    • snippet.title
    • snippet.position
    • contentDetails.playlists[]
    • contentDetails.channels[]

    Wenn Sie eine Aktualisierungsanfrage senden und in der Anfrage kein Wert für eine Eigenschaft angegeben ist, die bereits einen Wert hat, wird der vorhandene Wert der Eigenschaft gelöscht.

Antwort

Bei Erfolg gibt diese Methode im Antworttext eine channelSection-Ressource zurück.

Fehler

In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) notEditable Dieser Kanalabschnitt kann nicht bearbeitet werden.
badRequest (400) typeRequired Für die channelSection-Ressource muss ein Wert für das Feld snippet.type angegeben werden.
forbidden (403) channelSectionForbidden Die Anfrage ist nicht ordnungsgemäß authentifiziert oder wird für diesen Kanal nicht unterstützt.
invalidValue (400) channelNotActive Mindestens einer der angegebenen Kanäle ist nicht aktiv.
invalidValue (400) channelsDuplicated Die Anfrage ist fehlgeschlagen, weil doppelte Kanäle angegeben wurden.
invalidValue (400) channelsNeeded Wenn die Eigenschaft snippet.type den Wert multipleChannels hat, muss die Eigenschaft contentDetails.channels[] angegeben werden und mindestens einen Kanal enthalten.
invalidValue (400) channelsNotExpected Die mit der Anfrage bereitgestellte Ressource hat einen Wert für die Eigenschaft contentDetails.channels[] angegeben, aber für diesen Typ von Kanalabschnitt sind keine Kanäle erforderlich.
invalidValue (400) contentDetailsNeeded Die Ressource, die Sie aktualisieren, muss für diesen Typ von Kanalabschnitt ein contentDetails-Objekt enthalten.
invalidValue (400) idInvalid Die Eigenschaft id gibt eine ungültige Kanalabschnitts-ID an.
invalidValue (400) idRequired Für die Eigenschaft id muss ein Wert angegeben werden, der den zu aktualisierenden Kanalabschnitt identifiziert.
invalidValue (400) inValidPosition Die Eigenschaft snippet.position enthält einen ungültigen Wert.
invalidValue (400) maxChannelsExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Kanäle in den Kanalabschnitt aufzunehmen.
invalidValue (400) maxPlaylistExceeded Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Playlists in den Kanalabschnitt aufzunehmen.
invalidValue (400) onePlaylistNeeded Wenn die Eigenschaft snippet.type den Wert singlePlaylist hat, muss die Eigenschaft contentDetails.playlists[] genau eine Playlist angeben.
invalidValue (400) ownChannelInChannels Sie können Ihren eigenen Kanal nicht in einen Kanalabschnitt aufnehmen, der auf diesem Kanal angezeigt wird.
invalidValue (400) playlistIsPrivate Eine oder mehrere der angegebenen Playlists sind privat und können daher nicht in den Kanalabschnitt aufgenommen werden.
invalidValue (400) playlistsDuplicated Die Anfrage ist fehlgeschlagen, weil doppelte Playlists angegeben wurden.
invalidValue (400) playlistsNeeded Wenn die Eigenschaft snippet.type den Wert singlePlaylist oder multiplePlaylists hat, muss die Eigenschaft contentDetails.playlists[] angegeben werden.
invalidValue (400) playlistsNotExpected Die mit der Anfrage bereitgestellte Ressource hat einen Wert für die Eigenschaft contentDetails.playlists[] angegeben, aber für diesen Typ von Kanalabschnitt sind keine Playlists erforderlich.
invalidValue (400) snippetNeeded Sie müssen ein snippet angeben, um den Kanalabschnitt zu aktualisieren.
invalidValue (400) titleLengthExceeded Der Wert der Eigenschaft snippet.title ist zu lang.
invalidValue (400) titleRequired Wenn die Eigenschaft snippet.type den Wert multiplePlaylists oder multipleChannels hat, müssen Sie den Titel des Abschnitts festlegen, indem Sie einen Wert für die Eigenschaft snippet.title angeben.
notFound (404) channelNotFound Einer oder mehrere der angegebenen Kanäle wurden nicht gefunden.
notFound (404) channelSectionNotFound Der Kanalabschnitt, den Sie aktualisieren möchten, wurde nicht gefunden.
notFound (404) playlistNotFound Eine oder mehrere der angegebenen Playlists wurden nicht gefunden.

Testen!

Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.