Videos: update

Die API unterstützt jetzt die Möglichkeit, Kanäle oder 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“ des jeweiligen Kanals oder Videos angibt. Die Nutzungsbedingungen für YouTube API-Dienste und die Richtlinien für Entwickler*innen wurden am 10. Januar 2020 ebenfalls aktualisiert. Weitere Informationen finden Sie in den Versionsverläufen für den YouTube Data API-Dienst und die Nutzungsbedingungen für YouTube API-Dienste.

Aktualisiert die Metadaten eines Videos.

Kontingentnutzung: Ein Aufruf dieser Methode hat eine Kontingentnutzung 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).

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

Beachten Sie, dass mit dieser Methode die vorhandenen Werte für alle änderbaren Properties überschrieben werden, die in den Teilen enthalten sind, die durch den Parameterwert angegeben werden. Die Datenschutzeinstellung eines Videos ist beispielsweise im Teil status enthalten. Wenn Sie also mit Ihrer Anfrage ein privates Video aktualisieren und der Parameterwert part der Anfrage den Teil status enthält, wird die Datenschutzeinstellung des Videos auf den Wert aktualisiert, der im Anfragetext angegeben ist. Wenn im Anfragetext kein Wert angegeben ist, wird die vorhandene Datenschutzeinstellung entfernt und das Video wird auf die Standardeinstellung zurückgesetzt.

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

Die folgende Liste enthält die Namen der part-Teile, die Sie im Parameterwert angeben können:
  • brandPartner
  • 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-Content-Partner vorgesehen.

Der onBehalfOfContentOwner Parameter gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube-CMS-Nutzer identifizieren, der im Namen des Rechteinhabers handelt, der im Parameterwert angegeben ist. Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle besitzen und verwalten. So können Rechteinhaber sich einmal authentifizieren und auf alle Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Authentifizierungsdaten angeben zu müssen. Das tatsächliche 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 gilt:

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

    • id
    • snippet.title – Diese Property ist nur erforderlich, wenn mit der Anfrage das snippet der video-Ressource aktualisiert wird.
    • snippet.categoryId – Diese Property ist nur erforderlich, wenn mit der Anfrage das snippet der video-Ressource aktualisiert wird.

  • Sie können Werte für diese Properties 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 setzen. Diese Property kann nur festgelegt werden, wenn der Datenschutzstatus des Videos private ist und das Video noch nie veröffentlicht wurde.
    • status.selfDeclaredMadeForKids
    • status.containsSyntheticMedia
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    Wenn Sie eine Aktualisierungsanfrage senden und in der Anfrage kein Wert für eine Property angegeben ist, die bereits einen Wert hat, wird der vorhandene Wert der Property gelöscht.

Antwort

Bei Erfolg gibt diese Methode im Antworttext eine Videoressource 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 finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetail Beschreibung
badRequest (400) defaultLanguageNotSet Mit der API-Anfrage wird versucht, lokalisierte Videodetails hinzuzufügen, ohne die Standardsprache der Videodetails anzugeben.
badRequest (400) invalidCategoryId Die Property snippet.categoryId gibt eine ungültige Kategorie-ID an. Verwenden Sie die Methode videoCategories.list, um unterstützte Kategorien abzurufen.
badRequest (400) invalidDefaultBroadcastPrivacySetting Mit der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für die Standardübertragung festzulegen.
badRequest (400) invalidDescription Die Anfragemetadaten geben eine ungültige Videobeschreibung an.
badRequest (400) invalidPublishAt Die Anfragemetadaten geben eine ungültige geplante Veröffentlichungszeit an.
badRequest (400) invalidRecordingDetails Das Objekt recordingDetails in den Anfragemetadaten gibt ungültige Aufnahmedetails an.
badRequest (400) invalidTags Die Anfragemetadaten geben ungültige Video-Keywords an.
badRequest (400) invalidTitle Die Anfragemetadaten geben einen ungültigen oder leeren Videotitel an.
badRequest (400) invalidVideoMetadata Die Anfragemetadaten sind ungültig.
forbidden (403) forbidden
forbidden (403) forbiddenEmbedSetting Mit der Anfrage wird versucht, eine ungültige Einbettungseinstellung für das Video festzulegen. Beachten Sie, dass einige Kanäle möglicherweise keine Berechtigung haben, eingebettete Player für Livestreams anzubieten. Weitere Informationen finden Sie in der YouTube-Hilfe.
forbidden (403) forbiddenLicenseSetting Mit der Anfrage wird versucht, eine ungültige Lizenz für das Video festzulegen.
forbidden (403) forbiddenPrivacySetting Mit der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für das Video festzulegen.
notFound (404) videoNotFound Das Video, das Sie aktualisieren möchten, wurde nicht gefunden. Prüfen Sie den Wert des Felds id im Anfragetext, um sicherzustellen, dass er korrekt ist.

Testen!

Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.