Method: presentations.create

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی 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 )

استادان اسلاید در ارائه. یک اسلاید مستر شامل تمام عناصر رایج صفحه و ویژگی های مشترک برای مجموعه ای از طرح بندی ها است. آنها سه هدف را دنبال می کنند:

  • شکل‌های مکان‌نما در یک Master شامل سبک‌های متن پیش‌فرض و ویژگی‌های شکل همه شکل‌های نگهدارنده در صفحاتی هستند که از آن استاد استفاده می‌کنند.
  • ویژگی های صفحه اصلی ویژگی های رایج صفحه را که توسط طرح بندی آن به ارث می رسد را تعریف می کند.
  • هر شکل دیگری که در اسلاید اصلی وجود دارد، بدون در نظر گرفتن چیدمان آنها، در همه اسلایدها با استفاده از آن Master ظاهر می شود.
layouts[]

object ( Page )

طرح بندی ها در ارائه چیدمان قالبی است که نحوه چیدمان و استایل بندی محتوا را در اسلایدهایی که از آن چیدمان به ارث می برند، تعیین می کند.

locale

string

محل ارائه، به عنوان یک برچسب زبان IETF BCP 47.

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

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