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

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