Diese Seite wurde von der Cloud Translation API �bersetzt.

ChannelSections: update

Aktualisiert einen Kanalabschnitt.

Kontingentauswirkung: Ein Aufruf dieser Methode hat Kontingentkosten von 50 Einheiten.

G�ngige Anwendungsf�lle

Anfragen

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` dient in diesem Vorgang zwei Zwecken. Er gibt die Attribute an, die vom Schreibvorgang festgelegt werden, sowie die Eigenschaften, die die API-Antwort enthalten soll. Die folgende Liste enth�lt die `part`-Namen, die du in den Parameterwert aufnehmen kannst: `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-Contentpartner vorgesehen. Der Parameter `onBehalfOfContentOwner` gibt an, dass durch die Autorisierungsanmeldedaten der Anfrage ein YouTube CMS-Nutzer identifiziert wird, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Dieser Parameter ist f�r YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kan�le besitzen und verwalten. Rechteinhaber k�nnen sich nur 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:

Sie m�ssen einen Wert f�r diese Attribute 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 Ihrer Anfrage kein Wert f�r eine Eigenschaft angegeben ist, die bereits einen Wert hat, wird der vorhandene Wert der Eigenschaft gel�scht.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine channelSection-Ressource im Antworttext zur�ckgegeben.

Fehler

In der folgenden Tabelle finden Sie Fehlermeldungen, die die API als Antwort auf einen Aufruf dieser Methode zur�ckgeben k�nnte. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp	Fehlerdetails	Beschreibung
`badRequest (400)`	`notEditable`	Dieser Kanalabschnitt kann nicht bearbeitet werden.
`badRequest (400)`	`typeRequired`	Die Ressource `channelSection` muss einen Wert f�r das Feld `snippet.type` angeben.
`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 Channels ist nicht aktiv.
`invalidValue (400)`	`channelsDuplicated`	Die Anfrage ist fehlgeschlagen, weil doppelte Kan�le angegeben wurden.
`invalidValue (400)`	`channelsNeeded`	Wenn das Attribut `snippet.type` den Wert `multipleChannels` hat, muss das Attribut `contentDetails.channels[]` angegeben und mindestens einen Kanal angegeben werden.
`invalidValue (400)`	`channelsNotExpected`	Die mit der Anfrage bereitgestellte Ressource hat einen Wert f�r das Attribut `contentDetails.channels[]` angegeben. F�r diese Art von Kanalabschnitt werden jedoch keine Kan�le erwartet.
`invalidValue (400)`	`contentDetailsNeeded`	Die Ressource, die Sie aktualisieren, muss f�r diese Art von Kanalabschnitt ein `contentDetails`-Objekt enthalten.
`invalidValue (400)`	`idInvalid`	Die Eigenschaft `id` gibt eine ung�ltige Kanalabschnitts-ID an.
`invalidValue (400)`	`idRequired`	Das Attribut `id` muss einen Wert angeben, der den zu aktualisierenden Kanalabschnitt identifiziert.
`invalidValue (400)`	`inValidPosition`	Das Attribut `snippet.position` enth�lt einen ung�ltigen Wert.
`invalidValue (400)`	`maxChannelsExceeded`	Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Kan�le im Kanalabschnitt aufzunehmen.
`invalidValue (400)`	`maxPlaylistExceeded`	Die Anfrage ist fehlgeschlagen, weil versucht wurde, zu viele Playlists im 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`	Du kannst nicht deinen eigenen Kanal in einen Kanalabschnitt aufnehmen, der auf diesem Kanal angezeigt wird.
`invalidValue (400)`	`playlistIsPrivate`	Mindestens eine der angegebenen Playlists ist privat und kann daher nicht in den Kanalabschnitt aufgenommen werden.
`invalidValue (400)`	`playlistsDuplicated`	Die Anfrage ist fehlgeschlagen, weil darin doppelte Playlists angegeben wurden.
`invalidValue (400)`	`playlistsNeeded`	Wenn das Attribut `snippet.type` den Wert `singlePlaylist` oder `multiplePlaylists` hat, muss das Attribut `contentDetails.playlists[]` angegeben werden.
`invalidValue (400)`	`playlistsNotExpected`	Die mit der Anfrage bereitgestellte Ressource hat einen Wert f�r die Eigenschaft `contentDetails.playlists[]` angegeben. F�r diese Art von Kanalabschnitt werden jedoch keine Playlists erwartet.
`invalidValue (400)`	`snippetNeeded`	Du musst eine `snippet` angeben, um den Kanalabschnitt zu aktualisieren.
`invalidValue (400)`	`titleLengthExceeded`	Der Wert des Attributs `snippet.title` ist zu lang.
`invalidValue (400)`	`titleRequired`	Wenn das Attribut `snippet.type` den Wert `multiplePlaylists` oder `multipleChannels` hat, m�ssen Sie den Titel des Abschnitts festlegen, indem Sie einen Wert f�r das Attribut `snippet.title` angeben.
`notFound (404)`	`channelNotFound`	Mindestens einer der angegebenen Kan�le wurde nicht gefunden.
`notFound (404)`	`channelSectionNotFound`	Der Kanalabschnitt, den du aktualisieren m�chtest, kann nicht gefunden werden.
`notFound (404)`	`playlistNotFound`	Mindestens eine der angegebenen Playlists wurde nicht gefunden.

Jetzt testen

Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.