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 zur Authentifizierung und Autorisierung finden Sie unter OAuth 2.0-Autorisierung implementieren.

Bereich
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 dieser Operation zwei Funktionen. Er gibt die Attribute an, die durch die Schreiboperation festgelegt werden, sowie die Attribute, die in der API-Antwort enthalten sein sollen.

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

Beachten Sie, dass mit dieser Methode die vorhandenen Werte für alle veränderlichen Attribute überschrieben werden, die in den Teilen enthalten sind, die im Parameterwert angegeben sind. Der Datenschutzstatus einer Übertragung wird beispielsweise im Teil status definiert. Wenn Sie also eine private oder nicht gelistete Übertragung aktualisieren 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 wird auf die Standardeinstellung für den Datenschutz 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-Content-Partner vorgesehen.

Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsanmeldedaten der Anfrage einen Nutzer des YouTube-Content-Management-Systems (CMS) identifizieren, der im Namen des im Parameterwert angegebenen Content-Inhabers handelt. Dieser Parameter ist für YouTube-Content-Partner vorgesehen, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Content-Inhaber können sich einmal authentifizieren und auf alle Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Authentifizierungsdaten 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-Content-Partner vorgesehen.

Der onBehalfOfContentOwnerChannel Parameter 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 ist. Er kann nur in Verbindung mit diesem Parameter verwendet werden. Außerdem muss die Anfrage mit einem CMS-Konto autorisiert werden, das mit dem Content-Inhaber verknüpft ist, der im Parameter onBehalfOfContentOwner angegeben ist. Schließlich muss der Kanal, der im Parameterwert onBehalfOfContentOwnerChannel angegeben ist, mit dem Content-Inhaber verknüpft sein, der im Parameter onBehalfOfContentOwner angegeben ist.

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

Anfragetext

Geben Sie im Anfragetext eine liveBroadcast-Ressource an. Für diese Ressource gilt Folgendes:

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

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

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

    • snippet.title
    • snippet.description
    • snippet.categoryId
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.availabilityConfig
    • monetizationDetails.adsMonetizationStatus
    • monetizationDetails.cuepointSchedule.enabled
    • monetizationDetails.cuepointSchedule.pauseAdsUntil
    • monetizationDetails.cuepointSchedule.ytOptimizedCuepointConfig
    • monetizationDetails.cuepointSchedule.creatorCuepointConfig.scheduleStrategy
    • monetizationDetails.cuepointSchedule.creatorCuepointConfig.repeatIntervalSecs

    Wenn Sie eine Aktualisierungsanfrage senden und in der Anfrage kein Wert für ein Attribut angegeben ist, für das bereits ein Wert vorhanden ist, 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 von der API als Antwort auf einen Aufruf dieser Methode zurückgegeben werden können. Weitere Informationen finden Sie in der Fehlermeldung.

Fehlertyp Fehlerdetail Beschreibung
backendError (503) backendError Einige Einstellungen können noch nicht angewendet werden. Das liegt wahrscheinlich daran, dass die Übertragung gerade erst erstellt wurde. Bitte versuchen Sie es in einigen Sekunden noch einmal.
forbidden (403) closedCaptionsTypeModificationNotAllowed Der Wert von contentDetails.closedCaptionsType kann nur geändert werden, wenn sich die Übertragung im Status created oder ready befindet.
forbidden (403) monetizationDetailsModificationNotAllowed Kanäle, die nicht am YouTube-Partnerprogramm (YPP) teilnehmen, können monetizationDetails für ein Video nicht ändern.
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 von contentDetails.enableAutoStart kann nur geändert werden, wenn der Stream inaktiv ist und sich die Übertragung im Status created oder ready befindet.
forbidden (403) enableClosedCaptionsModificationNotAllowed Der Wert von contentDetails.enableClosedCaptions kann nur geändert werden, wenn der Status der Übertragung created oder ready ist.
forbidden (403) enableDvrModificationNotAllowed Der Wert von contentDetails.enableDvr kann nur geändert werden, wenn der Status der Übertragung created oder ready ist.
forbidden (403) enableMonitorStreamModificationNotAllowed Der Wert von contentDetails.monitorStream.enableMonitorStream kann nur geändert werden, wenn der Status der Übertragung created oder ready ist.
forbidden (403) recordFromStartModificationNotAllowed Der Wert von 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 OAuth 2.0-Authentifizierung implementieren.
insufficientPermissions liveStreamingNotEnabled Der Nutzer, der die Anfrage autorisiert hat, ist nicht berechtigt, Live-Videos auf YouTube zu streamen. Weitere Informationen finden Sie unter https://www.youtube.com/features.
invalidArgument missingAdsMonetizationStatus ads_monetization_status muss entweder als ON oder OFF angegeben werden.
invalidValue (400) invalidAutoStart Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das contentDetails.enableAutoStart Attribut. Sie können die Einstellung enableAutoStart für eine dauerhafte Übertragung nicht ändern.
invalidValue (400) invalidAutoStop Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das contentDetails.enableAutoStop Attribut. Sie können die enableAutoStop Einstellung für eine dauerhafte Übertragung nicht ändern.
invalidValue (400) invalidDescription In der liveBroadcast-Ressource wurde kein gültiger Wert für das snippet.description Attribut angegeben. snippet.description kann bis zu 5.000 Zeichen enthalten.
invalidValue (400) invalidEmbedSetting Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das contentDetails.enable_embed Attribut. Sie können 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 nur eines der beiden Attribute enthalten ist, und senden Sie die Anfrage noch einmal.
invalidValue (400) invalidLatencyPreferenceOptions Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das contentDetails.latencyPreference Attribut. Nicht alle Einstellungen werden mit dieser Latenzpräferenz unterstützt.
invalidValue (400) invalidEligibleForAdsMonetization eligible_for_ads_monetization ist schreibgeschützt und kann nicht im Feld monetization_details angegeben werden.
invalidValue (400) invalidCuepointSchedule Die liveBroadcast-Ressource enthält einen ungültigen Wert für das monetizationDetails.cuepointSchedule Attribut. Dieser Fehler kann folgende Ursachen haben:
  • cuepoint_schedule kann nicht angegeben werden, wenn ads_monetization_status auf OFF gesetzt ist.
  • cuepoint_schedule muss angegeben werden, wenn ads_monetization_status auf ON gesetzt ist.
 cuepoint_schedule kann nicht angegeben werden, wenn ads_monetization_status auf „OFF“ gesetzt ist.
