Aktualisiert eine Übertragung. Beispielsweise haben Sie die Möglichkeit, die Broadcast-Einstellungen zu ändern, die im Objekt contentDetails
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).
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 dient in diesem Vorgang zwei Zwecken. Er gibt die Attribute an, die vom Schreibvorgang festgelegt werden, sowie die Eigenschaften, die die API-Antwort enthält.Die part -Attribute, die Sie in den Parameterwert aufnehmen können, sind id , snippet , contentDetails , monetizationDetails und status .Hinweis: Diese Methode überschreibt die vorhandenen Werte für alle änderbaren Eigenschaften, die in den Teilen des Parameterwerts enthalten sind. Der Datenschutzstatus einer Übertragung wird beispielsweise im Abschnitt status 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 keinen 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 ordnungsgemäß autorisierten Anfrage verwendet werden. Hinweis: Dieser Parameter ist ausschließlich für YouTube-Contentpartner vorgesehen. Der Parameter onBehalfOfContentOwner gibt an, dass durch die Autorisierungsanmeldedaten der Anfrage ein YouTube CMS-Nutzer identifiziert wird, 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 nur einmal authentifizieren und auf alle ihre 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. 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 im onBehalfOfContentOwner -Parameter angegeben ist. Schließlich muss der Kanal, den der Parameterwert onBehalfOfContentOwnerChannel angibt, mit dem Rechteinhaber verknüpft sein, der durch den Parameter onBehalfOfContentOwner angegeben wird.Dieser Parameter ist für YouTube-Contentpartner gedacht, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Damit können sich Rechteinhaber einmal authentifizieren und Aktionen für den im Parameterwert angegebenen Kanal ausführen, ohne für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung 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 Attribute 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 eine Eigenschaft angegeben ist, die 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 finden Sie Fehlermeldungen, 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 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 aus folgenden Gründen auftreten:
|
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 Status der Übertragung created oder ready ist. |
forbidden (403) |
enableDvrModificationNotAllowed |
Der Wert contentDetails. kann nur geändert werden, wenn der Status der Übertragung created oder ready ist. |
forbidden (403) |
enableMonitorStreamModificationNotAllowed |
Der Wert contentDetails. kann nur geändert werden, wenn der Status der Übertragung created oder ready ist. |
forbidden (403) |
recordFromStartModificationNotAllowed |
Der Wert contentDetails. 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, ist nicht berechtigt, Live-Videos auf YouTube zu 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 .
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 Attribut contentDetails.enableAutoStop . Sie können die Einstellung enableAutoStop für einen nichtflüchtigen Broadcast 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 eines der beiden Attribute 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 aus folgenden Gründen auftreten:
|
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 . Für die Projektion einer dauerhaften Übertragung kann nicht 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 |
Das Attribut id , das in der liveBroadcast-Ressource angegeben wurde, hat keine Übertragung erkannt. |
required (400) |
broadcastStreamDelayMsRequired |
Die liveBroadcast-Ressource hat das Attribut contentDetails. nicht angegeben. |
required (400) |
enableMonitorStreamRequired |
Die liveBroadcast-Ressource hat das Attribut contentDetails. 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.