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 썸네일 이미지 너비는 1,600픽셀입니다.
MEDIUM 썸네일 이미지 너비는 800픽셀입니다.
SMALL 썸네일 이미지 너비는 200픽셀입니다.