Method: presentations.pages.getThumbnail

یک تصویر کوچک از آخرین نسخه از صفحه مشخص شده در ارائه ایجاد می کند و یک URL را به تصویر کوچک برمی گرداند.

این درخواست به عنوان یک درخواست خواندن گران قیمت برای اهداف سهمیه به حساب می آید.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
presentationId

string

شناسه ارائه برای بازیابی.

pageObjectId

string

شناسه شی صفحه که تصویر کوچک آن باید بازیابی شود.

پارامترهای پرس و جو

مولفه های
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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.

ویژگی های بند انگشتی

کنترل ایجاد تصویر کوچک صفحه را فراهم می کند.

نمایندگی JSON
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
زمینه های
mimeType

enum ( MimeType )

نوع میم اختیاری تصویر بند انگشتی.

اگر نوع mime را مشخص نکنید، نوع mime پیش‌فرض PNG است.

thumbnailSize

enum ( ThumbnailSize )

اندازه تصویر کوچک اختیاری.

اگر اندازه را مشخص نکنید، سرور اندازه پیش فرض تصویر را انتخاب می کند.

MimeType

نوع میم تصویر بند انگشتی.

Enums
PNG نوع مایم پیش فرض

اندازه بند انگشتی

اندازه های تصویر کوچک از پیش تعریف شده.

Enums
THUMBNAIL_SIZE_UNSPECIFIED

اندازه تصویر کوچک پیش فرض.

اندازه تصویر کوچک نامشخص نشان می دهد که سرور اندازه تصویر را به گونه ای انتخاب می کند که ممکن است در آینده متفاوت باشد.

LARGE عرض تصویر کوچک 1600 پیکسل.
MEDIUM عرض تصویر کوچک 800 پیکسل.
SMALL عرض تصویر کوچک 200 پیکسل.