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

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

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

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