LiveBroadcasts

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: