Method: presentations.pages.getThumbnail

프레젠테이션에 지정된 페이지의 최신 버전 썸네일을 생성하고 썸네일 이미지에 대한 URL을 반환합니다.

이 요청은 할당량을 기준으로 비용이 많이 드는 읽기 요청으로 집계됩니다.

HTTP 요청

GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
presentationId

string

검색할 프레젠테이션의 ID입니다.

pageObjectId

string

썸네일을 검색할 페이지의 객체 ID입니다.

쿼리 매개변수

매개변수
thumbnailProperties

object (ThumbnailProperties)

썸네일 속성

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

페이지의 썸네일입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{
  "width": integer,
  "height": integer,
  "contentUrl": string
}
필드
width

integer

썸네일 이미지의 양수 너비(픽셀)입니다.

height

integer

미리보기 이미지의 양수 높이(픽셀)입니다.

contentUrl

string

썸네일 이미지의 콘텐츠 URL입니다.

이미지 URL의 기본 수명은 30분입니다. 이 URL에는 요청자의 계정으로 태그가 지정됩니다. URL이 있는 사람은 누구나 원래 요청자로서 이미지에 효과적으로 액세스합니다. 프리젠테이션의 공유 설정이 변경되면 이미지에 액세스하지 못할 수 있습니다. 썸네일 이미지의 MIME 유형은 GetPageThumbnailRequest에 지정된 유형과 동일합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/presentations
  • https://www.googleapis.com/auth/presentations.readonly

자세한 내용은 승인 가이드를 참조하세요.

ThumbnailProperties

페이지 미리보기 이미지 생성을 관리할 수 있습니다.

JSON 표현
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
필드
mimeType

enum (MimeType)

썸네일 이미지의 MIME 유형(선택사항)입니다.

MIME 유형을 지정하지 않으면 MIME 유형이 PNG로 기본 설정됩니다.

thumbnailSize

enum (ThumbnailSize)

썸네일 이미지 크기(선택사항)입니다.

크기를 지정하지 않으면 서버에서 이미지의 기본 크기를 선택합니다.

MimeType

썸네일 이미지의 MIME 유형입니다.

열거형
PNG 기본 MIME 유형입니다.

ThumbnailSize

사전 정의된 썸네일 이미지 크기입니다.

열거형
THUMBNAIL_SIZE_UNSPECIFIED

기본 썸네일 이미지 크기입니다.

지정되지 않은 썸네일 크기는 서버가 향후 달라질 수 있는 방식으로 이미지의 크기를 선택함을 의미합니다.

LARGE 1600픽셀의 썸네일 이미지 너비입니다.
MEDIUM 800픽셀의 썸네일 이미지 너비입니다.
SMALL 200픽셀의 썸네일 이미지 너비입니다.