유튜브 API로 어린이 영상을 올릴 때, 아동용 표시가 끄는 기능과 넣는 법

어린이용 영상을 유튜브 API로 올릴 때는 status.selfDeclaredMadeForKids를 true로 보내야 하고, 그러면 그 영상에서 댓글, 종 모양 알림, 개인 맞춤 광고를 비롯한 기능 14가지가 꺼져요. 저는 어린이 동화 영상을 자동으로 만드는 프로젝트에서 쇼츠를 이렇게 올렸는데 그날 저녁 조회수가 0이어서, 이 표시 때문인지 확인해 봤어요. 조회수가 0이었던 이유는 확인하지 못했어요. 이 표시가 무엇을 끄는지와 API로 넣는 법은 공식 문서에서 확인해서 적어 둘게요.

아동용으로 설정하면 꺼지는 기능

유튜브 고객센터의 채널 또는 동영상 시청자층 설정 문서에 목록이 있어요. 묶음 이름은 제가 붙였고, 기능 이름은 도움말에 적힌 그대로예요.

묶음	꺼지는 기능
시청자 반응	댓글, 실시간 채팅 또는 실시간 채팅 기부, YouTube Music에서 좋아요 및 싫어요 표시
알림	종 모양 알림 아이콘
광고와 수익	개인 맞춤 광고, 채널 멤버십, Super Chat 또는 Super Sticker, 기부 버튼, 상품 및 티켓 판매
재생과 화면	홈에서 자동재생, 소형 플레이어에서 재생, 카드 또는 엔딩 화면, 동영상 워터마크
저장	재생목록에 저장 및 나중에 볼 동영상에 저장
채널 전체를 아동용으로 하면 추가로	채널 멤버십, 종 모양 알림 아이콘, 게시물, YouTube 스튜디오에 물어보기

도움말은 이유를 법규 준수로 설명해요. 아동용 콘텐츠에서는 데이터 수집과 사용을 제한해야 해서 이런 기능을 끈다는 거예요.

아동용으로 올리면 추천이나 쇼츠 피드에서 빠지나요

제가 찾은 공식 문서에서 추천에 관해 적힌 문장은 이것 하나였어요. 위 설정 문서와 '아동용' 관련 자주 묻는 질문에 똑같이 나와요.

'아동용'으로 설정한 동영상은 다른 아동용 동영상과 함께 추천될 가능성이 높습니다.

아동용 영상이 검색이나 쇼츠 피드에서 빠진다거나 노출이 줄어든다는 문장은 제가 본 문서에서 찾지 못했어요. 꺼지는 기능 목록에도 검색, 추천, 쇼츠 피드는 없어요. "아동용이라서 조회수가 안 나온다"는 말은 공식 문서만으로는 맞다고도 틀리다고도 할 수 없어요.

아동용인지 아닌지는 올리는 사람이 정해야 해요

같은 도움말에 따르면 크리에이터는 사는 곳과 상관없이 동영상이 아동용인지 설정해야 하고, 아동용 콘텐츠를 만든다면 아동용이라고 직접 설정해야 해요. 아동 온라인 개인 정보 보호법(COPPA) 때문이라고 적혀 있어요. 잘못 설정하면 규정 준수 문제가 생길 수 있고 유튜브가 계정에 조치를 취할 수 있다는 말도 있어요.

기준은 내 콘텐츠가 '아동용'인지 판단하는 방법 문서에 있어요. 주요 시청자층이 아동이거나, 아동을 대상으로 하는 캐릭터, 노래, 스토리가 나오는 콘텐츠가 아동용이에요. 어린이 동화 영상은 여기에 들어가요. 조회수가 안 나온다고 아동용 표시를 끄는 건 고를 수 있는 방법이 아니에요.

API로 아동용 설정 넣는 법: selfDeclaredMadeForKids

YouTube Data API의 videos 리소스 문서에는 이름이 비슷한 필드가 둘 있어요.

• status.selfDeclaredMadeForKids: 올리는 사람이 넣는 값이에요. videos.insert와 videos.update 요청에서 채널 소유자가 영상을 아동용으로 지정해요.
• status.madeForKids: 그 영상의 현재 아동용 상태예요. videos.insert와 videos.update 문서의 설정할 수 있는 속성 목록에 없어서, 읽기만 하는 값으로 보면 돼요.

업로드할 때는 part에 status를 넣고 본문에 이렇게 보내요.

{
  "snippet": { "title": "쇼츠 제목", "description": "쇼츠 설명" },
  "status": {
    "privacyStatus": "public",
    "selfDeclaredMadeForKids": true
  }
}

올린 뒤에는 videos.list를 part=status로 불러서 확인해요. 응답의 status는 이런 모양이에요.

