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 썸네일 이미지 너비가 1600px입니다.
MEDIUM 썸네일 이미지 너비가 800px입니다.
SMALL 썸네일 이미지 너비가 200px입니다.