REST Resource: presentations

المرجع: عرض تقديمي

عرض تقديمي في "العروض التقديمية من Google"

تمثيل JSON
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
الحقول
presentationId

string

رقم تعريف العرض التقديمي.

pageSize

object (Size)

حجم الصفحات في العرض التقديمي

slides[]

object (Page)

الشرائح في العرض التقديمي يكتسب الشريحة خصائص من تنسيق شريحة.

title

string

عنوان العرض التقديمي

masters[]

object (Page)

الشرائح الرئيسية في العرض التقديمي يحتوي شريحة الجمهور الرئيسية على جميع عناصر الصفحة الشائعة والخصائص المشتركة لمجموعة من التخطيطات. وتخدم هذه الرسائل ثلاثة أغراض:

  • تشتمل أشكال العناصر النائبة على الشريحة الرئيسية على أنماط النص الافتراضية وخصائص الأشكال لجميع أشكال العناصر النائبة في الصفحات التي تستخدم تلك الشريحة الرئيسية.
  • تحدِّد خصائص الصفحة الرئيسية خصائص الصفحة الشائعة التي تكتسبها تنسيقاتها.
  • تظهر أي أشكال أخرى على الشريحة الرئيسية في جميع الشرائح التي تستخدم هذه الشريحة الرئيسية، بغض النظر عن تنسيقها.
layouts[]

object (Page)

التنسيقات في العرض التقديمي التخطيط هو قالب يحدد كيفية ترتيب المحتوى وتصميمه على الشرائح التي ترث من هذا التنسيق.

locale

string

لغة العرض التقديمي، بصفتها علامة لغة IETF BCP 47

revisionId

string

النتائج فقط. معرّف النسخة السابقة للعرض التقديمي. يمكن استخدامها في طلبات التعديل للتأكّد من أنّ مراجعة العرض التقديمي لم تتغيّر منذ آخر عملية قراءة. لا تتم تعبئة هذا الحقل إلا إذا كان لدى المستخدم الإذن بتعديل العرض التقديمي.

معرّف المراجعة ليس رقمًا تسلسليًا بل سلسلة غير واضحة. قد يتغيّر تنسيق معرّف المراجعة بمرور الوقت، لذا يجب التعامل معه بشكل غير شفاف. لا يمكن ضمان صلاحية معرّف المراجعة الذي تم إرجاعه إلا لمدة 24 ساعة بعد إرجاعه، ولا يمكن مشاركته مع جميع المستخدمين. إذا لم يتغيّر رقم تعريف النسخة بين المكالمات، هذا يعني أنّ العرض التقديمي لم يتغيّر. في المقابل، يعني رقم التعريف المتغيّر (للعرض التقديمي والمستخدم نفسهما) عادةً أنّه تم تعديل العرض التقديمي. ومع ذلك، يمكن أن يرجع سبب تغيير رقم التعريف أيضًا إلى عوامل داخلية، مثل تغييرات تنسيق رقم التعريف.

notesMaster

object (Page)

ملاحظات رئيسية في العرض التقديمي ويخدم هذا الإجراء ثلاثة أغراض:

  • تحتوي أشكال العناصر النائبة في نموذج ملاحظات رئيسي على أنماط النصوص التلقائية وخصائص الأشكال لجميع أشكال العناصر النائبة في notes pages. على وجه التحديد، يحتوي الشكل النائب SLIDE_IMAGE على الصورة المصغّرة للشريحة، ويحتوي الشكل النائب BODY على ملاحظات المحاضر.
  • تحدّد سمات الصفحة الرئيسية للملاحظات سمات الصفحة الشائعة التي يتم اكتسابها من قِبل جميع notes pages.
  • تظهر أي أشكال أخرى في نموذج الملاحظات الرئيسي على جميع notes pages.

جدول ملاحظات رئيسي للقراءة فقط

الطُرق

batchUpdate

تطبِّق تحديثًا واحدًا أو أكثر على العرض التقديمي.

create

ينشئ عرضًا تقديميًا فارغًا باستخدام العنوان الوارد في الطلب.

get

تحصل على أحدث إصدار من العرض التقديمي المحدّد.