LiveBroadcasts: transition

Ändert den Status einer YouTube-Liveübertragung und initiiert alle mit dem neuen Status verbundenen Prozesse. Wenn du den Status einer Übertragung beispielsweise auf testing umstellst, beginnt YouTube, Video an den Monitorstream dieser Übertragung zu übertragen. Bevor du diese Methode aufrufst, solltest du prüfen, ob der Wert der Property status.streamStatus für den Stream, der mit deiner Übertragung verknüpft ist, active ist.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/youtube/v3/liveBroadcasts/transition

Autorisierung

Diese Anfrage erfordert eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche. Weitere Informationen zu Authentifizierung und Autorisierung finden Sie unter OAuth 2.0-Authentifizierung 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
broadcastStatus string
Der Parameter broadcastStatus gibt den Status an, in den die Übertragung geändert wird. Hinweis: Damit eine Übertragung in den Status testing oder live übergeht, muss status.streamStatus für den Stream, mit dem die Übertragung verknüpft ist, active sein.

Zulässige Werte:
  • complete – Die Übertragung ist vorbei. YouTube überträgt kein Video mehr.
  • live – Die Übertragung ist für die Zuschauer sichtbar. YouTube überträgt das Video an den Monitorstream und den Übertragungsstream der Übertragung.
  • testing – Starten Sie den Test der Übertragung. YouTube überträgt das Video an den Monitorstream der Übertragung. Hinweis: Du kannst eine Übertragung nur in den Status testing versetzen, wenn die Eigenschaft contentDetails.monitorStream.enableMonitorStream auf true festgelegt ist.
id string
Der Parameter id gibt die eindeutige ID der Übertragung an, die in einen anderen Status übergeht.
part string
Der Parameter part gibt eine durch Kommas getrennte Liste mit einer oder mehreren liveBroadcast-Ressourceneigenschaften an, die in der API-Antwort enthalten sein sollen. Die part-Namen, die Sie in den Parameterwert aufnehmen können, sind id, snippet, contentDetails und status.
Optionale Parameter
onBehalfOfContentOwner string
Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden.

Hinweis:Dieser Parameter ist ausschließlich für YouTube-Inhaltspartner gedacht.

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 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 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-Contentpartner 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

Geben Sie beim Aufruf dieser Methode keinen Anfragetext an.

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 findest du unter YouTube Live Streaming API – Fehler.

Fehlertyp Fehlerdetails Beschreibung
backendError errorExecutingTransition Beim Ändern des Status der Übertragung ist ein Fehler aufgetreten.
forbidden (403) errorStreamInactive Der angeforderte Übergang ist nicht zulässig, wenn der Stream, der mit der Übertragung verknüpft ist, inaktiv ist.
forbidden (403) invalidTransition Der Livestream kann nicht von seinem aktuellen Status in den angeforderten Status wechseln.
forbidden (403) redundantTransition Die Übertragung hat bereits den angeforderten Status oder wird gerade in den angeforderten Status geändert.
insufficientPermissions insufficientLivePermissions Die Anfrage ist nicht autorisiert, die Übertragung zu wechseln.
insufficientPermissions livePermissionBlocked Der Nutzer, der die Anfrage autorisiert hat, kann derzeit keine Livestreams auf YouTube ansehen. Weitere Informationen dazu, warum der Nutzer kein Livevideo streamen kann, findest du in den Kanaleinstellungen unter Voraussetzungen für die Nutzung der Funktion.
insufficientPermissions liveStreamingNotEnabled Der Nutzer, der die Anfrage autorisiert hat, ist nicht berechtigt, Livevideos auf YouTube zu streamen. Weitere Informationen finden Sie unter Voraussetzungen für die Nutzung von Funktionen.
notFound (404) liveBroadcastNotFound Die mit dem Parameter id angegebene Übertragung ist nicht vorhanden.
rateLimitExceeded (403) userRequestsExceedRateLimit Der Nutzer hat innerhalb eines bestimmten Zeitraums zu viele Anfragen gesendet.
required (400) idRequired Der erforderliche Parameter id muss die Übertragung angeben, deren Status geändert werden soll.
required (400) statusRequired In der API-Anfrage muss ein Wert für den Parameter status angegeben werden.

Testen!

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