Method: presentations.pages.getThumbnail

• طلب HTTP
• مَعلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
  • تمثيل JSON
• نطاقات التفويض
• ThumbnailProperties
  • تمثيل JSON
• MimeType
• ThumbnailSize
• جرِّبه الآن

تنشئ صورة مصغّرة لأحدث نسخة من الصفحة المحدّدة في العرض التقديمي وتعرض عنوان 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 بكسل.