LiveBroadcasts: update

Aktualisiert eine Übertragung. Sie können beispielsweise die Übertragungseinstellungen ändern, die im contentDetails-Objekt der liveBroadcast-Ressource definiert sind.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

PUT https://www.googleapis.com/youtube/v3/liveBroadcasts

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

Die part-Eigenschaften, die Sie in den Parameterwert aufnehmen können, sind id, snippet, contentDetails, monetizationDetails und status.

Hinweis: Mit dieser Methode werden die vorhandenen Werte für alle veränderbaren Eigenschaften überschrieben, die in den Teilen enthalten sind, die im Parameterwert angegeben sind. Der Datenschutzstatus einer Übertragung wird beispielsweise im Abschnitt status definiert. Wenn Ihre Anfrage also eine private oder nicht gelistete Übertragung aktualisiert und der Parameterwert part der Anfrage den Teil status enthält, wird die Datenschutzeinstellung des Broadcasts auf den im Anfragetext angegebenen Wert aktualisiert. Wenn im Anfragetext kein Wert angegeben ist, wird die bestehende Datenschutzeinstellung entfernt und der Broadcast wird auf die standardmäßige Datenschutzeinstellung zurückgesetzt.
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 Nutzer des YouTube-CMS (Content-Management-System) 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.
onBehalfOfContentOwnerChannel 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 onBehalfOfContentOwnerChannel gibt die YouTube-Kanal-ID des Kanals an, dem ein Video hinzugefügt wird. Dieser Parameter ist erforderlich, wenn in einer Anfrage ein Wert für den Parameter onBehalfOfContentOwner angegeben wird. Er kann nur in Verbindung mit diesem Parameter verwendet werden. Außerdem muss die Anfrage mit einem CMS-Konto autorisiert werden, das mit dem Rechteinhaber verknüpft ist, der im Parameter onBehalfOfContentOwner angegeben ist. Der Kanal, der mit dem Parameterwert onBehalfOfContentOwnerChannel angegeben ist, muss mit dem Rechteinhaber verknüpft sein, der mit dem Parameter onBehalfOfContentOwner angegeben ist.

Dieser Parameter ist für YouTube-Inhaltspartner gedacht, die viele verschiedene YouTube-Kanäle haben und verwalten. So können sich Rechteinhaber einmal authentifizieren und Aktionen im Namen des im Parameterwert angegebenen Kanals ausführen, ohne für jeden einzelnen Kanal Anmeldedaten angeben zu müssen.

Anfragetext

Gib im Anfragetext eine liveBroadcast-Ressource an. Für diese Ressource:

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

    • id
    • snippet.scheduledStartTime
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs

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

    • snippet.title
    • snippet.description
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • monetizationDetails.cuepointSchedule.pauseAdsUntil

    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 liveBroadcast-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 finden Sie in der Fehlermeldung.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) closedCaptionsTypeModificationNotAllowed Der Wert contentDetails.closedCaptionsType kann nur geändert werden, wenn die Übertragung den Status created oder ready hat.
forbidden (403) enabledModificationNotAllowed Das Feld enabled ist schreibgeschützt.
forbidden (403) scheduleStrategyModificationNotAllowed Das Feld scheduleStrategy ist schreibgeschützt.
forbidden (403) repeatIntervalSecsModificationNotAllowed Das Feld repeatIntervalSecs ist schreibgeschützt.
forbidden (403) pauseAdsUntilModificationNotAllowed Das Feld „pauseAdsUntil“ kann nicht geändert werden. Dieser Fehler kann folgende Ursachen haben:
  • Das Feld monetizationDetails.cuepointSchedule.enabled ist nicht auf true gesetzt. Dieses Feld kann nur in YouTube Studio festgelegt werden.
  • Die Übertragung ist nicht live.
