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

الحصول على أحدث نسخة من العرض التقديمي المحدّد.