LiveBroadcasts: update

Aktualisiert eine Übertragung. Du kannst beispielsweise die Übertragungseinstellungen ändern, die im contentDetails-Objekt der Ressource liveBroadcast definiert sind.

Gängige Anwendungsfälle

Anfragen

HTTP-Anfrage

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

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/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. Sie identifiziert die Eigenschaften, die durch den Schreibvorgang festgelegt werden, sowie die Eigenschaften, die die API-Antwort enthält.

Die part-Eigenschaften, die du in den Parameterwert aufnehmen kannst, sind id, snippet, contentDetails, monetizationDetails und status.

Beachten Sie, dass diese Methode die vorhandenen Werte für alle änderbaren Eigenschaften überschreibt, die in den Teilen enthalten sind, die der Parameterwert angibt. Der Datenschutzstatus einer Übertragung wird beispielsweise im status-Teil definiert. Wenn also mit deiner Anfrage eine private oder nicht gelistete Übertragung aktualisiert wird und der Parameterwert part der Anfrage den Teil status enthält, wird die Datenschutzeinstellung der Übertragung auf den Wert aktualisiert, der im Anfragetext angegeben ist. Wenn im Anfragetext kein Wert angegeben ist, wird die vorhandene Datenschutzeinstellung entfernt und die Übertragung auf die standardmäßige Datenschutzeinstellung zurückgesetzt.
Optionale Parameter
onBehalfOfContentOwner string
Dieser Parameter kann nur in einer korrekt autorisierten Anfrage verwendet werden. Hinweis: Dieser Parameter ist ausschließlich für YouTube-Contentpartner vorgesehen.

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 ist für YouTube-Contentpartner gedacht, die viele verschiedene YouTube-Kanäle haben und verwalten. Rechteinhaber können sich nur einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung 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 korrekt autorisierten Anfrage verwendet werden. Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Hinweis:Dieser Parameter ist ausschließlich für YouTube-Contentpartner vorgesehen.

Der Parameter onBehalfOfContentOwnerChannel gibt die YouTube-Kanal-ID des Kanals an, zu dem ein Video hinzugefügt wird. Dieser Parameter ist erforderlich, wenn in einer Anfrage ein Wert für den Parameter onBehalfOfContentOwner angegeben wird, und kann nur in Verbindung mit diesem Parameter verwendet werden. Außerdem muss die Anfrage über ein CMS-Konto autorisiert werden, das mit dem Rechteinhaber verknüpft ist, der durch den Parameter onBehalfOfContentOwner angegeben wird. Schließlich muss der Kanal, den der Parameterwert onBehalfOfContentOwnerChannel angibt, mit dem Rechteinhaber verknüpft werden, der durch den Parameter onBehalfOfContentOwner angegeben wird.

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

Anfragetext

Geben Sie 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 Anforderung kein Wert für ein Attribut angegeben ist, das bereits einen Wert hat, wird der vorhandene Wert der Eigenschaft gelöscht.

Antwort

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

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 zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) closedCaptionsTypeModificationNotAllowed Der Wert für 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 festgelegt. Dieses Feld kann nur in YouTube Studio festgelegt werden.
  • Die Übertragung ist nicht live.
forbidden (403) enableAutoStartModificationNotAllowed Der Wert für 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 für contentDetails.enableClosedCaptions kann nur geändert werden, wenn der Status der Übertragung created oder ready ist.
forbidden (403) enableDvrModificationNotAllowed Der Wert für contentDetails.enableDvr kann nur geändert werden, wenn der Status der Übertragung created oder ready ist.
forbidden (403) enableMonitorStreamModificationNotAllowed Der Wert für contentDetails.monitorStream.enableMonitorStream kann nur geändert werden, wenn der Status der Übertragung created oder ready ist.
forbidden (403) recordFromStartModificationNotAllowed Der Wert für contentDetails.recordFromStart kann nur geändert werden, wenn der Status der Übertragung created oder ready ist.
insufficientPermissions insufficientLivePermissions Die Anfrage ist nicht autorisiert, die angegebene Liveübertragung zu aktualisieren. Weitere Informationen finden Sie unter OAuth2-Authentifizierung implementieren.
insufficientPermissions liveStreamingNotEnabled Der Nutzer, der die Anfrage autorisiert hat, kann kein Live-Video auf YouTube streamen. Weitere Informationen findet der Nutzer unter https://www.youtube.com/features.
invalidValue (400) invalidAutoStart Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das Attribut contentDetails.enableAutoStart. Die Einstellung enableAutoStart kann für eine dauerhafte Übertragung nicht geändert werden.
invalidValue (400) invalidAutoStop Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das Attribut contentDetails.enableAutoStop. Sie können die Einstellung enableAutoStop für eine dauerhafte Übertragung nicht ändern.
invalidValue (400) invalidDescription Die liveBroadcast-Ressource hat für das Attribut snippet.description keinen gültigen Wert angegeben. snippet.description kann bis zu 5.000 Zeichen enthalten.
invalidValue (400) invalidEmbedSetting Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das Attribut contentDetails.enable_embed. Du kannst diese Übertragung nicht einbetten.
invalidValue (400) invalidEnableClosedCaptions In der liveBroadcast-Ressource ist der Wert des Attributs contentDetails.enableClosedCaptions nicht mit dem Wert der Einstellung contentDetails.closedCaptionType kompatibel. Ändern Sie die Ressource so, dass sie nur eine der beiden Eigenschaften enthält, und reichen Sie die Anfrage dann noch einmal ein.
invalidValue (400) invalidLatencyPreferenceOptions Die liveBroadcast-Ressource enthielt 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 das Attribut monetizationDetails.cuepointSchedule.pauseAdsUntil. Dieser Fehler kann folgende Ursachen haben:
  • Der Wert monetizationDetails.cuepointSchedule.pauseAdsUntil ist nicht im Format ISO 8601 (JJJJ-MM-TTThh:mm:ss.sZ) angegeben.
  • Der Wert für monetizationDetails.cuepointSchedule.pauseAdsUntil liegt nicht in der Zukunft.
  • Der Wert für monetizationDetails.cuepointSchedule.pauseAdsUntil liegt mehr als 10 Minuten von der aktuellen Uhrzeit entfernt.
invalidValue (400) invalidPrivacyStatus Die liveBroadcast-Ressource hat keinen gültigen Datenschutzstatus angegeben. Siehe Gültige privacyStatus-Werte.
invalidValue (400) invalidProjection Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das Attribut contentDetails.projection. Die Projektion einer dauerhaften Übertragung kann nicht auf 360 festgelegt werden.
invalidValue (400) invalidScheduledEndTime Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das Attribut snippet.scheduledEndTime. Das geplante Ende muss nach dem geplanten Beginn liegen.
invalidValue (400) invalidScheduledStartTime Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das Attribut snippet.scheduledStartTime. Der geplante Beginn muss in der Zukunft liegen.
invalidValue (400) invalidTitle Die liveBroadcast-Ressource hat für das Attribut snippet.title keinen gültigen Wert angegeben. snippet.title muss zwischen 1 und 100 Zeichen lang sein.
notFound (404) liveBroadcastNotFound Die in der liveBroadcast-Ressource angegebene id-Property hat keine Übertragung identifiziert.
required (400) broadcastStreamDelayMsRequired Die liveBroadcast-Ressource hat das Attribut contentDetails.monitorStream.broadcastStreamDelayMs nicht angegeben.
required (400) enableMonitorStreamRequired Die liveBroadcast-Ressource hat 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.

Jetzt testen

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