"status": {
  "uploadStatus": "processed",
  "privacyStatus": "public",
  "madeForKids": true,
  "selfDeclaredMadeForKids": true
}

실제로 적용된 상태는 madeForKids로 봐요. selfDeclaredMadeForKids는 채널 소유자가 인증한 요청에서만 응답에 나와요.

채널 단위로도 설정할 수 있어요. 도움말에 따르면 채널 설정은 신규 콘텐츠와 기존 콘텐츠 전체에 적용되고, 개별 동영상의 설정이 채널 설정보다 먼저예요. API에서는 channels 리소스의 status.selfDeclaredMadeForKids를 channels.update로 넣어요.

고객센터 문서에는 API에서는 곧 제공할 예정이니 당분간 스튜디오로 올리라는 안내가 아직 남아 있어요. API 문서에는 아동용 표시를 지원한다고 적혀 있고, 저도 API로 올렸어요.

흔한 실수: 값을 비워 두거나 false로 넣기

비워 두기. 이 값을 안 보냈을 때 어떻게 처리되는지는 제가 본 문서에 적혀 있지 않아요. 도움말은 유튜브 시스템이 시청자층을 대신 정해 주기를 기대하지 말라고 해요. 업로드 코드에서 항상 값을 적어 보내는 편이 안전해요. 제 업로더는 따로 false를 넘기지 않으면 true로 보내요.

어린이용인데 false로 넣기. 꺼지는 기능이 아쉬워서 false로 올리면 시청자층을 틀리게 설정한 것이 돼요.

나중에 고치면서 빠뜨리기. videos.update 문서에는 part에 넣은 묶음의 값을 통째로 덮어쓰고, 본문에 값이 없으면 기존 값이 지워진다고 적혀 있어요. status를 고칠 때는 selfDeclaredMadeForKids도 다시 적어요. 제목과 설명만 바꿀 때는 part를 snippet으로만 보내요.

제가 겪은 일: 아동용으로 올린 쇼츠 조회수 0

동화 영상 본편을 보는 사람이 너무 적어서, 완성된 편에서 쇼츠를 잘라 올렸어요. 그날 저녁에 보니 쇼츠 조회수가 0이었고, 아동용으로 올려서 아무도 못 보는 건가 싶어서 확인했어요.

• 영상 처리, 공개 상태, 색인은 모두 정상이었어요.
• 업로더는 selfDeclaredMadeForKids를 true로 보내고 있었어요. 어린이 동화라서 끌 수 없는 값이에요.
• 처음에는 쇼츠가 검색에 안 뜬다고 판단했는데, 채널을 직접 조회해 보니 그 판단이 틀렸어요.
• 분석 API는 권한이 없어서 수치를 읽지 못했어요.

조회수가 왜 0이었는지는 몰라요. 업로드를 시작한 지 일주일이 안 된 채널이었고, 쇼츠를 올린 지 몇 시간밖에 안 된 때였어요. 고객센터의 참여도 측정항목 집계 방법 문서에는 게시 후 처음 몇 시간은 측정항목이 표시되는 데 시간이 걸릴 수 있다고도 적혀 있어요. 가능한 설명이 여러 개이고, 아동용 표시는 그중 제가 확인해 본 한 가지예요. 이 표시가 원인이라는 근거는 찾지 못했어요.

쇼츠를 만들면서 정해 둔 것

구간 경계에서만 잘라요. 이야기에서 문제가 드러나고 첫 시도가 실패한 자리에서 끊어요. 네 편을 잘라 보니 49.1초, 44.9초, 58.3초, 55.8초로 모두 60초 아래였어요.

본편을 먼저 올려요. 본편이 올라가 있어야 쇼츠가 올라가고, 쇼츠가 본편을 링크해요. 이 순서로 올린 한 건은 본편이 57.2MB에 3분, 쇼츠가 7.7MB에 44.9초였어요.

제목과 설명은 쇼츠용으로 따로 만들어요. 본편 설명을 그대로 썼더니 쇼츠 설명란에 결말이 그대로 보였어요. 쇼츠에 실제로 나오는 구간만 가지고 제목과 설명을 만들게 바꿨고, 이미 올린 쇼츠의 제목과 설명도 API로 바꿨어요.

한눈에 보기

• 어린이용 영상이면: status.selfDeclaredMadeForKids를 true로 적어 보내기
• 실제 적용된 상태는: videos.list의 status.madeForKids로 확인
• 꺼지는 것: 댓글, 종 모양 알림, 개인 맞춤 광고, 카드와 엔딩 화면, 재생목록 저장 등 14가지
• 추천에 대해 공식 문서에 적힌 것: 다른 아동용 동영상과 함께 추천될 가능성이 높다는 문장 하나