YouTube에서 Shorts 동영상의 조회수를 집계하는 방식에 맞게 Data API를 업데이트하고 있습니다.
자세히 알아보기
PlaylistImages
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
playlistImage
리소스는 재생목록과 연결된 썸네일 이미지를 식별합니다.
속성
다음 표는 이 리소스에 표시되는 속성을 정의합니다.
속성 |
kind |
string
API 리소스의 유형을 식별합니다. 값은 youtube#playlistImage 입니다. |
id |
string
YouTube가 재생목록 이미지를 고유하게 식별하는 데 사용하는 ID입니다. |
snippet |
object
snippet 객체에는 유형, 크기 등 재생목록 이미지에 관한 기본 세부정보가 포함됩니다. |
snippet.playlistId |
string
이 이미지가 연결된 재생목록의 재생목록 ID입니다. |
snippet.type |
string
이미지 유형입니다.
|
snippet.width |
string
이미지의 너비입니다. |
snippet.height |
string
이미지의 높이입니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[null,null,["최종 업데이트: 2025-08-21(UTC)"],[[["\u003cp\u003eA playlistImage resource in the YouTube API represents the thumbnail image associated with a specific playlist.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides methods to list, insert, update, and delete playlist images, allowing for comprehensive management of playlist thumbnails.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eplaylistImages\u003c/code\u003e resource contains properties such as \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, and \u003ccode\u003esnippet\u003c/code\u003e, with the \u003ccode\u003esnippet\u003c/code\u003e object detailing the associated playlist's ID, image type, width, and height.\u003c/p\u003e\n"],["\u003cp\u003eThe API's \u003ccode\u003eplaylistImages\u003c/code\u003e resource structure is in JSON format, and the value of \u003ccode\u003ekind\u003c/code\u003e is always \u003ccode\u003eyoutube#playlistImage\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `playlistImage` resource represents a playlist's thumbnail. The API provides methods to interact with these images: `list` retrieves images, `insert` adds an image, `update` modifies an existing image, and `delete` removes an image. Each `playlistImage` resource contains an `id`, `kind` which will always be `youtube#playlistImage`, and a `snippet` with details like `playlistId`, `type`, `width`, and `height` of the image.\n"],null,["# PlaylistImages\n\nA **playlistImage** resource identifies\nthe thumbnail image associated with a playlist.\n\nMethods\n-------\n\nThe API supports the following methods for `playlistImages` resources:\n\n[list](/youtube/v3/docs/playlistImages/list)\n: Returns a collection of playlist images that match the API request parameters.\n [Try it now](/youtube/v3/docs/playlistImages/list#usage).\n\n[insert](/youtube/v3/docs/playlistImages/insert)\n: Adds a thumbail image to a playlist.\n [Try it now](/youtube/v3/docs/playlistImages/insert#usage).\n\n[update](/youtube/v3/docs/playlistImages/update)\n: Updates the thumbnail image for an existing playlist.\n [Try it now](/youtube/v3/docs/playlistImages/update#usage).\n\n[delete](/youtube/v3/docs/playlistImages/delete)\n: Deletes a playlist thumbnail image.\n [Try it now](/youtube/v3/docs/playlistImages/delete#usage).\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `playlistImages` resource: \n\n```carbon\n{\n \"#kind\": \"youtube#playlistImage\",\n \"#id\": string,\n \"#snippet\": {\n \"#snippet.playlistId\": string,\n \"#snippet.type\": string,\n \"#snippet.width\": string,\n \"#snippet.height\": string,\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|----------------------|-----------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#playlistImage`. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the playlist image. |\n| `snippet` | `object` The `snippet` object contains basic details about the playlist image, such as its type and dimensions. |\n| snippet.`playlistId` | `string` The playlist ID of the playlist this image is associated with. |\n| snippet.`type` | `string` The image type. |\n| snippet.`width` | `string` The image's width. |\n| snippet.`height` | `string` The images's height. |"]]