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.