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 channel- und video-Ressourcen jetzt eine Property, die den Status „Speziell für Kinder“ dieses Kanals oder Videos angibt. Die Nutzungsbedingungen und Richtlinien für Entwickler der YouTube API-Dienste wurden am 10. Januar 2020 aktualisiert. Weitere Informationen finden Sie im Überarbeitungsverlauf für den YouTube Data API-Dienst und die Nutzungsbedingungen für YouTube API-Dienste.

Aktualisiert die Metadaten eines Videos

Auswirkungen auf Kontingente:Bei einem Aufruf dieser Methode fallen Kontingentkosten von 50 Einheiten an.

Gängige Anwendungsfälle

Anfragen

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 in diesem Vorgang zwei Zwecken. Damit werden die Attribute festgelegt, die der Schreibvorgang festlegt, sowie die Attribute, die in der API-Antwort enthalten sind.

Diese Methode überschreibt die vorhandenen Werte für alle änderbaren Attribute, die in den vom Parameterwert angegebenen Teilen enthalten sind. Beispielsweise sind die Datenschutzeinstellungen eines Videos im Abschnitt „status“ enthalten. 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 von der Anfrage festgelegten Wert aktualisiert. Wenn im Anfragetext kein Wert angegeben ist, wird die vorhandene Datenschutzeinstellung entfernt und das Video wird 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 du festlegen oder ändern kannst. Wenn der Parameterwert eine part angibt, die keine änderbaren Werte enthält, ist part dennoch in der API-Antwort enthalten.

Die folgende Liste enthält die part-Namen, die Sie in den Parameterwert aufnehmen können:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • 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 Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsanmeldedaten der Anfrage einen YouTube CMS-Nutzer identifizieren, der 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 einmalig authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung 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:

  • Für diese Eigenschaften müssen Sie einen Wert angeben:

    • id
    • snippet.title: Dieses Attribut ist nur erforderlich, wenn in der Anfrage snippet der Ressource video aktualisiert wird.
    • snippet.categoryId: Dieses Attribut ist nur erforderlich, wenn in der Anfrage snippet der Ressource video aktualisiert wird.

  • Sie können Werte für diese Attribute 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 dieses Attribut festgelegt haben, müssen Sie auch das Attribut status.privacyStatus auf private setzen.
    • status.selfDeclaredMadeForKids
    • recordingDetails.locationDescription (eingestellt)
    • recordingDetails.location.latitude (eingestellt)
    • recordingDetails.location.longitude (eingestellt)
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

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

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Videoressource im Antworttext zurückgegeben.

Fehler

In der folgenden Tabelle sind Fehlermeldungen aufgeführt, die von der API möglicherweise als Antwort auf einen Aufruf dieser Methode zurückgegeben werden. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSet Die API-Anfrage 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 In der Anfrage wird versucht, eine ungültige Datenschutzeinstellung für die Standardübertragung festzulegen.
badRequest (400) invalidDescription Die Metadaten der Anfrage enthalten eine ungültige Videobeschreibung.
badRequest (400) invalidPublishAt Die Metadaten der Anfrage geben einen ungültigen geplanten Veröffentlichungszeitpunkt an.
badRequest (400) invalidRecordingDetails Das Objekt recordingDetails in den Anfragemetadaten gibt ungültige Aufzeichnungsdetails an.
badRequest (400) invalidTags Die Metadaten der Anfrage enthalten ungültige Video-Keywords.
badRequest (400) invalidTitle Die Metadaten der Anfrage geben einen ungültigen oder leeren Videotitel an.
badRequest (400) invalidVideoMetadata Die Metadaten der Anfrage sind ungültig.
forbidden (403) forbidden
forbidden (403) forbiddenEmbedSetting In der Anfrage wird versucht, eine ungültige Einbettungseinstellung für das Video festzulegen. Beachte, dass einige Kanäle möglicherweise nicht dazu berechtigt sind, eingebettete Player für Livestreams anzubieten. Weitere Informationen finden Sie in der YouTube-Hilfe.
forbidden (403) forbiddenLicenseSetting Es wird versucht, eine ungültige Lizenz für das Video festzulegen.
forbidden (403) forbiddenPrivacySetting Es 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, ob der Wert des Felds id im Anfragetext korrekt ist.

Testen!

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