- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- ThumbnailProperties
- MimeType
- ThumbnailSize
- جرِّبه الآن
ينشئ صورة مصغّرة لأحدث نسخة من الصفحة المحددة في العرض التقديمي ويعرض عنوان URL للصورة المصغّرة.
يُحتسب هذا الطلب على أنّه طلب قراءة غير مكلف لأغراض الحصة.
طلب HTTP
GET https://slides.googleapis.com/v1/presentations/{presentationId}/pages/{pageObjectId}/thumbnail
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
presentationId |
رقم تعريف العرض التقديمي المطلوب استرداده. |
pageObjectId |
رقم تعريف الكائن للصفحة المطلوب استرداد صورته المصغّرة. |
معلمات طلب البحث
المَعلمات | |
---|---|
thumbnailProperties |
خصائص الصورة المصغّرة. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
تمثّل هذه السمة الصورة المصغّرة لإحدى الصفحات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "width": integer, "height": integer, "contentUrl": string } |
الحقول | |
---|---|
width |
العرض الإيجابي ببكسل الصورة المصغّرة. |
height |
الارتفاع الإيجابي بالبكسل في الصورة المصغّرة. |
contentUrl |
عنوان URL الخاص بمحتوى الصورة المصغّرة. عمر عنوان URL الخاص بالصورة هو 30 دقيقة بشكل تلقائي. تم وضع علامة على عنوان URL هذا بحساب مقدِّم الطلب. سيتمكن أي مستخدم لديه عنوان URL من الوصول إلى الصورة بشكل فعّال باعتباره مقدِّم الطلب الأصلي. قد يتم فقدان إمكانية الوصول إلى الصورة إذا تغيّرت إعدادات مشاركة العرض التقديمي. نوع MIME للصورة المصغّرة هو نفسه النوع المحدّد في |
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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 |
تمثّل هذه السمة نوع MIME الاختياري للصورة المصغّرة. إذا لم تحدّد نوع MIME، يتم ضبط نوع mime تلقائيًا على تنسيق PNG. |
thumbnailSize |
حجم الصورة المصغّرة الاختياري إذا لم يتم تحديد الحجم، سيختار الخادم حجمًا تلقائيًا للصورة. |
MimeType
نوع MIME للصورة المصغّرة
عمليات التعداد | |
---|---|
PNG |
نوع MIME التلقائي. |
ThumbnailSize
أحجام الصور المصغّرة المحدّدة مسبقًا.
عمليات التعداد | |
---|---|
THUMBNAIL_SIZE_UNSPECIFIED |
الحجم التلقائي للصورة المصغّرة. يشير حجم الصورة المصغّرة غير المحدّد إلى أنّ الخادم يختار حجم الصورة بطريقة قد تختلف في المستقبل. |
LARGE |
يبلغ عرض الصورة المصغّرة 1600 بكسل. |
MEDIUM |
يبلغ عرض الصورة المصغّرة 800 بكسل. |
SMALL |
يبلغ عرض الصورة المصغّرة 200 بكسل. |