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)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
الحقول
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.

شريحة العرض الرئيسية للملاحظات مخصّصة للقراءة فقط.
comments[]

object (CommentThread)

النتائج فقط. سلاسل التعليقات المرتبطة بالعرض التقديمي
commentsViewMode

enum (CommentsViewMode)

النتائج فقط. تمثّل هذه السمة وضع عرض التعليقات المطبَّق على العرض التقديمي.

نص الاستجابة

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

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

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

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