forbidden (403) enableAutoStartModificationNotAllowed Der Wert contentDetails.enableAutoStart kann nur geändert werden, wenn der Stream inaktiv ist und die Übertragung den Status created oder ready hat.
forbidden (403) enableClosedCaptionsModificationNotAllowed Der Wert contentDetails.enableClosedCaptions kann nur geändert werden, wenn der Broadcast-Status created oder ready ist.
forbidden (403) enableDvrModificationNotAllowed Der Wert contentDetails.enableDvr kann nur geändert werden, wenn der Status der Übertragung created oder ready ist.
forbidden (403) enableMonitorStreamModificationNotAllowed Der Wert contentDetails.monitorStream.enableMonitorStream kann nur geändert werden, wenn der Status der Übertragung created oder ready ist.
forbidden (403) recordFromStartModificationNotAllowed Der Wert contentDetails.recordFromStart kann nur geändert werden, wenn der Broadcast-Status created oder ready ist.
insufficientPermissions insufficientLivePermissions Die Anfrage ist nicht berechtigt, die angegebene Liveübertragung zu aktualisieren. Weitere Informationen finden Sie unter OAuth2-Authentifizierung implementieren.
insufficientPermissions liveStreamingNotEnabled Der Nutzer, der die Anfrage autorisiert hat, ist nicht berechtigt, Livevideos auf YouTube zu streamen. Weitere Informationen finden Nutzer unter https://www.youtube.com/features.
invalidValue (400) invalidAutoStart Die Ressource liveBroadcast enthält einen ungültigen Wert für das Attribut contentDetails.enableAutoStart. Die Einstellung enableAutoStart kann für eine persistente Übertragung nicht geändert werden.
invalidValue (400) invalidAutoStop Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die Eigenschaft contentDetails.enableAutoStop. Sie können die Einstellung enableAutoStop für eine persistente Übertragung nicht ändern.
invalidValue (400) invalidDescription Für die liveBroadcast-Ressource wurde kein gültiger Wert für die Property snippet.description angegeben. snippet.description kann bis zu 5.000 Zeichen enthalten.
invalidValue (400) invalidEmbedSetting Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die Eigenschaft contentDetails.enable_embed. Du kannst diese Übertragung nicht einbetten.
invalidValue (400) invalidEnableClosedCaptions In der liveBroadcast-Ressource ist der Wert des Attributs contentDetails.enableClosedCaptions mit dem Wert der contentDetails.closedCaptionType-Einstellung nicht kompatibel. Ändern Sie die Ressource so, dass sie nur eine der beiden Properties enthält, und reichen Sie die Anfrage noch einmal ein.
invalidValue (400) invalidLatencyPreferenceOptions Die Ressource liveBroadcast enthält einen ungültigen Wert für das Attribut contentDetails.latencyPreference. Bei dieser Latenzeinstellung werden nicht alle Einstellungen unterstützt.
invalidValue (400) invalidPauseAdsUntil Die liveBroadcast-Ressource enthält einen ungültigen Wert für die Eigenschaft monetizationDetails.cuepointSchedule.pauseAdsUntil. Dieser Fehler kann folgende Ursachen haben:
  • Der Wert für monetizationDetails.cuepointSchedule.pauseAdsUntil ist nicht im ISO 8601-Format (TT. JJJJ-MM-TTThh:mm:ss.sZ) angegeben.
  • Der Wert von monetizationDetails.cuepointSchedule.pauseAdsUntil liegt nicht in der Zukunft.
  • Der monetizationDetails.cuepointSchedule.pauseAdsUntil-Wert liegt mehr als 10 Minuten in der Zukunft.
invalidValue (400) invalidPrivacyStatus Für die liveBroadcast-Ressource wurde kein gültiger Datenschutzstatus angegeben. Gültige Werte für privacyStatus
invalidValue (400) invalidProjection Die Ressource liveBroadcast enthielt einen ungültigen Wert für das Attribut contentDetails.projection. Die Projektion einer dauerhaften Übertragung kann nicht auf 360 Grad festgelegt werden.
invalidValue (400) invalidScheduledEndTime Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die Eigenschaft snippet.scheduledEndTime. Das geplante Ende muss nach dem geplanten Beginn liegen.
invalidValue (400) invalidScheduledStartTime Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die Eigenschaft snippet.scheduledStartTime. Der geplante Beginn muss in der Zukunft liegen.
invalidValue (400) invalidTitle Für die liveBroadcast-Ressource wurde kein gültiger Wert für die Property snippet.title angegeben. snippet.title muss zwischen 1 und 100 Zeichen lang sein.
notFound (404) liveBroadcastNotFound Für die in der liveBroadcast-Ressource angegebene Property id wurde keine Übertragung gefunden.
required (400) broadcastStreamDelayMsRequired Für die liveBroadcast-Ressource wurde das Attribut contentDetails.monitorStream.broadcastStreamDelayMs nicht angegeben.
required (400) enableMonitorStreamRequired Für die liveBroadcast-Ressource wurde das Attribut contentDetails.monitorStream.enableMonitorStream nicht angegeben.
required (400) idRequired Die liveBroadcast-Ressource muss einen Wert für das Attribut id enthalten und angeben.
required (400) scheduledEndTimeRequired Die liveBroadcast-Ressource hat das Attribut snippet.scheduledEndTime nicht angegeben.
required (400) scheduledStartTimeRequired Die liveBroadcast-Ressource hat das Attribut snippet.scheduledStartTime nicht angegeben.

Testen!

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