Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

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.

ChannelSections: update Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.