LiveBroadcasts: transition

Ändert den Status einer YouTube-Liveübertragung und initiiert alle Prozesse, die mit dem neuen Status verknüpft sind. Wenn Sie beispielsweise den Status einer Übertragung in testing ändern, beginnt YouTube mit der Übertragung von Videos an den Monitorstream dieser Übertragung. Bevor Sie diese Methode aufrufen, sollten Sie prüfen, ob der Wert der Eigenschaft status.streamStatus für den Stream, der mit Ihrer Übertragung verknüpft ist, active ist.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

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

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-Authentifizierung 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
broadcastStatus string
Der Parameter broadcastStatus gibt den Status an, in den die Übertragung geändert wird. Wenn Sie den Status einer Übertragung in testing oder live ändern möchten, muss status.streamStatus für den Stream, mit dem die Übertragung verknüpft ist, active sein.

Zulässige Werte:
  • complete – Die Übertragung ist beendet. YouTube beendet die Videoübertragung.
  • live – Die Übertragung ist für das Publikum sichtbar. YouTube überträgt Videos an den Monitorstream und den Übertragungsstream der Übertragung.
  • testing – Starten Sie den Test der Übertragung. YouTube überträgt Videos an den Monitorstream der Übertragung. Sie können den Status einer Übertragung nur in testing ändern, wenn die Eigenschaft contentDetails.monitorStream.enableMonitorStream auf true gesetzt ist.
id string
Der Parameter id gibt die eindeutige ID der Übertragung an, deren Status geändert wird.
part string
Der Parameter part gibt eine durch Kommas getrennte Liste mit einer oder mehreren Eigenschaften der Ressource liveBroadcast 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-Content-Partner vorgesehen.

Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube-CMS-Nutzer 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. So können Rechteinhaber sich 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.

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 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 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. So können Rechteinhaber 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 beim Aufrufen dieser Methode keinen Anfragetext an.

Antwort

Bei Erfolg gibt diese Methode im Antworttext eine liveBroadcast-Ressource 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 finden Sie unter YouTube Live Streaming API – Fehler.

Fehlertyp Fehlerdetail Beschreibung
backendError errorExecutingTransition Beim Ändern des Status der Übertragung ist ein Fehler aufgetreten.
forbidden (403) errorStreamInactive Die angeforderte Änderung ist nicht zulässig, wenn der Stream, der mit der Übertragung verknüpft ist, inaktiv ist.
forbidden (403) invalidTransition Der Status der Liveübertragung kann nicht vom aktuellen in den angeforderten Status geändert werden.
forbidden (403) redundantTransition Die Liveübertragung hat bereits den angeforderten Status oder wird in den angeforderten Status geändert.
insufficientPermissions insufficientLivePermissions Die Anfrage ist nicht autorisiert, den Status der Liveübertragung zu ändern.
insufficientPermissions livePermissionBlocked Der Nutzer, der die Anfrage autorisiert hat, kann derzeit keine Livevideos auf YouTube streamen. Weitere Informationen dazu, warum der Nutzer kein Livevideo streamen kann, finden Sie in den Kanaleinstellungen des Nutzers unter Voraussetzungen für Funktionen.
insufficientPermissions liveStreamingNotEnabled Der Nutzer, der die Anfrage autorisiert hat, kann keine Livevideos auf YouTube streamen. Weitere Informationen finden Sie unter Voraussetzungen für Funktionen.
notFound (404) liveBroadcastNotFound Die im Parameter id angegebene Übertragung ist nicht vorhanden.
rateLimitExceeded (403) userRequestsExceedRateLimit Der Nutzer hat innerhalb eines bestimmten Zeitraums zu viele Anfragen gesendet.
rateLimitExceeded (403) concurrentBroadcastsExceedLimit Der Kanal hat bereits die maximale Anzahl gleichzeitiger Liveübertragungen erreicht. Eine oder mehrere bereits laufende Übertragungen müssen beendet werden, bevor eine weitere Übertragung auf dem Kanal gestartet werden kann.
rateLimitExceeded (403) sharedIngestionBroadcastsExceedLimit Der Kanal hat bereits die maximale Anzahl von Liveübertragungen erreicht, die dieselbe Aufnahmesquelle verwenden. Eine oder mehrere dieser Übertragungen müssen beendet werden, um die angeforderte Übertragung zu starten.
required (400) idRequired Der erforderliche Parameter id muss die Übertragung angeben, deren Status Sie ändern möchten.
required (400) statusRequired In der API-Anfrage muss ein Wert für den Parameter status angegeben werden.

Testen!

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