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

لغة العرض التقديمي، كعلامة لغة 47 BCP من مجموعة مهندسي شبكة الإنترنت (IETF)
revisionId

string

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

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

object (Page)

يتم إتقان الملاحظات في العرض التقديمي. وهي تخدم ثلاثة أغراض:

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

تكون الملاحظات الرئيسية للقراءة فقط.

الطُرق

batchUpdate

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

create

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

get

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