참고: YouTube 개발자 정책을 준수하면 API 클라이언트가 YouTube API 서비스 약관 및 정책 (API 서비스 약관)의 특정 부분을 준수하도록 하는 데 도움이 되는 안내와 예시가 제공됩니다. 이 가이드는 YouTube가 API TOS의 특정 측면을 시행하는 방법에 대한 유용한 정보를 제공하지만 기존 문서를 대체하지는 않습니다.
이 문서에서는 YouTube API 서비스의 특정 기능('API 클라이언트')을 구현하거나 이에 대한 액세스를 제공하는 API 클라이언트(이하 'API 클라이언트')에 대한 최소 기능 요구사항을 정의합니다.
이러한 요구사항과 가이드라인은 API 클라이언트가 YouTube 사용자, 콘텐츠 소유자, 광고주의 이익을 보호하는 일관된 사용자 환경을 제공하도록 보장합니다. 이러한 규칙은 YouTube API 서비스 약관의 핵심 부분이며 API 클라이언트를 개발 및 구현할 때 반드시 준수해야 합니다.
기존 YouTube 기능의 사용자 경험을 개선하기 위해 이 문서의 요구사항이 변경될 예정입니다. 또한 신규 및 업데이트된 YouTube 기능에 따라 변경됩니다. 때때로 이러한 변경사항으로 인해 새로운 요구사항을 해결하기 위해 귀하의 API 클라이언트를 업데이트해야 할 수도 있습니다. 서비스 약관 업데이트 내역에는 모든 변경사항이 기록되므로 API 클라이언트에 영향을 줄 수 있는 변경사항을 빠르게 확인할 수 있도록 관련 문서를 자주 확인하거나 RSS 피드를 구독하시기 바랍니다.
이 문서에 설명된 요구사항 외에도 YouTube API 서비스 정책 및 YouTube API 서비스 문서의 다른 부분에서 설명된 권장사항을 따르는 것이 좋습니다. 이러한 방법은 반드시 필수사항이 아니더라도 API 클라이언트가 오류를 보다 빠르게 복구하고 할당량을 할당하는 YouTube API 서비스를 사용할 경우 할당량 사용을 최적화하는 데 도움이 됩니다. 이와 동시에 이러한 관행은 YouTube 생태계의 건전성을 보장하는 데 도움이 되며, 무엇보다도 API 클라이언트 및 YouTube 애플리케이션 사용자에게 가능한 한 최상의 환경을 제공하는 데 도움이 됩니다.
YouTube 내장 플레이어 및 동영상 재생
이 섹션의 요구사항은 특히 삽입된 YouTube 플레이어와 관련이 있습니다. YouTube API 서비스 정책에는 YouTube 시청각 콘텐츠를 재생하는 API 클라이언트와 관련된 여러 정책도 포함되어 있습니다.
삽입된 YouTube 플레이어 크기
내장 플레이어에는 200x200픽셀 이상의 표시 영역이 있어야 합니다. 플레이어에 컨트롤이 표시되는 경우에는 표시 영역이 최소 크기 미만으로 축소되지 않고 컨트롤이 완전히 표시될 만큼 커야 합니다. 16:9 플레이어의 경우 가로 480픽셀, 세로 270픽셀 이상으로 지정하는 것이 좋습니다.
자동재생 및 스크립트 재생
이 섹션에서는 자동 재생에 대해 설명합니다. 이는 autoplay 플레이어 매개변수를 사용하거나 YouTube IFrame Player API 서비스, YouTube Android Player API 서비스 또는 다른 YouTube API 서비스를 사용하여 프로그래매틱 방식으로 자동 재생을 시작하는 YouTube 내장 플레이어에 적용됩니다.
-
동영상을 자동으로 재생하는 내장 플레이어는 페이지가 로드될 때 또는 삽입된 플레이어가 완전히 표시되는 즉시 재생을 시작해야 합니다. 하지만 API 클라이언트는 플레이어가 표시되고 플레이어의 절반 이상이 페이지 또는 화면에 표시될 때까지 자동 재생을 시작해서는 안 됩니다.
-
페이지 또는 화면에 콘텐츠를 동시에 자동으로 재생하는 YouTube 플레이어가 2개 이상 있어서는 안 됩니다.
-
재생을 시작하는 모든 YouTube 미리보기 이미지는 가로 120픽셀, 세로 70픽셀 이상이어야 합니다.
YouTube 플레이어 속성
YouTube 플레이어의 속성과 매개변수는 YouTube API 문서 및 사양(https://developers.google.com/youtube)에 명시되어 있습니다(예: 플레이어에서 YouTube 브랜드로 보이는 모습 포함). API 문서에 명시적으로 설명되어 있지 않은 방식으로 YouTube 플레이어를 변경해서는 안 됩니다.
오버레이 및 프레임
플레이어 컨트롤을 포함하여 YouTube 내장 플레이어의 어떠한 부분도 앞에 오버레이, 프레임 또는 기타 시각적 요소를 표시해서는 안 됩니다. 마찬가지로 오버레이, 프레임 또는 기타 시각적 요소를 사용하여 플레이어 컨트롤을 비롯하여 삽입된 플레이어의 일부를 가리면 안 됩니다.
마우스오버
사용자를 대신하여 창 열기 또는 채널 구독과 같은 작업을 시작하기 위해 YouTube 플레이어에서 마우스 오버 또는 터치 이벤트를 사용해서는 안 됩니다.
동영상 업로드하기
API 클라이언트를 통해 사용자가 여러 플랫폼에 콘텐츠를 업로드할 수 있는 경우 사용자는 동영상을 업로드할 플랫폼을 선택하거나 선택 해제할 수 있어야 합니다.
데이터 요구사항
사용자가 YouTube에 동영상을 업로드할 수 있는 API 클라이언트는 사용자가 다음 목록의 값을 설정할 수 있도록 설정해야 합니다. 목록에 없는 숙박 시설은 선택사항입니다.
| 이름 | 설명 | |
|---|---|---|
| 리소스 속성 | ||
snippet.title |
필수사항: 동영상의 제목입니다. 값이 100자를 초과하면 YouTube에서 오류를 반환합니다. YouTube는 < 및 >를 제외하고 모든 유효한 UTF-8 문자를 지원합니다.
| |
snippet.description |
필수사항: 동영상이 설명입니다. 값이 5,000바이트를 초과하면 YouTube에서 오류를 반환합니다. YouTube는 < 및 >를 제외하고 모든 유효한 UTF-8 문자를 지원합니다. |
|
status.privacyStatus |
필수사항: 동영상의 공개 범위 설정입니다. 사용자는 업로드한 동영상의 공개, 비공개 또는 일부 공개 여부를 선택할 수 있어야 합니다. | |
| 요청 매개변수 | ||
onBehalfOfContentOwnerChannel |
조건부 필수: 요청의 승인 사용자 인증 정보로 콘텐츠 소유자를 식별하고 onBehalfOfContentOwner 매개변수가 설정된 경우 API 사용자는 동영상이 업로드되는 YouTube 채널도 지정할 수 있어야 합니다. |
|
댓글 표시
| 이름 | 설명 | |
|---|---|---|
| 리소스 속성 | ||
snippet.textDisplay |
필수사항: 댓글의 텍스트입니다. API 클라이언트는 (a) 댓글 또는 댓글 답글의 전체 텍스트를 표시하거나 (b) 텍스트를 잘라내고 잘린 버전에서 전체 텍스트에 쉽게 액세스할 수 있는 방법을 제공해야 합니다. 이 요구사항은 댓글이 연결된 리소스 유형 (동영상, 채널 등)과 관계없이 모든 댓글 및 댓글 답글에 적용됩니다. commentThread 리소스의 snippet.topLevelComment 속성 값은 comment 리소스이며 comment 리소스의 목록 속성입니다.replies.comments[] 따라서 이 요구사항은 snippet.topLevelComment.snippet.textDisplay 및 replies.comments[].snippet.textDisplay 속성에도 적용됩니다. |
|
snippet.title( channel) |
필수사항 (제안). 채널 제목
|
|
snippet.title( video) |
조건부 필수 (추천): 동영상의 제목입니다. 댓글이 동영상과 관련된 경우 이 값이 표시되어야 합니다. | |
snippet.moderationStatus |
조건부 필수: API 요청의 moderationStatus 매개변수 값이 heldForReview 또는 likelySpam이면 디스플레이에서 속성 값, 유사한 표현 (예: '검토를 위해 보류 중입니다'), 헤더 (예: '검토를 위해 보류됨') 또는 기타 명확한 언어를 사용하여 상태를 명확하게 나타내야 합니다. commentThreads.list 메서드는 검토 상태에 따라 댓글을 가져오는 기능을 지원합니다. |
|
의견 추가
| 이름 | 설명 | |
|---|---|---|
| 리소스 속성 | ||
snippet.title( channel) |
필수사항: 채널 제목
|
|
snippet.title( video) |
필수사항: 사용자가 동영상에 대한 댓글을 추가하는 경우 API 클라이언트에서 동영상 제목을 표시해야 합니다. | |
| 기타 요구사항 | ||
Comment author's channel name |
필수사항: API 클라이언트는 댓글에 표시된 YouTube 사용자 계정을 명확하게 식별해야 합니다. 요청의 승인 사용자 인증 정보로 콘텐츠 소유자를 식별하고 onBehalfOfContentOwner 매개변수가 설정된 경우 API 사용자는 댓글에 대한 YouTube 채널도 지정할 수 있어야 합니다. |
|
댓글에 답글 달기
| 이름 | 설명 | |
|---|---|---|
| 리소스 속성 | ||
snippet.textDisplay |
필수사항: 댓글의 텍스트입니다. API 클라이언트는 이 문서의 댓글 표시 섹션에 정의된 규칙에 따라 사용자가 답글을 쓰는 댓글의 텍스트를 표시해야 합니다. | |
snippet.title( channel) |
필수사항: 채널 제목
|
|
snippet.title( video) |
필수사항: 사용자가 동영상에 대한 댓글에 답글을 남길 경우 API 클라이언트는 동영상 제목을 표시해야 합니다. | |
| 기타 요구사항 | ||
Comment author's channel name |
필수사항: API 클라이언트는 댓글 답글이 게시될 YouTube 사용자 계정을 명확하게 식별해야 합니다. 요청의 승인 사용자 인증 정보로 콘텐츠 소유자를 식별하고 onBehalfOfContentOwner 매개변수가 설정된 경우 API 사용자는 댓글 답글의 출처가 되는 YouTube 채널도 지정할 수 있어야 합니다. |
|
댓글 답글 수정 또는 삭제
| 이름 | 설명 | |
|---|---|---|
| 리소스 속성 | ||
snippet.textDisplay |
필수사항: 댓글의 텍스트입니다. API 클라이언트는 이 문서의 댓글 표시 섹션에 정의된 규칙에 따라 사용자가 수정하거나 삭제하는 댓글의 텍스트를 표시해야 합니다. | |
snippet.title( channel) |
필수사항: 채널 제목
|
|
snippet.title( video) |
필수사항: 사용자가 동영상에 대한 댓글을 수정하거나 삭제하는 경우 API 클라이언트에서 동영상 제목을 표시해야 합니다. | |
| 기타 요구사항 | ||
Comment author's channel name |
필수사항: API 클라이언트는 댓글에 표시된 YouTube 사용자 계정을 명확하게 식별해야 합니다. | |
사용자를 실시간 채팅에서 차단 (또는 차단 해제)
| 이름 | 설명 | |
|---|---|---|
| 리소스 속성 | ||
snippet.title( channel) |
필수사항: 차단 또는 차단 해제되는 YouTube 채널의 이름입니다. 또한 이름이 채널로 연결되지 않으면 채널 URL도 표시되어야 합니다. | |
| 기타 요구사항 | ||
| 댓글 작성자의 채널 이름 | 필수사항: API 클라이언트는 차단을 추가하거나 삭제하는 데 사용되는 YouTube 사용자 계정을 명확하게 식별해야 합니다. | |