liveCuepoint
리소스와 liveCuepoints.insert
메서드가 지원 중단되고 liveBroadcasts.cuepoint
메서드로 대체되었습니다.
liveCuepoint
리소스는 방송 동영상 스트림에 큐 포인트를 삽입하므로 광고 시간이 트리거될 수 있습니다.
참고: 이 API 명령어는 실제로 YouTube Content ID API의 일부이며 liveBroadcast
및 liveStream
리소스 관리 요청과는 다른 승인 요구사항을 가지고 있습니다.
방법
API는 liveCuepoints
리소스에 다음 메서드를 지원합니다.
리소스 표현
다음 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 큐 포인트의 유형입니다. 여러 유형의 큐 포인트에 관한 설명은 시작하기 가이드를 참고하세요. 방송 중에 큐 포인트 삽입에 관한 권장사항은 방송의 전체 기간 문서를 참조하세요. 이 속성의 유효한 값은 다음과 같습니다.
|
settings.durationSecs |
unsigned integer 큐 포인트의 재생 시간(초)입니다. cueType 가 ad 이면 이 값을 지정해야 하며, 그렇지 않으면 무시됩니다. |