invalidValue (400) invalidEnabled Die liveBroadcast-Ressource enthält einen ungültigen oder widersprüchlichen Wert für das monetizationDetails.cuepointSchedule.enabled Attribut. Dieser Fehler kann folgende Ursachen haben:
  • enabled muss im Feld cuepoint_schedule angegeben werden.
  • pause_ads_until, yt_optimized_cuepoint_config oder creator_cuepoint_config können nicht angegeben werden, wenn enabled auf „false“ gesetzt ist.
  • Wenn enabled auf „true“ gesetzt ist, kann nur eines der Attribute yt_optimized_cuepoint_config und creator_cuepoint_config angegeben werden.
invalidValue (400) invalidCreatorCuepointConfig Sie müssen sowohl schedule_strategy als auch repeat_interval_secs angeben.
invalidValue (400) invalidRepeatIntervalSecs Der Wert des Attributs repeat_interval_secs muss zwischen 360 und 3.600 liegen.
invalidValue (400) invalidPauseAdsUntil Die liveBroadcast-Ressource enthält einen ungültigen Wert für das monetizationDetails.cuepointSchedule.pauseAdsUntil Attribut. Dieser Fehler kann folgende Ursachen haben:
  • Der Wert von monetizationDetails.cuepointSchedule.pauseAdsUntil ist nicht im ISO 8601-Format (JJJJ-MM-TTThh:mm:ss.sZ) angegeben.
  • Der Wert von monetizationDetails.cuepointSchedule.pauseAdsUntil liegt nicht in der Zukunft.
  • Der Wert von monetizationDetails.cuepointSchedule.pauseAdsUntil liegt mehr als 10 Minuten nach der aktuellen Zeit.
invalidValue (400) invalidPrivacyStatus In der liveBroadcast-Ressource wurde kein gültiger Datenschutzstatus angegeben. Gültige Werte für privacyStatus ansehen.
invalidValue (400) invalidProjection Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das contentDetails.projection Attribut. Die Projektion einer dauerhaften Übertragung kann nicht auf 360 gesetzt werden.
invalidValue (400) invalidScheduledEndTime Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das snippet.scheduledEndTime Attribut. Die geplante Endzeit muss nach der geplanten Startzeit liegen.
invalidValue (400) invalidScheduledStartTime Die liveBroadcast-Ressource enthielt einen ungültigen Wert für das snippet.scheduledStartTime Attribut. Die geplante Startzeit muss in der Zukunft liegen.
invalidValue (400) invalidTitle In der liveBroadcast-Ressource wurde kein gültiger Wert für das snippet.title Attribut angegeben. snippet.title muss zwischen 1 und 100 Zeichen lang sein.
notFound (404) liveBroadcastNotFound Das in der liveBroadcast-Ressource angegebene Attribut id hat keine Übertragung identifiziert.
preconditionFailed (412) videoNotEligibleForAdsMonetization Das Video kann nicht durch Werbung monetarisiert werden. Das kann passieren, wenn der Kanal nicht für die Monetarisierung berechtigt ist.
required (400) broadcastStreamDelayMsRequired In der liveBroadcast-Ressource wurde das contentDetails.monitorStream.broadcastStreamDelayMs Attribut nicht angegeben.
required (400) enableMonitorStreamRequired In der liveBroadcast-Ressource wurde das contentDetails.monitorStream.enableMonitorStream Attribut nicht angegeben.
required (400) idRequired Die liveBroadcast-Ressource muss das Attribut id enthalten und einen Wert dafür angeben.
required (400) scheduledEndTimeRequired In der liveBroadcast-Ressource wurde das snippet.scheduledEndTime Attribut nicht angegeben.
required (400) scheduledStartTimeRequired In der liveBroadcast-Ressource wurde das snippet.scheduledStartTime Attribut nicht angegeben.

Testen!

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