يتم إنشاء عرض تقديمي فارغ باستخدام العنوان الوارد في الطلب. إذا تم توفير presentationId
، يتم استخدامه كرقم تعريف للعرض التقديمي الجديد. وبخلاف ذلك، يتم إنشاء رقم تعريف جديد. يتم تجاهل الحقول الأخرى في الطلب، بما في ذلك أي محتوى مقدّم. لعرض العرض التقديمي الذي تم إنشاؤه.
طلب HTTP
POST https://slides.googleapis.com/v1/presentations
يستخدم عنوان URL بنية gRPC Transcode.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "presentationId": string, "pageSize": { object ( |
الحقول | |
---|---|
presentationId |
رقم تعريف العرض التقديمي. |
pageSize |
حجم الصفحات في العرض التقديمي. |
slides[] |
الشرائح في العرض التقديمي تكتسب الشريحة السمات من تنسيق الشريحة. |
title |
تمثّل هذه السمة عنوان العرض التقديمي. |
masters[] |
الشرائح الرئيسية في العرض التقديمي يحتوي قسم الشريحة الرئيسية على جميع عناصر الصفحة الشائعة والخصائص الشائعة لمجموعة من التنسيقات. وهي تخدم ثلاثة أغراض:
|
layouts[] |
التنسيقات في العرض التقديمي. التنسيق هو نموذج يحدِّد كيفية ترتيب المحتوى وتصميمه في الشرائح المكتسَبة من ذلك التنسيق. |
locale |
لغة العرض التقديمي، كعلامة لغة IETF BCP 47. |
revisionId |
الإخراج فقط. تمثّل هذه السمة معرّف النسخة السابقة للعرض التقديمي. يمكن استخدام هذه السياسة في طلبات التعديل للتأكّد من أنّ مراجعة العرض التقديمي لم تتغيّر منذ آخر عملية قراءة. لا تتم تعبئته إلا إذا كان لدى المستخدم الإذن بتعديل المحتوى في العرض التقديمي. رقم تعريف النسخة السابقة ليس رقمًا تسلسليًا، ولكنه سلسلة غامضة. وقد يتغيّر تنسيق رقم تعريف النسخة السابقة بمرور الوقت، لذا يجب التعامل معه بشكل مبهم. ونضمن أن يكون رقم تعريف النسخة السابقة صالحًا لمدة 24 ساعة فقط بعد إرجاعه ولا يمكن مشاركته بين المستخدمين. إذا لم يتم تغيير رقم تعريف النسخة السابقة بين المكالمات، لن يتم تغيير العرض التقديمي. وفي المقابل، عادةً ما يعني المعرِّف الذي تم تغييره (للعرض التقديمي والمستخدم نفسه) أنه تم تعديل العرض التقديمي. مع ذلك، يمكن أن يعود رقم التعريف الذي تم تغييره إلى عوامل داخلية مثل التغييرات في تنسيق رقم التعريف. |
notesMaster |
الشريحة الرئيسية للملاحظات في العرض التقديمي وهي تخدم ثلاثة أغراض:
شريحة الملاحظات الرئيسية هي للقراءة فقط. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على نسخة افتراضية تم إنشاؤها حديثًا من Presentation
.
نطاقات الأذونات
يتطلب ذلك أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/presentations
لمزيد من المعلومات، اطّلِع على دليل التفويض.