REST Resource: presentations

منبع: ارائه

یک ارائه گوگل اسلاید.

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

فقط خروجی. حالت نمایش نظرات برای ارائه اعمال می‌شود.

روش‌ها

batchUpdate

 یک یا چند به‌روزرسانی را به ارائه اعمال می‌کند.

create

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

get

 آخرین نسخه از ارائه مشخص شده را دریافت می‌کند.