Videos: 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 auch eine Property, die den Status „Speziell für Kinder“ dieses Kanals oder Videos angibt. Die Nutzungsbedingungen der YouTube API-Dienste und die Richtlinien für Entwickler wurden ebenfalls am 10. Januar 2020 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 Videos.

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/videos

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 bei diesem Vorgang zwei Zwecken. Sie gibt die Properties an, die durch den Schreibvorgang festgelegt werden, sowie die Properties, die in der API-Antwort enthalten sein sollen.

Hinweis: Mit dieser Methode werden die vorhandenen Werte für alle veränderbaren Properties überschrieben, die in den Teilen enthalten sind, die durch den Parameterwert angegeben werden. Die Datenschutzeinstellung eines Videos befindet sich beispielsweise im Bereich status. Wenn deine Anfrage also ein privates Video aktualisiert und der part-Parameterwert der Anfrage den status-Teil enthält, wird die Datenschutzeinstellung des Videos auf den im Anfragetext angegebenen Wert aktualisiert. Wenn im Anfragetext kein Wert angegeben ist, wird die bestehende Datenschutzeinstellung entfernt und das Video auf die standardmäßige Datenschutzeinstellung zurückgesetzt.

Außerdem enthalten nicht alle Teile Eigenschaften, die beim Einfügen oder Aktualisieren eines Videos festgelegt werden können. Das Objekt statistics enthält beispielsweise Statistiken, die YouTube für ein Video berechnet, und enthält keine Werte, die Sie festlegen oder ändern können. Wenn im Parameterwert ein part angegeben ist, das keine veränderbaren Werte enthält, wird dieser part trotzdem in der API-Antwort enthalten sein.

Die folgende Liste enthält die part-Namen, die Sie in den Parameterwert aufnehmen können:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • paidProductPlacementDetails
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
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 gedacht.

Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube CMS-Nutzer identifizieren, der 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 Videoressource an. Für diese Ressource:

  • Sie müssen einen Wert für die folgenden Properties angeben:

    • id
    • snippet.title: Diese Property ist nur erforderlich, wenn die Anfrage die snippet der video-Ressource aktualisiert.
    • snippet.categoryId: Diese Property ist nur erforderlich, wenn die Anfrage die snippet der video-Ressource aktualisiert.

  • Sie können Werte für diese Eigenschaften festlegen:

    • snippet.categoryId
    • snippet.defaultLanguage
    • snippet.description
    • snippet.tags[]
    • snippet.title
    • status.embeddable
    • status.license
    • status.privacyStatus
    • status.publicStatsViewable
    • status.publishAt: Wenn Sie einen Wert für diese Property festlegen, müssen Sie auch die Property status.privacyStatus auf private festlegen.
    • status.selfDeclaredMadeForKids
    • status.containsSyntheticMedia
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    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 Videoressource im Antworttext zurück.

Fehler

In der folgenden Tabelle sind Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. Weitere Informationen finden Sie in der Dokumentation zur Fehlermeldung.

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSet Bei der API-Anfrage werden lokalisierte Videodetails hinzugefügt, ohne die Standardsprache der Videodetails anzugeben.
badRequest (400) invalidCategoryId Für die Property snippet.categoryId ist eine ungültige Kategorie-ID angegeben. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
badRequest (400) invalidDefaultBroadcastPrivacySetting Bei der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für die Standardübertragung festzulegen.
badRequest (400) invalidDescription Die Anfragemetadaten enthalten eine ungültige Videobeschreibung.
badRequest (400) invalidPublishAt In den Anfragemetadaten ist ein ungültiger Zeitpunkt für die geplante Veröffentlichung angegeben.
badRequest (400) invalidRecordingDetails Das recordingDetails-Objekt in den Anfragemetadaten enthält ungültige Aufnahmedetails.
badRequest (400) invalidTags Die Anfragemetadaten enthalten ungültige Video-Keywords.
badRequest (400) invalidTitle In den Anfragemetadaten ist ein ungültiger oder leerer Videotitel angegeben.
badRequest (400) invalidVideoMetadata Die Metadaten der Anfrage sind ungültig.
forbidden (403) forbidden
forbidden (403) forbiddenEmbedSetting Bei der Anfrage wird versucht, eine ungültige Einbettungseinstellung für das Video festzulegen. Beachte, dass einige Kanäle möglicherweise nicht berechtigt sind, eingebettete Player für Livestreams anzubieten. Weitere Informationen findest du in der YouTube-Hilfe.
forbidden (403) forbiddenLicenseSetting Bei der Anfrage wird versucht, eine ungültige Lizenz für das Video festzulegen.
forbidden (403) forbiddenPrivacySetting Bei der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für das Video festzulegen.
notFound (404) videoNotFound Das Video, das du aktualisieren möchtest, wurde nicht gefunden. Prüfen Sie den Wert des Felds id im Anfragetext, um sicherzustellen, dass er korrekt ist.

Testen!

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