LiveBroadcasts

Die API unterstützt jetzt die Möglichkeit, Liveübertragungen als „speziell für Kinder“ zu kennzeichnen. Die liveBroadcast-Ressource enthält jetzt eine Eigenschaft, die den Status „speziell für Kinder“ der jeweiligen Liveübertragung angibt. Die Nutzungsbedingungen der YouTube API-Dienste und die Richtlinien für Entwickler*innen wurden ebenfalls am 10. Januar 2020 aktualisiert. Weitere Informationen finden Sie im Revisionsverlauf des YouTube Live Streaming API-Dienstes und der Nutzungsbedingungen für die YouTube API-Dienste.

Eine liveBroadcast-Ressource stellt eine Veranstaltung dar, die auf YouTube per Live-Video übertragen wird.

Methoden

Die API unterstützt die folgenden Methoden für liveBroadcasts-Ressourcen:

list

Gibt eine Liste von YouTube-Übertragungen zurück, die den API-Anfrageparametern entsprechen. Hier kannst du die Funktion ausprobieren.

insert

Erstellt eine Übertragung. Hier kannst du die Funktion ausprobieren.

Aktualisierung

Aktualisiert eine Übertragung. Sie können beispielsweise die in der contentDetails-Ressource definierten Broadcast-Einstellungen ändern.liveBroadcast Jetzt testen

Delete

Löscht eine Übertragung. Hier kannst du die Funktion ausprobieren.

bind

Bindet eine YouTube-Übertragung an einen Stream oder entfernt eine vorhandene Bindung zwischen einer Übertragung und einem Stream. Eine Übertragung kann nur an einen Videostream gebunden werden, ein Videostream kann jedoch an mehrere Übertragungen gebunden werden. Hier kannst du die Funktion ausprobieren.

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 Video an den Monitorstream dieser Übertragung. Bevor Sie diese Methode aufrufen, sollten Sie prüfen, ob der Wert der Property status.streamStatus für den an Ihre Übertragung gebundenen Stream active ist. Jetzt testen

cuepoint

Fügt einen Cuepoint in eine Liveübertragung ein. Der Cuepoint löst möglicherweise eine Werbeunterbrechung aus.

Ressourcendarstellung

Die folgende JSON-Struktur zeigt das Format einer liveBroadcasts-Ressource:

{
  "kind": "youtube#liveBroadcast",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "isDefaultBroadcast": boolean,
    "liveChatId": string
  },
  "status": {
    "lifeCycleStatus": string,
    "privacyStatus": string,
    "recordingStatus": string,
    "madeForKids": string,
    "selfDeclaredMadeForKids": string,
  },
  "contentDetails": {
    "boundStreamId": string,
    "boundStreamLastUpdateTimeMs": datetime,
    "monitorStream": {
      "enableMonitorStream": boolean,
      "broadcastStreamDelayMs": unsigned integer,
      "embedHtml": string
    },
    "enableEmbed": boolean,
    "enableDvr": boolean,
    "recordFromStart": boolean,
    "enableClosedCaptions": boolean,
    "closedCaptionsType": string,
    "projection": string,
    "enableLowLatency": boolean,
    "latencyPreference": boolean,
    "enableAutoStart": boolean,
    "enableAutoStop": boolean,
    "availabilityConfig": {
      "globalConfig": {
        "excludedRegionCodes": [
          string
        ],
        "interval": {
          "startTime": datetime,
          "endTime": datetime
        }
      },
      "regionsConfig": {
        "regionIntervals": [
          {
            "regionCode": string,
            "interval": {
              "startTime": datetime,
              "endTime": datetime
            }
          }
        ]
      }
    }
  },
  "statistics": {
    "totalChatCount": unsigned long
  },
  "monetizationDetails": {
    "adsMonetizationStatus": string,
    "eligibleForAdsMonetization": boolean,
    "cuepointSchedule": {
      "enabled": boolean,
      "pauseAdsUntil": datetime,
      "ytOptimizedCuepointConfig": string,
      "creatorCuepointConfig": {
        "scheduleStrategy": string,
        "repeatIntervalSecs": unsigned integer
      }
    }
  }
}

