Channels: update

Mit der API kannst du jetzt deinen Kanal oder deine Videos als „speziell für Kinder“ kennzeichnen. Darüber hinaus enthalten die Ressourcen von channel und video jetzt ebenfalls eine Property, die den Status „Speziell für Kinder“ des Kanals oder Videos identifiziert. Die Nutzungsbedingungen für die YouTube API-Dienste und die Richtlinien für Entwickler wurden ebenfalls am 10. Januar 2020 aktualisiert. Weitere Informationen finden Sie im Überarbeitungsverlauf für den YouTube Data API-Dienst und in den Nutzungsbedingungen der YouTube API-Dienste.

Aktualisiert die Metadaten eines Kanals. Beachten Sie, dass diese Methode derzeit nur Aktualisierungen der brandingSettings-, invideoPromotion- und localizations-Objekte der channel-Ressource und ihrer untergeordneten Attribute unterstützt.

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

Gängige Anwendungsfälle

Anfragen

HTTP-Anfrage

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

Autorisierung

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

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 in diesem Vorgang zwei Zwecken. Sie identifiziert die Attribute, die vom Schreibvorgang festgelegt werden, sowie die Attribute, die die API-Antwort enthalten soll.

Derzeit lässt die API nur zu, dass der Parameterwert entweder auf brandingSettings, invideoPromotion oder localizations festgelegt wird. Jeder dieser Teile kann nur mit einer einzigen Anfrage aktualisiert werden.

Hinweis: Mit dieser Methode werden die vorhandenen Werte für alle änderbaren Eigenschaften überschrieben, die in dem Teil enthalten sind, der mit dem Parameterwert angegeben ist.
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 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 eigentliche CMS-Konto, bei dem sich der Nutzer authentifiziert hat, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft werden.

Anfragetext

Geben Sie im Anfragetext eine Kanalressource an. Für diese Ressource:

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

    • id

  • Sie können Werte für diese Eigenschaften 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 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 Kanalressource 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) brandingValidationError Einer der Werte im Objekt brandingSettings konnte nicht validiert werden. Verwenden Sie die Methode channels.list, um die vorhandenen Einstellungen für den Kanal abzurufen, und aktualisieren Sie die Attributwerte gemäß den Richtlinien in der Dokumentation zur Ressource channels.
