참고: 새로운 YouTube 개발자 정책 준수 가이드에서는 API 클라이언트가 YouTube API 서비스 약관 및 정책(API TOS)의 특정 부분을 준수하도록 하는 데 도움이 되는 안내와 예시를 제공합니다. 이 가이드에서는 YouTube가 API 서비스 약관의 특정 부분을 시행하지만 기존 문서를 대체하지 않는 방식에 대한 유용한 정보를 제공합니다.
이 문서에서는 YouTube API 서비스의 특정 기능("API 클라이언트")을 구현하거나 이에 액세스할 수 있는 API 클라이언트의 최소 기능 요구사항을 정의합니다.
이러한 요구사항과 가이드라인은 API 클라이언트가 YouTube 사용자, 콘텐츠 소유자, 광고주의 이익을 보호하는 일관된 사용자 환경을 제공하도록 보장합니다. 이 규칙은 YouTube API 서비스 약관의 핵심 부분이며 모든 API 클라이언트의 개발 및 구현 과정에서 준수해야 합니다.
기존 YouTube 기능으로 더 나은 사용자 환경을 이용할 수 있도록 이 문서의 요구사항이 변경될 예정입니다. 또한 새로운 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 플레이어가 두 개 이상 있으면 안 됩니다.
-
재생을 시작하는 모든 YouTube 미리보기 이미지는 가로 120픽셀, 세로 70픽셀 이상이어야 합니다.
YouTube 플레이어 속성
플레이어에 YouTube 브랜드가 표시되는 등 YouTube 플레이어의 속성과 매개변수는 YouTube API 문서 및 사양 (https://developers.google.com/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 리소스의 리소스입니다. 따라서 이 요구사항은 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 사용자 계정을 명확하게 식별해야 합니다. | |