LiveBroadcasts

Ресурс liveBroadcast представляет собой событие, которое будет транслироваться в прямом эфире на YouTube.

Методы

API поддерживает следующие методы для ресурсов liveBroadcasts :

list

Возвращает список трансляций YouTube, соответствующих параметрам запроса API. Попробуйте прямо сейчас .

insert

Создаёт трансляцию. Попробуйте прямо сейчас .

update

Обновляет трансляцию. Например, вы можете изменить параметры трансляции, определенные в объекте contentDetails ресурса liveBroadcast . Попробуйте прямо сейчас .

delete

Удаляет трансляцию. Попробуйте прямо сейчас .

bind

Привязывает трансляцию YouTube к потоку или удаляет существующую привязку между трансляцией и потоком. Трансляция может быть привязана только к одному видеопотоку, хотя видеопоток может быть привязан к нескольким трансляциям. Попробуйте прямо сейчас .

transition

Изменяет статус прямой трансляции на YouTube и запускает все процессы, связанные с новым статусом. Например, когда вы переводите статус трансляции в testing , YouTube начинает передавать видео в поток монитора этой трансляции. Перед вызовом этого метода убедитесь, что значение свойства status.streamStatus для потока, привязанного к вашей трансляции, является active . Попробуйте прямо сейчас .

cuepoint

Вставляет точку воспроизведения в прямую трансляцию. Эта точка воспроизведения может вызвать рекламную паузу.

Представление ресурсов

Следующая JSON-структура демонстрирует формат ресурса liveBroadcasts :

{
  "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
      }
    }
  }
}

Характеристики

В следующей таблице описаны свойства, которые отображаются в этом ресурсе: