LiveCuepoints

liveCuepoint 리소스와 liveCuepoints.insert 메서드가 지원 중단되고 liveBroadcasts.cuepoint 메서드로 대체되었습니다.

liveCuepoint 리소스는 방송 동영상 스트림에 큐 포인트를 삽입하므로 광고 시간이 트리거될 수 있습니다.

참고: 이 API 명령어는 실제로 YouTube Content ID API의 일부이며 liveBroadcastliveStream 리소스 관리 요청과는 다른 승인 요구사항을 가지고 있습니다.

방법

API는 liveCuepoints 리소스에 다음 메서드를 지원합니다.

삽입
실시간 방송에 큐 시점을 삽입합니다. 현재 이 방법에 대한 요청은 YouTube 콘텐츠 소유자와 연결된 계정에서 승인해야 합니다. 지금 사용해보기

리소스 표현

다음 JSON 구조는 liveCuepoints 리소스의 형식을 보여줍니다.

{
  "id": string,
  "kind": "youtubePartner#liveCuepoint",
  "broadcastId": string,
  "settings": {
    "offsetTimeMs": long,
    "walltime": datetime,
    "cueType": string,
    "durationSecs": unsigned integer
  }
}

속성

다음 표는 이 리소스에 표시되는 속성을 정의합니다.

속성
id string
YouTube에서 큐 시점을 고유하게 식별하기 위해 할당하는 값입니다.
kind string
API 리소스의 유형입니다. liveCuepoint 리소스의 경우 값은 youtubePartner#liveCuepoint입니다.
broadcastId string
YouTube에서 큐 포인트가 삽입되는 방송을 고유하게 식별하기 위해 할당하는 ID입니다.
settings object
settings 객체는 큐 포인트의 설정을 정의합니다.
settings.offsetTimeMs long
이 값은 시청자가 광고 또는 인스트림 슬레이트를 볼 수 있는 동영상의 특정 시점을 지정합니다. 속성 값은 모니터 스트림 시작 부분부터의 시간 오프셋(밀리초)을 나타냅니다. 값은 밀리초 단위로 측정되지만 실제로는 근사값이며 YouTube는 그 시간에 최대한 가까운 시간에 큐 시점을 삽입합니다. 방송에 모니터 스트림이 없으면 이 매개변수의 값을 지정해서는 안 됩니다.

이 속성의 기본값은 0이며 가능한 한 빨리 큐 포인트가 삽입되어야 함을 나타냅니다. 방송 스트림이 지연되지 않으면 0 값만 유효한 값입니다. 하지만 방송 스트림이 지연되는 경우 속성 값에서 큐 시점을 삽입해야 하는 시간을 지정할 수 있습니다. 자세한 내용은 시작 가이드를 참고하세요.

참고: 방송에 테스트 단계가 있는 경우 오프셋은 테스트 단계가 시작된 시점부터 측정됩니다.
settings.walltime datetime
이 값은 큐 포인트가 삽입되어야 하는 벽시계 시간을 지정합니다. 값은 ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ) 형식으로 지정됩니다.

요청이 이 속성 및 settings.offsetTimeMs 속성의 값을 지정하는 큐 포인트를 삽입하려고 하면 API가 오류를 반환합니다.
settings.cueType string
큐 포인트의 유형입니다. 여러 유형의 큐 포인트에 관한 설명은 시작하기 가이드를 참고하세요. 방송 중에 큐 포인트 삽입에 관한 권장사항은 방송의 전체 기간 문서를 참조하세요.

이 속성의 유효한 값은 다음과 같습니다.
  • ad
settings.durationSecs unsigned integer
큐 포인트의 재생 시간(초)입니다. cueTypead이면 이 값을 지정해야 하며, 그렇지 않으면 무시됩니다.