Method: presentations.create

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

نص الطلب

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

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

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