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، سيتم ضبطه تلقائيًا على PNG.
thumbnailSize

enum (ThumbnailSize)

حجم الصورة المصغّرة الاختياري

إذا لم تحدّد حجم الصورة، سيختار الخادم حجمًا تلقائيًا لها.

MimeType

نوع MIME للصورة المصغّرة

عمليات التعداد
PNG نوع MIME التلقائي

ThumbnailSize

أحجام الصور المصغّرة المحدّدة مسبقًا

عمليات التعداد
THUMBNAIL_SIZE_UNSPECIFIED

حجم الصورة المصغّرة التلقائي

يشير حجم الصورة المصغّرة غير المحدّد إلى أنّ الخادم يختار حجم الصورة بطريقة قد تختلف في المستقبل.
LARGE يجب أن يكون عرض الصورة المصغّرة 1600 بكسل.
MEDIUM يجب أن يكون عرض الصورة المصغّرة 800 بكسل.
SMALL يجب أن يكون عرض الصورة المصغّرة 200 بكسل.