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