LiveBroadcasts: insert

Die API unterstützt jetzt die Möglichkeit, deine Liveübertragungen als „speziell für Kinder“ zu kennzeichnen. Die Ressource liveBroadcast enthält jetzt eine Property, die den Status „speziell für Kinder“ des Livestreams angibt. Die Nutzungsbedingungen für YouTube API Dienste und die Entwicklerrichtlinien wurden am 10. Januar 2020 ebenfalls aktualisiert. Weitere Informationen finden Sie im Überarbeitungsverlauf für den YouTube Live Streaming API Service und die Nutzungsbedingungen für YouTube API-Dienste.

Erstellt einen Livestream.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

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

Die part Properties, 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 onBehalfOfContentOwner Parameter 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 gedacht, die viele verschiedene YouTube-Kanäle besitzen und verwalten. So können sich Rechteinhaber 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-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 gedacht, die viele verschiedene YouTube-Kanäle besitzen und verwalten. So können sich Content-Inhaber 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:

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

    • snippet.title
    • snippet.scheduledStartTime
    • status.privacyStatus

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

    • snippet.title
    • snippet.description
    • snippet.categoryId
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • status.selfDeclaredMadeForKids
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.availabilityConfig
    Hinweis: In der Tabelle mit den Properties sind alle Standardwerte dokumentiert, die für die aufgeführten Properties festgelegt sind. Die Standardwerte werden in einem der folgenden Fälle zugewiesen:
    • Sie geben keine Werte für diese Properties an.
    • Der Wert des Parameters part in Ihrer Anfrage gibt nicht den Teil an, der diese Properties enthält.

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 finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetail Beschreibung
insufficientPermissions insufficientLivePermissions Die Anfrage ist nicht autorisiert, die Liveübertragung zu erstellen.
insufficientPermissions livePermissionBlocked Der Nutzer, der die Anfrage autorisiert hat, kann derzeit keine Livestreams auf YouTube streamen. Details dazu, warum der Nutzer keine Livestreams streamen kann, finden Sie möglicherweise in den Kanaleinstellungen des Nutzers unter https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled Der Nutzer, der die Anfrage autorisiert hat, kann keine Livestreams auf YouTube streamen. Weitere Informationen finden Sie unter https://www.youtube.com/features.
invalidValue (400) invalidAutoStart Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die contentDetails.enableAutoStart Property. Nicht alle Livestreams unterstützen diese Einstellung.
invalidValue (400) invalidAutoStop Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die contentDetails.enableAutoStop Property. Sie können die enableAutoStop Einstellung für einen dauerhaften Livestream nicht ändern.
invalidValue (400) invalidDescription In der liveBroadcast-Ressource wurde kein gültiger Wert für die snippet.description Property angegeben. Der Wert der Property kann bis zu 5.000 Zeichen enthalten.
invalidValue (400) invalidEmbedSetting Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die contentDetails.enable_embed Property. Dieser Livestream kann nicht eingebettet werden.
invalidValue (400) invalidLatencyPreferenceOptions Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die contentDetails.latencyPreference Property. Nicht alle Einstellungen werden mit dieser Latenzpräferenz unterstützt.
invalidValue (400) invalidPrivacyStatus Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die status.privacy_status Property.
invalidValue (400) invalidProjection Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die contentDetails.projection Property. Die Projektion eines Standard-Livestreams kann nicht auf 360 festgelegt werden.
invalidValue (400) invalidScheduledEndTime Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die snippet.scheduledEndTime Property. Die geplante Endzeit muss nach der geplanten Startzeit liegen.
invalidValue (400) invalidScheduledStartTime Die liveBroadcast-Ressource enthielt einen ungültigen Wert für die snippet.scheduledStartTime Property. Die geplante Startzeit muss in der Zukunft liegen und nah genug am aktuellen Datum, damit ein Livestream zu diesem Zeitpunkt zuverlässig geplant werden kann.
invalidValue (400) invalidTitle In der liveBroadcast-Ressource wurde kein gültiger Wert für die snippet.title Property angegeben. Der Wert der Property muss zwischen 1 und 100 Zeichen lang sein.
limitExceeded userBroadcastsExceedLimit Der Nutzer hat zu viele Livestreams oder geplante Livestreams erstellt und muss einige beenden oder löschen.
rateLimitExceeded userRequestsExceedRateLimit Der Nutzer hat innerhalb eines bestimmten Zeitraums zu viele Anfragen gesendet.
required (400) privacyStatusRequired Für die liveBroadcast-Ressource muss ein Datenschutzstatus angegeben werden. Gültige Werte privacyStatus ansehen.
required (400) scheduledEndTimeRequired Für die liveBroadcast-Ressource muss die snippet.scheduledEndTime Property angegeben werden.
required (400) scheduledStartTimeRequired Für die liveBroadcast-Ressource muss die snippet.scheduledStartTime Property angegeben werden.
required (400) titleRequired Für die liveBroadcast-R/1} Ressource muss die snippet.title Property angegeben werden.

Testen!

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