Watermarks

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": 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입니다.