Method: presentations.pages.getThumbnail

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

ويتم احتساب هذا الطلب على أنّه طلب قراءة مكلّف لأغراض متعلقة بالحصص.

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المَعلمات
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 للصورة المصغّرة مطابقًا لنوع 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

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

خصائص الصورة المصغّرة

توفّر هذه السياسة إمكانية التحكّم في إنشاء الصورة المصغّرة للصفحة.

تمثيل JSON
{
  "mimeType": enum (MimeType),
  "thumbnailSize": enum (ThumbnailSize)
}
الحقول
mimeType

enum (MimeType)

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

في حال عدم تحديد نوع MIME، سيتم تلقائيًا ضبط نوع MIME على PNG.

thumbnailSize

enum (ThumbnailSize)

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

في حال عدم تحديد الحجم، سيختار الخادم حجم الصورة التلقائي.

نوع Mime

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

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

حجم الصورة المصغّرة

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

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

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

يشير حجم الصورة المصغّرة غير المحدّد إلى أنّ الخادم يختار حجم الصورة بطريقة قد تختلف في المستقبل.

LARGE عرض الصورة المصغّرة 1600 بكسل
MEDIUM يبلغ عرض الصورة المصغّرة 800 بكسل.
SMALL عرض الصورة المصغّرة 200 بكسل