Method: presentations.create

یک ارائه خالی با استفاده از عنوان داده شده در درخواست ایجاد می‌کند. اگر یک presentationId ارائه شده باشد، به عنوان شناسه ارائه جدید استفاده می‌شود. در غیر این صورت، یک شناسه جدید ایجاد می‌شود. سایر فیلدهای درخواست، از جمله هرگونه محتوای ارائه شده، نادیده گرفته می‌شوند. ارائه ایجاد شده را برمی‌گرداند.

درخواست HTTP

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

این URL از سینتکس Transcoding در 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

فقط خروجی. شناسه‌ی ویرایش ارائه. می‌تواند در درخواست‌های به‌روزرسانی برای اثبات اینکه ویرایش ارائه از آخرین عملیات خواندن تغییر نکرده است، استفاده شود. فقط در صورتی پر می‌شود که کاربر دسترسی ویرایش به ارائه را داشته باشد.

شناسه‌ی بازبینی یک عدد ترتیبی نیست، بلکه یک رشته‌ی مبهم است. قالب شناسه‌ی بازبینی ممکن است با گذشت زمان تغییر کند، بنابراین باید با آن به صورت مبهم برخورد شود. یک شناسه‌ی بازبینی بازگردانده شده فقط تا ۲۴ ساعت پس از بازگرداندن آن معتبر است و نمی‌توان آن را بین کاربران به اشتراک گذاشت. اگر شناسه‌ی بازبینی بین فراخوانی‌ها بدون تغییر باشد، ارائه تغییر نکرده است. برعکس، یک شناسه‌ی تغییر یافته (برای همان ارائه و کاربر) معمولاً به این معنی است که ارائه به‌روزرسانی شده است. با این حال، یک شناسه‌ی تغییر یافته همچنین می‌تواند به دلیل عوامل داخلی مانند تغییرات قالب شناسه باشد.

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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.