Watermarks

watermark 리소스는 지정된 채널의 동영상을 재생하는 동안 표시되는 이미지를 식별합니다. 또한 동영상 재생 중 워터마크가 표시되는 시기와 표시되는 시간의 길이를 정하는 타이밍 세부정보뿐 아니라 이미지가 연결되는 타겟 채널도 지정할 수 있습니다.

방법

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

세트
YouTube에 워터마크 이미지를 업로드하고 채널에 설정합니다.
unset
채널의 워터마크 이미지를 삭제합니다. 지금 사용해보기

리소스 표현

아래의 JSON 구조는 watermarks 리소스의 형식을 보여줍니다.

{
  "timing": {
    "type": string,
    "offsetMs": unsigned long,
    "durationMs": unsigned long
  },
  "position": {
    "type": string,
    "cornerPosition": string
  },
  "imageUrl": string,
  "imageBytes": bytes,
  "targetChannelId": 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
프로모션 항목이 동영상 플레이어에 배치되는 방식입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • corner
position.cornerPosition string
프로모션 항목이 표시되는 플레이어의 모서리입니다. 아이템은 항상 플레이어의 오른쪽 상단에 표시됩니다.

이 속성에 유효한 값은 다음과 같습니다.
  • topRight
imageUrl string
채널의 워터마크 이미지 URL입니다. YouTube는 이 URL을 생성하여 watermark.set 요청에 대한 API 응답에 반환합니다.
imageBytes bytes
워터마크 이미지의 크기(바이트)입니다.
targetChannelId string
워터마크 이미지가 연결된 채널의 YouTube 채널 ID입니다.