Diese Seite wurde von der Cloud Translation API übersetzt.

Channels: update

Die API unterstützt jetzt die Möglichkeit, deinen Kanal oder deine Videos als „speziell für Kinder“ zu kennzeichnen. Außerdem enthalten die Ressourcen channel und video jetzt eine Property, die den Status „speziell für Kinder“ des Kanals oder Videos angibt. Am 10. Januar 2020 wurden auch die Nutzungsbedingungen für die YouTube API-Dienste und die Richtlinien für Entwickler aktualisiert. Weitere Informationen finden Sie in den Änderungsverläufen für den YouTube Data API-Dienst und die Nutzungsbedingungen für die YouTube API-Dienste.

Aktualisiert die Metadaten eines Kanals. Diese Methode unterstützt nur Aktualisierungen der Objekte brandingSettings, invideoPromotion und localizations der channel-Ressource und ihrer untergeordneten Eigenschaften.

Auswirkung auf das Kontingent:Ein Aufruf dieser Methode hat Kontingentkosten in Höhe von 50 Einheiten.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

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

Autorisierung

Für diese Anfrage ist eine Autorisierung mit mindestens einem der folgenden Bereiche erforderlich. Weitere Informationen zu Authentifizierung und Autorisierung finden Sie unter OAuth 2.0-Autorisierung implementieren.

