Method: presentations.create

لإنشاء عرض تقديمي فارغ باستخدام العنوان الوارد في الطلب في حال توفّر presentationId، يتم استخدامه كمعرّف للعرض التقديمي الجديد. بخلاف ذلك، يتم إنشاء معرّف جديد. ويتم تجاهل الحقول الأخرى في الطلب، بما في ذلك أي محتوى مقدَّم. لعرض العرض التقديمي الذي تم إنشاؤه.

طلب HTTP

POST https://slides.googleapis.com/v1/presentations

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل 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.

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من Presentation.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.