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": {
    "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
동영상 플레이어에 프로모션 항목을 배치하는 방식입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • corner
position.cornerPosition string
프로모션 항목이 표시될 플레이어의 코너입니다.

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