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

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