Playlists: update

Eine Playlist wird geändert. Du kannst beispielsweise den Titel, die Beschreibung oder den Datenschutzstatus einer Playlist ändern.

Auswirkungen 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/playlists

Autorisierung

Für diese Anfrage ist eine Autorisierung mit mindestens einem der folgenden Bereiche erforderlich. Weitere Informationen zu Authentifizierung und Autorisierung finden Sie unter OAuth 2.0-Autorisierung implementieren.

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 Eigenschaften an, die durch den Schreibvorgang festgelegt werden, sowie die Eigenschaften, die in der API-Antwort enthalten sein sollen.

Hinweis: Mit dieser Methode werden die vorhandenen Werte für veränderliche Eigenschaften überschrieben, die in allen Teilen enthalten sind, die im Anfragetext angegeben sind. Die Beschreibung einer Playlist ist beispielsweise im Teil snippet enthalten, der im Anfragetext enthalten sein muss. Wenn in der Anfrage kein Wert für die Eigenschaft snippet.description angegeben ist, wird die vorhandene Beschreibung der Playlist gelöscht.

Die folgende Liste enthält die part-Namen, die du in den Parameterwert aufnehmen kannst:
  • contentDetails
  • id
  • localizations
  • player
  • snippet
  • status
Optionale Parameter
onBehalfOfContentOwner string
Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden.

Hinweis:Dieser Parameter ist ausschließlich für YouTube-Inhaltspartner 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 playlist-Ressource an.

Für diese Ressource gilt Folgendes:

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

    • id
    • snippet.title

  • Sie können Werte für die folgenden Properties festlegen:

    • snippet.title
    • snippet.description
    • status.privacyStatus
    • status.podcastStatus
    • snippet.defaultLanguage
    • 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 playlist-Ressource im Antworttext 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 findest du unter YouTube Data API – Fehler.

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) defaultLanguageNotSetError defaultLanguage muss so festgelegt sein, dass localizations aktualisiert wird.
badRequest (400) localizationValidationError Einer der Werte im Objekt „localizations“ konnte nicht validiert werden. Verwende die Methode playlists.list, um gültige Werte abzurufen, und aktualisiere sie gemäß den Richtlinien in der Playlist-Ressourcendokumentation.
forbidden (403) playlistForbidden Dieser Vorgang ist verboten oder die Anfrage ist nicht ordnungsgemäß autorisiert.
invalidValue (400) invalidPlaylistSnippet Die Anfrage enthält ein ungültiges Playlist-Snippet.
notFound (404) playlistNotFound Die Playlist, die mit dem id-Parameter der Anfrage angegeben wurde, kann nicht gefunden werden.
required (400) playlistTitleRequired Bei der Anfrage muss der Titel der Playlist angegeben werden.
invalidValue (400) playlistOperationUnsupported Die API unterstützt nicht die Möglichkeit, die angegebene Playlist zu aktualisieren. So kannst du beispielsweise die Eigenschaften der Playlist mit deinen hochgeladenen Videos nicht aktualisieren.

Testen!

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