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

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