재생목록에 이미지를 추가합니다.
이 메서드는 미디어 업로드를 지원합니다. 업로드한 파일은 다음 제한사항을 따라야 합니다.
- 최대 파일 크기: 2MB
- 허용되는 가로세로 비율: 1:1 (정사각형)
- 허용되는 미디어 MIME 유형:
image/jpeg
,image/png
할당량 영향: 이 메서드를 호출하면 50단위의 할당량 비용이 발생합니다.
요청
HTTP 요청
POST https://www.googleapis.com/youtube/v3/playlistImages
승인
이 요청에는 다음 범위 중 최소 하나를 사용하여 인증이 필요합니다. (인증 및 승인에 대해 자세히 알아보기)
범위 |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
매개변수
다음 표에는 이 쿼리가 지원하는 매개변수가 나와 있습니다. 나열된 모든 매개변수는 쿼리 매개변수입니다.
매개변수 | ||
---|---|---|
필수 매개변수 | ||
part |
string
|
|
선택적 매개변수 | ||
onBehalfOfContentOwner |
string 이 매개변수는 제대로 인증된 요청에서만 사용할 수 있습니다. 참고: 이 매개변수는 YouTube 콘텐츠 파트너 전용입니다. onBehalfOfContentOwner 매개변수는 요청의 승인 사용자 인증 정보가 매개변수 값에 지정된 콘텐츠 소유자를 대신하는 YouTube CMS 사용자를 식별함을 나타냅니다. 이 매개변수는 다양한 YouTube 채널을 소유하고 관리하는 YouTube 콘텐츠 파트너를 위한 것입니다. 콘텐츠 소유자는 이 기능을 통해 각 개별 채널에 대한 사용자 인증 정보를 제공하지 않고도 한 번만 인증하면 모든 동영상 및 채널 데이터에 액세스할 수 있습니다. 사용자가 인증할 CMS 계정은 지정된 YouTube 콘텐츠 소유자에게 연결되어야 합니다. |
|
onBehalfOfContentOwnerChannel |
string 이 매개변수는 제대로 인증된 요청에서만 사용할 수 있습니다. 참고: 이 매개변수는 YouTube 콘텐츠 파트너 전용입니다. onBehalfOfContentOwnerChannel 매개변수
동영상이 스트리밍되고 있는 채널의 YouTube 채널 ID를 지정합니다.
추가되었습니다. 이 매개변수는 요청이
onBehalfOfContentOwner 매개변수이며
사용할 수 있습니다. 또한 요청은
콘텐츠 소유자에 연결된 CMS 계정을 사용하여 승인된
onBehalfOfContentOwner 매개변수가 지정합니다. 마지막으로
onBehalfOfContentOwnerChannel 매개변수 값이
는
onBehalfOfContentOwner 매개변수가 지정합니다.이 매개변수는 여러 YouTube 콘텐츠를 소유하고 관리하는 확인할 수 있습니다. 콘텐츠 소유자가 한 번만 인증할 수 있습니다. 를 설정하고 매개변수에 지정된 채널을 대신하여 작업을 수행할 수 있습니다. 각 인스턴스에 대해 사용자 인증 정보를 제공할 필요 없이 별도의 채널을 만들어야 합니다. |
요청 본문
요청 본문에 playlistImages 리소스를 제공합니다.
해당 리소스의 경우:
-
다음 속성에 값을 지정해야 합니다.
snippet.playlistId
snippet.type
-
다음 속성에 값을 설정할 수 있습니다.
snippet.width
snippet.height
응답
요청에 성공할 경우 이 메서드는 응답 본문에 playlistImages 리소스를 반환합니다.