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 객체는 채널의 워터마크 이미지가 표시되는 동영상 재생 시간 정보를 캡슐화합니다. watermarks.set를 호출할 때는 이 객체가 필요합니다.
timing.type string
동영상 재생 중에 워터마크 이미지가 표시되는 시점을 결정하는 타이밍 메서드입니다. 이 속성은 watermarks.set를 호출할 때 필요합니다.

유효한 값은 다음과 같습니다.
  • offsetFromStart: offsetMs 필드는 동영상 시작 부분의 오프셋을 나타냅니다.
  • offsetFromEnd: offsetMs 필드는 동영상 끝에서 오프셋을 나타냅니다.
timing.offsetMs unsigned long
동영상 재생 중에 프로모션 상품이 표시되는 시점을 결정하는 시간 오프셋입니다(밀리초 단위로 지정됨). watermarks.set를 호출할 때는 이 속성이 필요합니다. type이 offsetFromEnd인 경우 offsetMs은 1000밀리초 이상이어야 합니다.
timing.durationMs unsigned long
워터마크 이미지가 표시되어야 하는 시간(밀리초)입니다. 이 속성은 선택사항입니다. 지정된 경우 최소 기간은 1000밀리초입니다. type가 offsetFromEnd인 경우 durationMs는 offsetMs을 초과해서는 안 됩니다.
position object
지원 중단됨: position 객체는 지원 중단되었으며 YouTube에서 무시됩니다. 워터마크는 항상 동영상 플레이어의 오른쪽 상단에 표시됩니다.
imageUrl string
채널 워터마크 이미지의 URL입니다. YouTube는 이 URL을 생성하고 watermark.set 요청에 대한 API 응답으로 반환합니다.
imageBytes bytes
워터마크 이미지의 크기(바이트)입니다.
targetChannelId string
워터마크 이미지가 연결되는 채널의 YouTube 채널 ID입니다.