Method: presentations.pages.getThumbnail

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

این درخواست به عنوان یک درخواست خواندن پرهزینه برای اهداف سهمیه‌بندی محسوب می‌شود.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
presentationId

string

شناسه‌ی ارائه‌ای که قرار است بازیابی شود.

pageObjectId

string

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

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

پارامترها
thumbnailProperties

object ( ThumbnailProperties )

ویژگی‌های تصویر بندانگشتی.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

تصویر کوچک یک صفحه.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "width": integer,
  "height": integer,
  "contentUrl": string
}
فیلدها
width

integer

عرض مثبت تصویر بندانگشتی بر حسب پیکسل.

height

integer

ارتفاع مثبت تصویر بندانگشتی بر حسب پیکسل.

contentUrl

string

آدرس اینترنتی (URL) محتوای تصویر بندانگشتی.

طول عمر پیش‌فرض URL مربوط به تصویر ۳۰ دقیقه است. این 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 را مشخص نکنید، نوع mime به صورت پیش‌فرض PNG در نظر گرفته می‌شود.

thumbnailSize

enum ( ThumbnailSize )

اندازه تصویر بندانگشتی اختیاری.

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

نوع مایم

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

انوم‌ها
PNG نوع MIME پیش‌فرض.

اندازه تصویر بندانگشتی

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

انوم‌ها
THUMBNAIL_SIZE_UNSPECIFIED

اندازه تصویر بندانگشتی پیش‌فرض.

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

LARGE عرض تصویر بندانگشتی ۱۶۰۰ پیکسل است.
MEDIUM عرض تصویر بندانگشتی ۸۰۰ پیکسل است.
SMALL عرض تصویر بندانگشتی ۲۰۰ پیکسل است.