Diese Seite wurde von der Cloud Translation API übersetzt.

LiveBroadcasts: update

Aktualisiert eine Übertragung. Sie können beispielsweise die Übertragungseinstellungen ändern, die im Objekt contentDetails der Ressource liveBroadcast 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.

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 vom Schreibvorgang festgelegt werden, sowie die Eigenschaften, die die API-Antwort enthält. Die `part`-Eigenschaften, die Sie in den Parameterwert aufnehmen können, sind `id`, `snippet`, `contentDetails`, `monetizationDetails` und `status`. Beachten Sie, dass diese Methode die vorhandenen Werte für alle änderbaren Eigenschaften überschreibt, die in allen Teilen enthalten sind, die durch den Parameterwert angegeben werden. 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 vorgesehen. Der Parameter `onBehalfOfContentOwner` gibt an, dass die Anmeldedaten für die Autorisierung einen Nutzer des Content-Management-Systems (CMS) von YouTube identifizieren, 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 erhalten Zugriff auf alle ihre Video- und Kanaldaten, ohne dass sie für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung angeben 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 vorgesehen. 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 über ein CMS-Konto autorisiert werden, das mit dem Rechteinhaber verknüpft ist, das durch den Parameter `onBehalfOfContentOwner` angegeben wird. Schließlich muss der Kanal, den der Parameterwert `onBehalfOfContentOwnerChannel` angibt, mit dem Rechteinhaber verknüpft werden, den der Parameter `onBehalfOfContentOwner` angibt. Dieser Parameter ist für YouTube-Contentpartner gedacht, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Rechteinhaber können sich einmalig 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 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 eine Eigenschaft angegeben ist, die bereits einen Wert hat, wird der vorhandene Wert der Eigenschaft gelöscht.

Antwort

Bei Erfolg gibt diese Methode eine liveBroadcast-Ressource im Antworttext zurück.

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 unter 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 aus folgenden Gründen auftreten: <ph type="x-smartling-placeholder"> </ph> 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 „`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 Broadcast-Status `created` oder `ready` ist.
`forbidden (403)`	`enableMonitorStreamModificationNotAllowed`	Der Wert `contentDetails.monitorStream.enableMonitorStream` kann nur geändert werden, wenn der Broadcast-Status `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, Live-Videos auf YouTube zu streamen. Weitere Informationen sind unter https://www.youtube.com/features verfügbar.
`invalidValue (400)`	`invalidAutoStart`	Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die Eigenschaft `contentDetails.enableAutoStart`. Sie können die Einstellung `enableAutoStart` für einen dauerhaften Broadcast nicht ändern.
`invalidValue (400)`	`invalidAutoStop`	Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die Eigenschaft `contentDetails.enableAutoStop`. Ich Die Einstellung `enableAutoStop` für einen dauerhaften Broadcast kann nicht geändert werden.
`invalidValue (400)`	`invalidDescription`	Die liveBroadcast-Ressource hat keinen gültigen Wert für das `snippet.description`-Attribut angegeben. `snippet.description` kann bis zu 5.000 Zeichen enthalten.
`invalidValue (400)`	`invalidEmbedSetting`	Die Ressource liveBroadcast 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` mit dem Wert der `contentDetails.closedCaptionType`-Einstellung nicht kompatibel. Ändern Sie die Ressource so, dass sie nur eine der beiden Attribute enthält, und reichen Sie die Anfrage dann noch einmal ein.
`invalidValue (400)`	`invalidLatencyPreferenceOptions`	Die Ressource liveBroadcast enthielt einen ungültigen Wert für die Eigenschaft `contentDetails.latencyPreference`. Bei dieser Latenzeinstellung werden nicht alle Einstellungen unterstützt.
`invalidValue (400)`	`invalidPauseAdsUntil`	Die Ressource liveBroadcast enthält einen ungültigen Wert für die `monetizationDetails.cuepointSchedule.pauseAdsUntil`-Property. Dieser Fehler kann aus folgenden Gründen auftreten: <ph type="x-smartling-placeholder"> </ph> Der Wert für `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 Ressource liveBroadcast 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 Ressource liveBroadcast enthielt einen ungültigen Wert für das Attribut `snippet.scheduledEndTime`. Das geplante Ende muss nach dem geplanten Beginn liegen.
`invalidValue (400)`	`invalidScheduledStartTime`	Die Ressource liveBroadcast 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 keinen gültigen Wert für das `snippet.title`-Attribut angegeben. `snippet.title` muss zwischen 1 und 100 Zeichen lang sein.
`notFound (404)`	`liveBroadcastNotFound`	Die in der liveBroadcast-Ressource angegebene Eigenschaft `id` identifiziert eine Übertragung nicht.
`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.

Testen!

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