watermark
리소스는 지정된 채널의 동영상을 재생하는 동안 표시되는 이미지를 식별합니다. 또한 동영상 재생 중 워터마크가 표시되는 시기와 표시되는 시간의 길이를 정하는 타이밍 세부정보뿐 아니라 이미지가 연결되는 타겟 채널도 지정할 수 있습니다.
메소드
API는 watermarks
리소스에 다음 메소드를 지원합니다.
- set
- YouTube에 워터마크 이미지를 업로드하고 채널에 설정합니다.
- unset
- 워터마크를 삭제합니다. 지금 사용해 보세요.
리소스 표현
아래의 JSON 구조는 watermarks
리소스의 형식을 보여줍니다.
{ "timing": { "type": string, "offsetMs": unsigned long, "durationMs": unsigned long }, "position": { "type": string, "cornerPosition": string }, "imageUrl": string, "imageBytes": bytes, "targetChannelId": { "value": string } }
속성
다음 표는 이 리소스에 표시되는 속성을 정의합니다.
속성 이름 | |
---|---|
timing |
object timing 개체는 동영상 재생 중 채널의 워터마크 이미지가 표시되는 시간에 대한 정보를 요약합니다. |
timing.type |
string 동영상 재생 중 워터마크 이미지가 표시될 시기를 정하는 타이밍 메소드입니다. 값이 offsetFromStart 인 경우 offsetMs 필드는 동영상 시작부터 오프셋을 나타냅니다. 값이 offsetFromEnd 인 경우 offsetMs 필드는 동영상 끝부터 오프셋을 나타냅니다. |
timing.offsetMs |
unsigned long 동영상 재생 중 프로모션 항목을 표시할 시기를 정하는 밀리초로 지정된 시간 오프셋입니다. type 속성의 값은 동영상의 시작 또는 끝 중 어디부터 오프셋을 측정할지를 정합니다. |
timing.durationMs |
unsigned long 워터마크 이미지가 표시될 시간 길이(밀리초)입니다. |
position |
object position 개체는 워터마크 이미지가 표시될 동영상 내 공간 위치에 대한 정보를 요약합니다. |
position.type |
string 동영상 플레이어에 프로모션 항목을 배치하는 방식입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
position.cornerPosition |
string 프로모션 항목이 표시될 플레이어의 코너입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
imageUrl |
string 채널의 워터마크 이미지에 대한 URL입니다. YouTube에서 이 URL을 생성하고 watermark.set 요청에 대한 API 응답에 반환합니다. |
imageBytes |
bytes 워터마크 이미지의 크기(바이트)입니다. |
targetChannelId |
string
워터마크 이미지가 연결될 채널의 YouTube 채널 ID입니다. |