badRequest (400) channelTitleUpdateForbidden Wenn du den brandingSettings part eines Kanals aktualisierst, musst du den Wert der brandingSettings.channel.title-Eigenschaft auf den aktuellen Titel des Kanals festlegen oder die Eigenschaft weglassen. Die API gibt einen Fehler zurück, wenn Sie den Wert der Eigenschaft ändern.
badRequest (400) defaultLanguageNotSetError defaultLanguage muss zum Aktualisieren von localizations festgelegt werden.
badRequest (400) invalidBrandingOption Eine der von Ihnen angegebenen Branding-Einstellungen ist nicht vorhanden. Verwenden Sie die Methode channels.list, um gültige Werte abzurufen, und aktualisieren Sie sie gemäß den Richtlinien in der Dokumentation zu channels-Ressourcen.
badRequest (400) invalidCustomMessage Die Metadaten der Anfrage enthalten eine ungültige benutzerdefinierte Nachricht. Prüfen Sie den Wert des Attributs invideoPromotion.items[].customMessage in der Ressource, die die Anfrage gesendet hat.
badRequest (400) invalidDuration Die Metadaten der Anfrage geben im invideoPromotion-Teil eine ungültige Dauer an.
badRequest (400) invalidDuration Die Metadaten der Anfrage enthalten einen ungültigen Positionstyp, mit dem bestimmt wird, wie das beworbene Element im Videoplayer positioniert wird. Prüfen Sie den Wert des Attributs invideoPromotion.position.type in der Ressource, die die Anfrage gesendet hat.
badRequest (400) invalidRecentlyUploadedBy Die Metadaten der Anfrage enthalten eine ungültige Kanal-ID. Prüfen Sie den Wert des Attributs invideoPromotion.items[].id.recentlyUploadedBy in der Ressource, die die Anfrage gesendet hat.
badRequest (400) invalidTimingOffset Die Metadaten der Anfrage geben im invideoPromotion-Teil einen ungültigen Zeitversatz an.
badRequest (400) invalidTimingOffset Die Metadaten der Anfrage geben einen ungültigen Zeitversatz an, anhand dessen festgelegt wird, wann das beworbene Element im Videoplayer angezeigt werden soll. Prüfen Sie den Wert des Attributs invideoPromotion.timing.offsetMs in der Ressource, die die Anfrage gesendet hat.
badRequest (400) invalidTimingType Die Metadaten der Anfrage enthalten eine ungültige Zeitmethode zur Bestimmung, wann das beworbene Element im Videoplayer angezeigt wird. Prüfen Sie den Wert des Attributs invideoPromotion.timing.type in der Ressource, die die Anfrage gesendet hat.
badRequest (400) localizationValidationError Einer der Werte im Lokalisierungsobjekt konnte nicht validiert werden. Verwenden Sie die Methode channels.list, um gültige Werte abzurufen, und aktualisieren Sie sie unbedingt gemäß den Richtlinien in der Dokumentation zu Channels-Ressourcen.
badRequest (400) tooManyPromotedItems Die Anzahl der zulässigen beworbenen Artikel wurde im Abschnitt „invideoPromotion“ überschritten.
forbidden (403) channelForbidden Der im id-Parameter angegebene Kanal unterstützt die Anfrage nicht oder die Anfrage ist nicht ordnungsgemäß autorisiert.
forbidden (403) promotedVideoNotAllowed Der Kanal, den die API-Anfrage zu aktualisieren versucht, kann nicht gefunden werden. Prüfe den Wert der Eigenschaft id in der Ressource channel, die in 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 id-Parameter angegebene Kanal wurde nicht gefunden.
notFound (404) channelNotFound Der durch den Parameter id angegebene Kanal wurde nicht gefunden oder verfügt nicht über Brandingoptionen.
notFound (404) unknownChannelId Die angegebene Kanal-ID wurde nicht gefunden.
notFound (404) unknownChannelId Die angegebene Kanal-ID "latestUploadedBy" wurde nicht gefunden.
notFound (404) unknownVideoId Die Video-ID, die als beworbener Artikel angegeben wurde, wurde nicht gefunden.
required (400) requiredItemIdType In den Metadaten der Anfrage muss ein Elementtyp im invideoPromotion-Teil angegeben werden.
required (400) requiredItemId Die Metadaten der Anfrage müssen eine Element-ID im invideoPromotion-Teil angeben.
required (400) requiredTimingOffset In den Metadaten der Anfrage muss ein standardmäßiger Zeitversatz angegeben werden, damit YouTube bestimmen kann, wann das beworbene Element eingeblendet wird. Legen Sie den Wert des Attributs invideoPromotion.defaultTiming.offsetMs in der Ressource fest, die die Anfrage sendet.
required (400) requiredTimingOffset In den Metadaten der Anfrage muss ein Zeitversatz angegeben werden, damit YouTube bestimmen kann, wann das beworbene Element eingeblendet wird. Legen Sie den Wert des Attributs invideoPromotion.timing.offsetMs in der Ressource fest, die die Anfrage sendet.
required (400) requiredTimingType In den Metadaten der Anfrage muss eine Zeitmethode angegeben werden, damit YouTube bestimmen kann, wann das beworbene Element erscheint. Legen Sie den Wert des Attributs invideoPromotion.defaultTiming.type in der Ressource fest, die die Anfrage sendet.
required (400) requiredTimingType In den Metadaten der Anfrage muss eine Zeitmethode angegeben werden, damit YouTube bestimmen kann, wann das beworbene Element erscheint. Legen Sie den Wert des Attributs invideoPromotion.timing.type in der Ressource fest, die die Anfrage sendet.
required (400) requiredTiming In den Metadaten der Anfrage muss für jedes Element im invideoPromotion-Teil eine Zeitangabe angegeben sein.
required (400) requiredVideoId In den Metadaten der Anfrage muss eine Video-ID angegeben werden, um das beworbene Element zu identifizieren.
required (400) requiredWebsiteUrl In den Metadaten der Anfrage muss im invideoPromotion-Teil eine Website-URL angegeben werden. Legen Sie den Wert des Attributs invideoPromotion.items[].id.websiteUrl in der Ressource fest, die die Anfrage sendet.

Jetzt testen

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