Umfang
`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 bei diesem Vorgang zwei Zwecken. Sie gibt die Attribute an, die durch den Schreibvorgang festgelegt werden, sowie die Attribute, die in der API-Antwort enthalten sind. Die API erlaubt nur die Einstellung des Parameterwerts auf `brandingSettings`, `invideoPromotion` oder `localizations`. (Sie können jeweils nur einen dieser Teile mit einer einzelnen Anfrage aktualisieren.) Hinweis: Mit dieser Methode werden die vorhandenen Werte für alle veränderlichen Eigenschaften überschrieben, die im Teil enthalten sind, der durch den Parameterwert angegeben wird.
Optionale Parameter
`onBehalfOfContentOwner`	`string` Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Der Parameter `onBehalfOfContentOwner` gibt an, dass der authentifizierte Nutzer im Namen des im Parameterwert angegebenen Rechteinhabers handelt. Dieser Parameter richtet sich an YouTube-Contentpartner, die viele verschiedene YouTube-Kanäle haben und verwalten. So können Rechteinhaber sich einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten 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 channel-Ressource an. Für diese Ressource gilt:

Sie müssen einen Wert für die folgenden Properties angeben:
- id
Sie können Werte für die folgenden Properties festlegen:
- brandingSettings.channel.country
- brandingSettings.channel.description
- brandingSettings.channel.defaultLanguage
- brandingSettings.channel.keywords
- brandingSettings.channel.trackingAnalyticsAccountId
- brandingSettings.channel.unsubscribedTrailer
- localizations.(key)
- localizations.(key).title
- localizations.(key).description
- status.selfDeclaredMadeForKids
Wenn Sie eine Aktualisierungsanfrage senden und in Ihrer Anfrage kein Wert für ein Attribut angegeben ist, das bereits einen Wert hat, wird der vorhandene Wert des Attributs gelöscht.

Antwort

Bei Erfolg gibt diese Methode eine channel-Ressource im Antworttext 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 findest du unter YouTube Data API – Fehler.

Fehlertyp	Fehlerdetails	Beschreibung
`badRequest (400)`	`brandingValidationError`	Einer der Werte im `brandingSettings`-Objekt konnte nicht validiert werden. Rufe mit der Methode `channels.list` die vorhandenen Einstellungen für den Kanal ab und aktualisiere die Attributwerte gemäß den Richtlinien in der `channels`-Ressourcendokumentation.
`badRequest (400)`	`channelTitleUpdateForbidden`	Wenn du die `brandingSettings part` eines Kanals aktualisierst, musst du den Wert der Property `brandingSettings.channel.title` auf den aktuellen Titel des Kanals festlegen oder die Property weglassen. Die API gibt einen Fehler zurück, wenn Sie den Wert der Property ändern.
`badRequest (400)`	`defaultLanguageNotSetError`	`defaultLanguage` muss so festgelegt sein, dass `localizations` aktualisiert wird.
`badRequest (400)`	`invalidBrandingOption`	Eine der von Ihnen angegebenen Branding-Einstellungen existiert nicht. Verwende die Methode `channels.list`, um gültige Werte abzurufen, und aktualisiere sie gemäß den Richtlinien in der `channels`-Ressourcendokumentation.
`badRequest (400)`	`invalidCustomMessage`	Die Anfragemetadaten enthalten eine ungültige benutzerdefinierte Nachricht. Prüfe den Wert des Attributs `invideoPromotion.items[].customMessage` in der Ressource, an die die Anfrage gesendet wurde.
`badRequest (400)`	`invalidDuration`	In den Anfragemetadaten ist im Abschnitt „invideoPromotion“ eine ungültige Dauer angegeben.
`badRequest (400)`	`invalidDuration`	In den Anfragemetadaten ist ein ungültiger Positionierungstyp für die Positionierung des beworbenen Artikels im Videoplayer angegeben. Prüfe den Wert des Attributs `invideoPromotion.position.type` in der Ressource, an die die Anfrage gesendet wurde.
`badRequest (400)`	`invalidRecentlyUploadedBy`	In den Anfragemetadaten ist eine ungültige Kanal-ID angegeben. Prüfe den Wert des Attributs `invideoPromotion.items[].id.recentlyUploadedBy` in der Ressource, an die die Anfrage gesendet wurde.
`badRequest (400)`	`invalidTimingOffset`	Die Anfragemetadaten enthalten im Bereich „invideoPromotion“ einen ungültigen Zeitversatz.
`badRequest (400)`	`invalidTimingOffset`	In den Anfragemetadaten ist ein ungültiger Zeitversatz für die Bestimmung angegeben, wann das beworbene Element im Videoplayer angezeigt werden soll. Prüfe den Wert des Attributs `invideoPromotion.timing.offsetMs` in der Ressource, an die die Anfrage gesendet wurde.
`badRequest (400)`	`invalidTimingType`	In den Anfragemetadaten ist eine ungültige Timing-Methode für die Bestimmung angegeben, wann das beworbene Element im Videoplayer angezeigt werden soll. Prüfe den Wert des Attributs `invideoPromotion.timing.type` in der Ressource, an die die Anfrage gesendet wurde.
`badRequest (400)`	`localizationValidationError`	Einer der Werte im Objekt „localizations“ konnte nicht validiert werden. Verwende die Methode `channels.list`, um gültige Werte abzurufen, und aktualisiere sie gemäß den Richtlinien in der Dokumentation zu Kanalressourcen.
`badRequest (400)`	`tooManyPromotedItems`	Die zulässige Anzahl von beworbenen Elementen im Bereich „invideoPromotion“ wurde überschritten.
`forbidden (403)`	`channelForbidden`	Der im Parameter `id` angegebene Channel unterstützt die Anfrage nicht oder die Anfrage ist nicht ordnungsgemäß autorisiert.
`forbidden (403)`	`promotedVideoNotAllowed`	Der Kanal, der mit der API-Anfrage aktualisiert werden soll, kann nicht gefunden werden. Prüfe den Wert der Property `id` in der `channel`-Ressource, die mit der Anfrage gesendet wurde, um sicherzustellen, dass die Kanal-ID korrekt ist.
`forbidden (403)`	`websiteLinkNotAllowed`	Die angegebene Website-URL ist nicht zulässig.
`notFound (404)`	`channelNotFound`	Der im Parameter `id` angegebene Kanal kann nicht gefunden werden.
`notFound (404)`	`channelNotFound`	Der mit dem Parameter `id` angegebene Kanal kann nicht gefunden werden oder bietet keine Branding-Optionen.
`notFound (404)`	`unknownChannelId`	Die angegebene Channel-ID wurde nicht gefunden.
`notFound (404)`	`unknownChannelId`	Die angegebene Kanal-ID von „vor Kurzem von“ wurde nicht gefunden.
`notFound (404)`	`unknownVideoId`	Die als beworbenes Element angegebene Video-ID wurde nicht gefunden.
`required (400)`	`requiredItemIdType`	In den Metadaten der Anfrage muss im Bereich „invideoPromotion“ ein Artikeltyp angegeben sein.
`required (400)`	`requiredItemId`	In den Anfragemetadaten muss im Bereich „invideoPromotion“ eine Artikel-ID angegeben werden.
`required (400)`	`requiredTimingOffset`	In den Anfragemetadaten muss ein Standard-Zeitversatz angegeben werden, damit YouTube festlegen kann, wann das beworbene Element eingeblendet werden soll. Legen Sie den Wert der `invideoPromotion.defaultTiming.offsetMs`-Eigenschaft in der Ressource fest, die die Anfrage sendet.
`required (400)`	`requiredTimingOffset`	In den Anfragemetadaten muss ein Zeitversatz angegeben werden, damit YouTube festlegen kann, wann das beworbene Element angezeigt werden soll. Legen Sie den Wert der `invideoPromotion.timing.offsetMs`-Eigenschaft in der Ressource fest, die die Anfrage sendet.
`required (400)`	`requiredTimingType`	In den Anfragemetadaten muss eine Zeitmethode angegeben werden, damit YouTube ermitteln kann, wann das beworbene Element angezeigt werden soll. Legen Sie den Wert der `invideoPromotion.defaultTiming.type`-Eigenschaft in der Ressource fest, die die Anfrage sendet.
`required (400)`	`requiredTimingType`	In den Anfragemetadaten muss eine Zeitmethode angegeben werden, damit YouTube ermitteln kann, wann das beworbene Element angezeigt werden soll. Legen Sie den Wert der `invideoPromotion.timing.type`-Eigenschaft in der Ressource fest, die die Anfrage sendet.
`required (400)`	`requiredTiming`	Die Anfragemetadaten müssen für jedes Element im `invideoPromotion`-Teil ein Timing angeben.
`required (400)`	`requiredVideoId`	In den Anfragemetadaten muss eine Video-ID angegeben werden, um das beworbene Element zu identifizieren.
`required (400)`	`requiredWebsiteUrl`	In den Anfragemetadaten muss im Bereich „invideoPromotion“ eine Website-URL angegeben werden. Legen Sie den Wert der `invideoPromotion.items[].id.websiteUrl`-Eigenschaft in der Ressource fest, die die Anfrage sendet.

Testen!

Verwenden Sie die APIs Explorer, um diese API aufzurufen und die API-Anfrage und ‑Antwort zu sehen.