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