Properties

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource enthalten sind:

Properties
kind	string Gibt den Typ der API-Ressource an. Der Wert ist youtube#liveBroadcast.
etag	etag Das ETag dieser Ressource.
id	string Die ID, die YouTube der Übertragung zuweist, um sie eindeutig zu identifizieren.
snippet	object Das snippet-Objekt enthält grundlegende Details zum Ereignis, einschließlich Titel, Beschreibung, Start- und Endzeit.
snippet.publishedAt	datetime Das Datum und die Uhrzeit, zu der die Liveübertragung dem YouTube-Zeitplan für Liveübertragungen hinzugefügt wurde. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.
snippet.channelId	string Die ID, die YouTube verwendet, um den Kanal, auf dem die Übertragung veröffentlicht wird, eindeutig zu identifizieren.
snippet.title	string Der Titel der Übertragung. Eine Übertragung entspricht genau einem YouTube-Video. Sie können dieses Feld festlegen, indem Sie die Broadcast-Ressource ändern oder das Feld title der entsprechenden Video-Ressource festlegen.
snippet.description	string Die Beschreibung der Übertragung. Wie beim title können Sie dieses Feld festlegen, indem Sie die Broadcast-Ressource ändern oder das Feld description der entsprechenden Videoressource festlegen.
snippet.thumbnails	object Eine Karte mit Miniaturansichten, die mit der Übertragung verknüpft sind. Für jedes verschachtelte Objekt in diesem Objekt ist der Schlüssel der Name des Vorschaubilds und der Wert ein Objekt, das weitere Informationen zum Vorschaubild enthält.
snippet.thumbnails.(key)	object Gültige Schlüsselwerte sind: default: Das Standard-Thumbnail-Bild. Die Standard-Miniaturansicht für ein Video oder eine Ressource, die auf ein Video verweist, z. B. ein Playlist-Element oder ein Suchergebnis, ist 120 Pixel breit und 90 Pixel hoch. Das Standard-Thumbnail für einen Channel ist 88 Pixel breit und 88 Pixel hoch. medium: Eine Version des Thumbnails mit höherer Auflösung. Bei einem Video (oder einer Ressource, die auf ein Video verweist) ist dieses Bild 320 Pixel breit und 180 Pixel hoch. Für einen Channel ist dieses Bild 240 Pixel breit und 240 Pixel hoch. high – Eine Version des Thumbnail-Bilds mit hoher Auflösung. Bei einem Video (oder einer Ressource, die auf ein Video verweist) ist dieses Bild 480 Pixel breit und 360 Pixel hoch. Für einen Kanal ist dieses Bild 800 Pixel breit und 800 Pixel hoch.
snippet.thumbnails.(key).url	string Die URL des Bildes.
snippet.thumbnails.(key).width	unsigned integer Die Breite des Bildes.
snippet.thumbnails.(key).height	unsigned integer Die Höhe des Bildes.
snippet.scheduledStartTime	datetime Das Datum und die Uhrzeit, zu der die Übertragung planmäßig beginnen soll. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben. In Creator Studio kannst du eine Übertragung erstellen, ohne eine Startzeit festzulegen. In diesem Fall beginnt die Übertragung, sobald der Kanalinhaber mit dem Streamen beginnt. Bei diesen Übertragungen entspricht der datetime-Wert der Unix-Epochenzeit null. Dieser Wert kann nicht über die API oder in Creator Studio geändert werden.
snippet.scheduledEndTime	datetime Das Datum und die Uhrzeit, zu der die Übertragung enden soll. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben. Wenn für diese Eigenschaft in einer liveBroadcast-Ressource kein Wert angegeben ist, wird die Übertragung auf unbestimmte Zeit geplant. Wenn Sie keinen Wert für dieses Attribut angeben, behandelt YouTube die Übertragung so, als würde sie unbegrenzt fortgesetzt.
snippet.actualStartTime	datetime Datum und Uhrzeit, zu der die Übertragung tatsächlich begonnen hat. Diese Informationen sind erst verfügbar, wenn der Status der Übertragung live ist. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.
snippet.actualEndTime	datetime Datum und Uhrzeit, zu der die Übertragung tatsächlich beendet wurde. Diese Informationen sind erst verfügbar, wenn der Status der Übertragung complete ist. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.
snippet.isDefaultBroadcast	boolean Diese Property wird am oder nach dem 1. September 2020 eingestellt. Ab diesem Zeitpunkt wird auf YouTube kein Standardstream und keine Standardsendung mehr erstellt, wenn ein Kanal für Livestreaming aktiviert ist. Weitere Informationen finden Sie in der Mitteilung zur Einstellung. Diese Property gibt an, ob es sich bei dieser Übertragung um die Standardübertragung handelt. So funktionieren Standardübertragungen Wenn ein YouTube-Kanal für Livestreaming aktiviert ist, erstellt YouTube einen Standardstream und eine Standardübertragung für den Kanal. Der Stream definiert, wie der Kanalinhaber Livevideos an YouTube sendet. Die Übertragung ist die Art und Weise, wie Zuschauer den Standardstream sehen können. Ein Kanalinhaber kann diese Ressourcen mithilfe der Methoden liveStreams.list und liveBroadcasts.list identifizieren. Wenn ein Kanal mit dem Streamen von Videos zu seinem Standardstream beginnt, ist das Video in der Standardübertragung des Kanals sichtbar. Wenn der Stream endet, wandelt YouTube die Übertragung in ein YouTube-Video um und weist dem Video eine YouTube-Video-ID zu. Nach der Umwandlung wird das Video in die Liste der hochgeladenen Videos des Kanals aufgenommen. Das Video ist nicht sofort nach dem Ende der Übertragung verfügbar. Die Länge der Verzögerung hängt von der tatsächlichen Länge der Übertragung ab.
snippet.liveChatId	string Die ID für den YouTube-Live-Chat der Übertragung. Mit dieser ID können Sie die Methoden der liveChatMessage-Ressource verwenden, um Chatnachrichten abzurufen, einzufügen oder zu löschen. Außerdem kannst du Chatmoderatoren hinzufügen oder entfernen, Nutzer für die Teilnahme an Livechats sperren oder bestehende Sperren aufheben.
status	object Das status-Objekt enthält Informationen zum Status des Ereignisses.
status.lifeCycleStatus	string Der Status der Übertragung. Der Status kann mit der Methode liveBroadcasts.transition der API aktualisiert werden. Gültige Werte für dieses Attribut sind: complete: Die Übertragung ist beendet. created: Die Übertragung hat unvollständige Einstellungen und kann daher nicht in den Status live oder testing übergehen. Sie wurde jedoch erstellt und ist ansonsten gültig. live: Der Livestream ist aktiv. liveStarting: Die Übertragung wird gerade in den Status live geändert. ready: Die Übertragungseinstellungen sind vollständig und die Übertragung kann in den Status live oder testing wechseln. revoked – Diese Übertragung wurde durch eine Administratoraktion entfernt. testStarting: Die Übertragung wird gerade in den Status testing geändert. testing: Die Übertragung ist nur für den Partner sichtbar.
status.privacyStatus	string Der Datenschutzstatus der Übertragung. Eine Übertragung entspricht genau einem YouTube-Video. Die Datenschutzeinstellungen sind also identisch mit denen, die für Videos unterstützt werden. Außerdem können Sie dieses Feld festlegen, indem Sie die Broadcast-Ressource ändern oder das Feld privacyStatus der entsprechenden Video-Ressource festlegen. Gültige Werte für diese Eigenschaft sind: private public unlisted
status.recordingStatus	string Der Aufzeichnungsstatus der Übertragung. Gültige Werte für diese Property sind: notRecording recorded recording
status.madeForKids	boolean Dieser Wert gibt an, ob die Übertragung als für Kinder bestimmt gekennzeichnet ist. Dieser Eigenschaftswert ist schreibgeschützt.
status.selfDeclaredMadeForKids	boolean In einer liveBroadcasts.insert-Anfrage kann der Kanalinhaber mit dieser Property die Übertragung als auf Kinder ausgerichtet kennzeichnen. Bei einer liveBroadcasts.list-Anfrage wird der Attributwert nur zurückgegeben, wenn der Kanalinhaber die API-Anfrage autorisiert hat.
contentDetails	object Das contentDetails-Objekt enthält Informationen zum Videoinhalt des Ereignisses, z. B. ob der Inhalt in einem eingebetteten Videoplayer angezeigt werden kann oder ob er archiviert wird und daher nach dem Ende des Ereignisses verfügbar ist.
contentDetails.boundStreamId	string Dieser Wert identifiziert die an die Übertragung gebundene live stream eindeutig.
contentDetails.boundStreamLastUpdateTimeMs	datetime Datum und Uhrzeit der letzten Aktualisierung des Livestreams, auf den mit boundStreamId verwiesen wird.
contentDetails.monitorStream	object Das monitorStream-Objekt enthält Informationen zum Monitorstream, mit denen der Broadcaster die Eventinhalte überprüfen kann, bevor der Broadcaststream öffentlich angezeigt wird.
contentDetails.monitorStream.enableMonitorStream	boolean Dieser Wert bestimmt, ob der Monitorstream für die Übertragung aktiviert ist. Wenn der Monitor-Stream aktiviert ist, überträgt YouTube die Eventinhalte in einem speziellen Stream, der nur für den Broadcaster bestimmt ist. Der Broadcaster kann sich den Stream ansehen, um die Inhalte des Events zu prüfen und die optimalen Zeitpunkte für das Einfügen von Cuepoints zu ermitteln. Sie müssen diesen Wert auf true festlegen, wenn Sie eine testing-Phase für Ihre Übertragung haben möchten oder wenn Sie eine Übertragungsverzögerung für Ihr Event wünschen. Wenn der Wert dieser Property true ist, müssen Sie die Übertragung außerdem in den Status testing versetzen, bevor Sie sie in den Status live versetzen können. Wenn der Wert der Property false ist, kann die Übertragung keine testing-Phase haben. Sie können die Übertragung also direkt in den Status live überführen. Wenn Sie update a broadcast, muss diese Eigenschaft festgelegt werden, wenn Ihre API-Anfrage den Teil contentDetails im Parameterwert part enthält. Wenn Sie jedoch insert a broadcast, ist die Eigenschaft optional und hat den Standardwert true. Wichtig:Diese Property kann nicht mehr aktualisiert werden, sobald sich die Übertragung im Status testing oder live befindet.
contentDetails.monitorStream.broadcastStreamDelayMs	unsigned integer Wenn Sie die Property enableMonitorStream auf true festgelegt haben, bestimmt diese Property die Länge der Verzögerung der Liveübertragung. Wenn Sie update a broadcast, muss diese Eigenschaft festgelegt werden, wenn Ihre API-Anfrage den Teil contentDetails im Parameterwert part enthält. Wenn Sie jedoch insert a broadcast, ist die Eigenschaft optional und hat den Standardwert 0. Dieser Wert gibt an, dass die Übertragung keine Übertragungsverzögerung hat. Hinweis:Dieses Attribut kann nicht mehr aktualisiert werden, sobald sich die Übertragung im Status testing oder live befindet.
contentDetails.monitorStream.embedHtml	string HTML-Code zum Einbetten eines Players, der den Monitorstream wiedergibt.
contentDetails.enableEmbed	boolean Mit dieser Einstellung wird angegeben, ob das Broadcast-Video in einem eingebetteten Player abgespielt werden kann. Wenn Sie das Video mit dem Attribut enableArchive archivieren, gilt diese Einstellung auch für das archivierte Video. Wenn Sie update a broadcast, muss diese Eigenschaft festgelegt werden, wenn Ihre API-Anfrage den Teil contentDetails im Parameterwert part enthält. Wenn Sie jedoch insert a broadcast, ist die Eigenschaft optional und hat den Standardwert true. Hinweis:Dieses Attribut kann nicht aktualisiert werden, sobald sich die Übertragung im Status testing oder live befindet.
contentDetails.enableDvr	boolean Mit dieser Einstellung wird festgelegt, ob Zuschauer während der Wiedergabe des Videos auf die DVR-Steuerelemente zugreifen können. Mit den DVR-Steuerelementen können Zuschauer die Videowiedergabe steuern, indem sie Inhalte pausieren, zurückspulen oder vorspulen. Der Standardwert für diese Eigenschaft ist true. Wenn Sie update a broadcast, muss diese Eigenschaft festgelegt werden, wenn Ihre API-Anfrage den Teil contentDetails im Parameterwert part enthält. Wenn Sie jedoch insert a broadcast, ist die Eigenschaft optional und hat den Standardwert true. Wichtig:Wenn die Wiedergabe sofort nach dem Ende der Übertragung verfügbar sein soll, musst du den Wert auf true und den Wert der Eigenschaft enableArchive ebenfalls auf true festlegen. Außerdem kann diese Eigenschaft nicht aktualisiert werden, sobald sich die Übertragung im Status testing oder live befindet.
contentDetails.recordFromStart	boolean Diese Einstellung gibt an, ob YouTube die Übertragung automatisch aufzeichnen soll, nachdem der Status des Events zu „Live“ geändert wurde. Der Standardwert dieser Eigenschaft ist true. Sie kann nur auf false festgelegt werden, wenn der Sender Aufzeichnungen für Liveübertragungen deaktivieren darf. Wenn dein Kanal nicht berechtigt ist, Aufzeichnungen zu deaktivieren, und du versuchst, eine Übertragung mit der Eigenschaft recordFromStart auf false zu setzen, gibt die API den Fehler Forbidden zurück. Wenn dein Kanal diese Berechtigung nicht hat und du versuchst, eine Übertragung zu aktualisieren, um das Attribut recordFromStart auf false festzulegen, gibt die API den Fehler modificationNotAllowed zurück. Wenn Sie update a broadcast, muss diese Eigenschaft festgelegt werden, wenn Ihre API-Anfrage den Teil contentDetails im Parameterwert part enthält. Wenn Sie jedoch insert a broadcast, ist die Eigenschaft optional und hat den Standardwert true. Wichtig:Wenn die Wiedergabe sofort nach dem Ende der Übertragung verfügbar sein soll, müssen Sie auch den Wert des Attributs enableDvr auf true festlegen. Wenn du den Wert dieser Eigenschaft auf true setzt, aber die Eigenschaft enableDvr nicht auch auf true setzt, kann es etwa einen Tag dauern, bis das archivierte Video wiedergegeben werden kann. Hinweis:Dieses Attribut kann nicht aktualisiert werden, sobald sich die Übertragung im Status testing oder live befindet.
contentDetails.enableClosedCaptions	boolean Diese Property wurde am 17. Dezember 2015 eingestellt. Verwenden Sie stattdessen das Attribut contentDetails.closedCaptionsType. Diese Einstellung gibt an, ob HTTP POST-Untertitel für diese Übertragung aktiviert sind. Für API-Clients, die diese Eigenschaft bereits verwenden: Wenn Sie den Attributwert auf true festlegen, entspricht das dem Festlegen des Attributs contentDetails.closedCaptionsType auf closedCaptionsHttpPost. Wenn Sie den Attributwert auf false festlegen, entspricht das dem Festlegen des Attributs contentDetails.closedCaptionsType auf closedCaptionsDisabled.
contentDetails.closedCaptionsType	string Hinweis: Dieses Attribut ersetzt das Attribut contentDetails.enableClosedCaptions. Dieses Attribut gibt an, ob Untertitel für deine Übertragung aktiviert sind und, falls ja, welche Art von Untertiteln du bereitstellst: closedCaptionsDisabled: Untertitel sind für die Liveübertragung deaktiviert. closedCaptionsHttpPost: Sie senden Untertitel per HTTP POST an eine Aufnahme-URL, die mit Ihrem Livestream verknüpft ist. closedCaptionsEmbedded: Untertitel werden im Videostream im EIA-608- und/oder CEA-708-Format codiert.
contentDetails.projection	string Das Projektionsformat dieser Übertragung. Der Standardwert des Attributs ist rectangular. Gültige Werte für dieses Attribut sind: 360 rectangular
contentDetails.enableLowLatency	boolean Gibt an, ob diese Übertragung für Low-Latency-Streaming codiert werden soll. Bei einem Stream mit geringer Latenz dauert es weniger lange, bis das Video für Nutzer sichtbar ist, die sich eine Übertragung ansehen. Allerdings kann sich das auch auf die Auflösung für die Zuschauer des Streams auswirken.
contentDetails.latencyPreference	string Gibt an, welche Latenzeinstellung für diese Übertragung verwendet werden soll. Diese Eigenschaft kann anstelle von enableLowLatency verwendet werden, da enableLowLatency keine ultraLow unterstützt. Bei einem Stream mit niedriger Latenz kann die Zeit verkürzt werden, die vergeht, bis das Video für Nutzer sichtbar ist, die sich eine Übertragung ansehen. Dies kann sich jedoch auch auf die flüssige Wiedergabe auswirken. Bei einem Stream mit extrem niedriger Latenz wird die Zeit, die vergeht, bis das Video für Zuschauer sichtbar ist, noch weiter verkürzt. Dadurch wird die Interaktion mit Zuschauern erleichtert. Allerdings werden bei extrem niedriger Latenz keine Untertitel und keine Auflösungen über 1080p unterstützt. Gültige Werte für diese Eigenschaft sind: normal low ultraLow
contentDetails.enableAutoStart	boolean Gibt an, ob diese Übertragung automatisch gestartet werden soll, wenn du auf dem gebundenen live stream mit dem Streamen von Videos beginnst.
contentDetails.enableAutoStop	boolean Gibt an, ob diese Übertragung etwa eine Minute nach dem Beenden des Videostreams durch den Kanalinhaber automatisch beendet werden soll.
contentDetails.availabilityConfig	object Die Konfiguration der Verfügbarkeit der Übertragung. Wird verwendet, um die Verfügbarkeit für bestimmte Regionen festzulegen oder bestimmte Regionen zu blockieren. Es ist optional. Wenn es nicht festgelegt ist, wird es nicht erzwungen.
contentDetails.availabilityConfig.globalConfig	object Konfiguration der globalen Verfügbarkeit der Übertragung. Das Video ist in allen Regionen verfügbar, mit Ausnahme der in der Liste excludedRegionCodes angegebenen.
contentDetails.availabilityConfig.globalConfig.excludedRegionCodes	list (string) Eine Liste der Regionen, in denen das Video gesperrt ist.
contentDetails.availabilityConfig.globalConfig.interval	object Das Standardzeitfenster, in dem das Video in allen nicht gesperrten Regionen verfügbar ist. Hinweis:Diese Property wird für anstehende oder aktive Livestreams nicht unterstützt.
contentDetails.availabilityConfig.globalConfig.interval.startTime	datetime Das Datum und die Uhrzeit, zu der das Video verfügbar wird. Wenn keine Angabe erfolgt, ist das Video bereits verfügbar. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.
contentDetails.availabilityConfig.globalConfig.interval.endTime	datetime Das Datum und die Uhrzeit, ab der das Video nicht mehr verfügbar ist. Wenn keine Angabe erfolgt, ist das Video unbegrenzt verfügbar. Die angegebenen Start- und Endzeiten dürfen nicht mehr als fünf Jahre in der Zukunft liegen. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.
contentDetails.availabilityConfig.regionsConfig	object Konfiguration der regionalen Verfügbarkeit der Übertragung. Das Video ist nur in den angegebenen Regionen verfügbar.
contentDetails.availabilityConfig.regionsConfig.regionIntervals	list (object) Eine Liste der Regionen und Zeiträume, in denen das Video verfügbar ist. Wenn eine Region mehrmals angegeben wird, wird die Vereinigung aller Intervalle verwendet.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.regionCode	string Die Region, in der das Video verfügbar ist.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval	object Das Zeitfenster, in dem das Video für die angegebene Region verfügbar ist. Hinweis:Diese Property wird für anstehende oder aktive Livestreams nicht unterstützt.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval.startTime	datetime Das Datum und die Uhrzeit, zu der das Video in der angegebenen Region verfügbar wird. Wenn keine Angabe erfolgt, ist das Video bereits verfügbar. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.
contentDetails.availabilityConfig.regionsConfig.regionIntervals.interval.endTime	datetime Das Datum und die Uhrzeit, zu der das Video in der angegebenen Region nicht mehr verfügbar ist. Wenn keine Angabe erfolgt, ist das Video unbegrenzt verfügbar. Die angegebenen Start- und Endzeiten dürfen nicht mehr als fünf Jahre in der Zukunft liegen. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.
statistics	object Das statistics-Objekt enthält Statistiken zu einer Liveübertragung. Die Werte für diese Statistiken können sich während der Übertragung ändern und können nur abgerufen werden, solange die Übertragung live ist.
statistics.totalChatCount	unsigned long Die Gesamtzahl der Live-Chat-Nachrichten, die mit der Übertragung verknüpft sind. Die Property und ihr Wert sind vorhanden, wenn die Übertragung für den Nutzer sichtbar ist, die Live-Chat-Funktion aktiviert ist und mindestens eine Nachricht vorhanden ist. Nach dem Ende der Übertragung wird für dieses Attribut kein Wert angegeben. Diese Eigenschaft gibt also nicht die Anzahl der Chatnachrichten für ein archiviertes Video einer abgeschlossenen Liveübertragung an.
monetizationDetails	object Das monetizationDetails-Objekt enthält Informationen zu den Monetarisierungsdetails des Streams, z. B. ob die automatische Anzeigenplatzierung aktiviert ist oder ob die Einfügung von Midroll-Anzeigen verzögert wird. Wichtig:Damit automatische Anzeigen für ein Video aktiviert werden können, muss der Kanal die Voraussetzungen für die Monetarisierung von Videos erfüllen. Die Monetarisierungseinstellung der Übertragung, z. B. das Aktivieren der Monetarisierung oder des Anzeigenautomators (d. h. „Mid-Roll-Anzeigen automatisch von YouTube einfügen lassen“ oder „Mid-Roll-Anzeigen in regelmäßigen Intervallen einblenden lassen“), kann über die API oder in YouTube Studio beim Erstellen der Übertragung oder beim Bearbeiten der Übertragung während des Livestreams festgelegt werden.
monetizationDetails.adsMonetizationStatus	string Diese Property gibt an, ob für eine Videopräsentation Mid-Roll-Anzeigen aktiviert sind. Gültige Werte sind on und off.
monetizationDetails.eligibleForAdsMonetization	string Diese Property gibt an, ob ein Videostream für Mid-Roll-Anzeigen infrage kommt. Eine Übertragung kann aus verschiedenen Gründen nicht infrage kommen, z. B. weil bereits ein Anspruch besteht oder ein Kanal nicht für die Monetarisierung eingerichtet ist.
monetizationDetails.cuepointSchedule	object Das cuepointSchedule-Objekt gibt die Einstellungen für die Anzeigenautomatisierung für die Übertragung an.
monetizationDetails.cuepointSchedule.enabled	boolean Dieser Wert bestimmt, ob Anzeigen automatisch in die Übertragung eingefügt werden. Wenn der Wert true ist, fügt YouTube automatisch Mid-Roll-Anzeigen in die Übertragung ein. Der Zeitplan für die Ausführung von Anzeigen wird durch den Wert der anderen Felder im monetizationDetails.cuepointSchedule-Objekt bestimmt.
monetizationDetails.cuepointSchedule.pauseAdsUntil	datetime Dieser Wert gibt an, dass YouTube bis zum angegebenen Datum und zur angegebenen Uhrzeit keine Mid-Roll-Anzeigen in die Übertragung einfügen soll. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben. Der Wert muss auf ein zukünftiges Datum/eine zukünftige Uhrzeit festgelegt werden, um Anzeigen zu pausieren. Der Feldwert kann auch auf ein vergangenes Datum/eine vergangene Uhrzeit oder einen leeren Wert festgelegt werden, um Anzeigen zu reaktivieren.
monetizationDetails.cuepointSchedule.ytOptimizedCuepointConfig	string In diesem Feld wird die ausgewählte Option für automatisch eingefügte Cuepoints für Anzeigen angegeben. Im Feld kann einer von drei Modi angegeben werden: LOW: Geringeres Umsatzpotenzial, relativ wenige Unterbrechungen für Zuschauer MEDIUM: Mittleres Umsatzpotenzial, höhere Nutzerfreundlichkeit HIGH: Höheres Umsatzpotenzial, relativ viele Unterbrechungen für Zuschauer
monetizationDetails.cuepointSchedule.creatorCuepointConfig	object Das Objekt creatorCuepointConfig gibt die Option für die automatische Anzeigenschaltung an, mit der Creator festlegen können, wie Mid-Rolls eingeblendet werden.
monetizationDetails.cuepointSchedule.creatorCuepointConfig.scheduleStrategy	string Dieser Wert gibt die Strategie an, die YouTube für die Planung von Cuepoints verwenden soll. Gültige Werte sind: CONCURRENT: Cuepoints werden für alle Zuschauer gleichzeitig geplant. NON_CONCURRENT: Cuepoints werden für verschiedene Zuschauer zu unterschiedlichen Zeiten geplant. So können Anzeigen häufiger ausgeliefert werden, sodass Zuschauer Cuepoints erhalten, wenn sie dafür infrage kommen.
monetizationDetails.cuepointSchedule.creatorCuepointConfig.repeatIntervalSecs	unsigned integer Dieser Wert gibt das Intervall in Sekunden zwischen automatischen Anzeigeneinblendungen während einer Übertragung an. Wenn der Wert beispielsweise 360 ist, kann YouTube alle sechs Minuten Mid-Roll-Cuepoints einfügen. Hinweis: Der Wert gibt die Zeit zwischen dem Start aufeinanderfolgender Cuepoints an. Das Intervall wird also nicht vom Ende eines Cuepoints bis zum Start des nächsten gemessen. Um den YouTube Studio-Einstellungen zu entsprechen, ist dieser Wert ein Vielfaches von 6 Minuten zwischen 6 und 30 Minuten. Jede Ganzzahl in der Aktualisierungsanfrage innerhalb dieses Bereichs wird, obwohl sie gültig ist, auf das nächste Vielfache von 6 Minuten abgerundet.