Method: presentations.pages.getThumbnail

تنشئ صورة مصغّرة لأحدث نسخة من الصفحة المحدّدة في العرض التقديمي وتعرض عنوان URL للصورة المصغّرة.

يُعتبَر هذا الطلب طلب قراءة مكلفًا لأغراض الحصة.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
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

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

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 بكسل.