REST Resource: presentations.pages

منبع: صفحه

یک صفحه در یک ارائه

نمایندگی JSON
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },

  // Union field properties can be only one of the following:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of list of possible types for union field properties.
}
فیلدها
objectId

string

شناسه شی برای این صفحه. شناسه های شی مورد استفاده توسط Page و PageElement فضای نام یکسانی دارند.

pageType

enum ( PageType )

نوع صفحه.

pageElements[]

object ( PageElement )

عناصر صفحه ارائه شده در صفحه.

revisionId

string

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

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

pageProperties

object ( PageProperties )

ویژگی های صفحه

properties میدان اتحادیه ویژگی هایی که برای هر نوع صفحه خاص است. کارشناسی ارشد به هیچ ویژگی اضافی نیاز ندارد. properties فقط می تواند یکی از موارد زیر باشد:
slideProperties

object ( SlideProperties )

ویژگی های خاص اسلاید فقط در صورتی تنظیم کنید که pageType = SLIDE باشد.

layoutProperties

object ( LayoutProperties )

ویژگی های خاص چیدمان فقط اگر pageType = LAYOUT تنظیم کنید.

notesProperties

object ( NotesProperties )

ویژگی های خاص را یادداشت می کند. فقط اگر pageType = NOTES را تنظیم کنید.

masterProperties

object ( MasterProperties )

بر خواص خاص مسلط شوید. فقط در صورتی تنظیم کنید که pageType = MASTER باشد.

نوع صفحه

نوع صفحه

Enums
SLIDE یک صفحه اسلاید
MASTER یک صفحه اسلاید اصلی.
LAYOUT یک صفحه چیدمان
NOTES یک صفحه یادداشت ها
NOTES_MASTER صفحه اصلی یادداشت ها

PageElement

یک عنصر بصری ارائه شده در یک صفحه.

نمایندگی JSON
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  // Union field element_kind can be only one of the following:
  "elementGroup": {
    object (Group)
  },
  "shape": {
    object (Shape)
  },
  "image": {
    object (Image)
  },
  "video": {
    object (Video)
  },
  "line": {
    object (Line)
  },
  "table": {
    object (Table)
  },
  "wordArt": {
    object (WordArt)
  },
  "sheetsChart": {
    object (SheetsChart)
  },
  "speakerSpotlight": {
    object (SpeakerSpotlight)
  }
  // End of list of possible types for union field element_kind.
}
فیلدها
objectId

string

شناسه شی برای این عنصر صفحه. شناسه‌های شی مورد استفاده توسط google.apps.slides.v1.Page و google.apps.slides.v1.PageElement فضای نام یکسانی دارند.

size

object ( Size )

اندازه عنصر صفحه

transform

object ( AffineTransform )

تبدیل عنصر صفحه.

ظاهر بصری عنصر صفحه با تبدیل مطلق آن تعیین می شود. برای محاسبه تبدیل مطلق، تبدیل یک عنصر صفحه را با تبدیل‌های همه گروه‌های والد آن پیشاپیش مرتبط کنید. اگر عنصر صفحه در یک گروه نباشد، تبدیل مطلق آن همان مقدار در این فیلد است.

تبدیل اولیه برای Group تازه ایجاد شده همیشه تبدیل هویت است.

title

string

عنوان عنصر صفحه. همراه با توضیحات برای نمایش متن جایگزین.

این فیلد برای عناصر Group پشتیبانی نمی شود.

description

string

توضیحات عنصر صفحه برای نمایش متن جایگزین با عنوان ترکیب شده است.

این فیلد برای عناصر Group پشتیبانی نمی شود.

element_kind فیلد اتحادیه. نوع عنصری که این PageElement آن را نشان می دهد. هر پیام حاوی هر ویژگی خاص برای آن نوع عنصر صفحه است. element_kind تنها می تواند یکی از موارد زیر باشد:
elementGroup

object ( Group )

مجموعه ای از عناصر صفحه که به عنوان یک واحد به هم پیوسته اند.

shape

object ( Shape )

یک شکل عمومی

image

object ( Image )

یک عنصر صفحه تصویر.

video

object ( Video )

یک عنصر صفحه ویدیویی.

line

object ( Line )

یک عنصر صفحه خط.

table

object ( Table )

یک عنصر صفحه جدول.

wordArt

object ( WordArt )

یک عنصر صفحه هنری کلمه.

sheetsChart

object ( SheetsChart )

نمودار پیوندی تعبیه شده از Google Sheets. نمودارهای بدون پیوند به صورت تصویر نشان داده می شوند.

speakerSpotlight

object ( SpeakerSpotlight )

یک اسپیکر در کانون توجه.

گروه

یک نوع PageElement که نمایانگر مجموعه پیوسته‌ای از PageElements است.

نمایندگی JSON
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
فیلدها
children[]

object ( PageElement )

مجموعه عناصر در گروه حداقل اندازه یک گروه 2 نفر است.

WordArt

یک نوع PageElement که نشان دهنده هنر کلمه است.

نمایندگی JSON
{
  "renderedText": string
}
فیلدها
renderedText

string

متن به عنوان هنر کلمه ارائه شده است.

SpeakerSpotlight

یک نوع PageElement که نمایانگر یک Speaker Spotlight است.

نمایندگی JSON
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
فیلدها
speakerSpotlightProperties

object ( SpeakerSpotlightProperties )

ویژگی های Speaker Spotlight.

SpeakerSpotlight Properties

ویژگی های SpeakerSpotlight .

نمایندگی JSON
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
فیلدها
outline

object ( Outline )

طرح کلی Speaker Spotlight. اگر تنظیم نشود، طرح کلی ندارد.

shadow

object ( Shadow )

سایه Speaker Spotlight. اگر تنظیم نشود، سایه ندارد.

ویژگی های اسلاید

ویژگی های Page که فقط مربوط به صفحات دارای pageType SLIDE است.

نمایندگی JSON
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
فیلدها
layoutObjectId

string

شناسه شی طرح‌بندی که این اسلاید بر اساس آن است. این ویژگی فقط خواندنی است.

masterObjectId

string

شناسه شی اصلی که این اسلاید بر اساس آن است. این ویژگی فقط خواندنی است.

notesPage

object ( Page )

صفحه یادداشت هایی که این اسلاید با آن مرتبط است. هنگام چاپ یا صادرات اسلایدها با یادداشت های بلندگو، ظاهر بصری صفحه یادداشت ها را مشخص می کند. صفحه یادداشت ها ویژگی ها را از notes master به ارث می برد. شکل مکان‌نما با نوع BODY در صفحه یادداشت‌ها حاوی یادداشت‌های سخنران این اسلاید است. شناسه این شکل با فیلد speakerNotesObjectId مشخص می شود. صفحه یادداشت ها فقط خواندنی است به جز محتوای متن و سبک شکل یادداشت های گوینده. این ویژگی فقط خواندنی است.

isSkipped

boolean

اینکه آیا اسلاید در حالت ارائه رد شده است یا خیر. پیش فرض به نادرست.

LayoutProperties

ویژگی های Page فقط مربوط به صفحاتی با pageType LAYOUT است.

نمایندگی JSON
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
فیلدها
masterObjectId

string

شناسه شی اصلی که این طرح بر اساس آن است.

name

string

نام طرح.

displayName

string

نام قابل خواندن برای انسان طرح.

ویژگی های یادداشت ها

ویژگی های Page که فقط مربوط به صفحات دارای pageType NOTES است.

نمایندگی JSON
{
  "speakerNotesObjectId": string
}
فیلدها
speakerNotesObjectId

string

شناسه شی شکل در این صفحه یادداشت‌ها که حاوی یادداشت‌های سخنران برای اسلاید مربوطه است. شکل واقعی ممکن است همیشه در صفحه یادداشت ها وجود نداشته باشد. درج متن با استفاده از این شناسه شی به طور خودکار شکل را ایجاد می کند. در این مورد، شکل واقعی ممکن است شناسه شی متفاوتی داشته باشد. عملکرد presentations.get یا pages.get همیشه آخرین شناسه شی را برمی گرداند.

MasterProperties

ویژگی های Page که فقط مربوط به صفحات دارای pageType MASTER است.

نمایندگی JSON
{
  "displayName": string
}
فیلدها
displayName

string

نام انسان خواندنی استاد.

Page Properties

ویژگی های Page

صفحه خصوصیات را از صفحه والد به ارث می برد. بسته به نوع صفحه، سلسله مراتب در SlideProperties یا LayoutProperties تعریف می شود.

نمایندگی JSON
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
فیلدها
pageBackgroundFill

object ( PageBackgroundFill )

پر کردن پس زمینه صفحه. اگر تنظیم نشده باشد، در صورت وجود، پر کردن پس‌زمینه از صفحه والد به ارث می‌رسد. اگر صفحه فاقد والد باشد، پس‌زمینه پر شده به صورت پیش‌فرض به پر کردن مربوطه در ویرایشگر اسلایدها می‌رسد.

colorScheme

object ( ColorScheme )

رنگ بندی صفحه. اگر تنظیم نشده باشد، طرح رنگ از صفحه والد به ارث می رسد. اگر صفحه والد نداشته باشد، طرح رنگ از یک طرح رنگی پیش‌فرض اسلایدها استفاده می‌کند که با پیش‌فرض‌های ویرایشگر اسلاید مطابقت دارد.

فقط رنگهای بتن 12 ThemeColorType اول قابل ویرایش هستند. علاوه بر این، فقط طرح رنگ در صفحات Master می تواند به روز شود. برای به روز رسانی فیلد، باید یک طرح رنگی حاوی نگاشت از تمام 12 نوع رنگ تم اولیه به رنگ های مشخص آنها ارائه شود. رنگ‌های باقی‌مانده ThemeColorType نادیده گرفته می‌شوند.

PageBackgroundFill

پر کردن پس زمینه صفحه

نمایندگی JSON
{
  "propertyState": enum (PropertyState),

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of list of possible types for union field kind.
}
فیلدها
propertyState

enum ( PropertyState )

حالت پر کردن پس زمینه.

به روز رسانی پر کردن در یک صفحه به طور ضمنی این فیلد را به RENDERED به روز می کند، مگر اینکه مقدار دیگری در همان درخواست مشخص شده باشد. برای اینکه صفحه ای پر نشود، این فیلد را روی NOT_RENDERED تنظیم کنید. در این صورت، سایر فیلدهای پر تنظیم شده در همان درخواست نادیده گرفته می شود.

kind میدان اتحادیه . نوع پر کردن پس زمینه. kind می تواند تنها یکی از موارد زیر باشد:
solidFill

object ( SolidFill )

پر رنگ ثابت

stretchedPictureFill

object ( StretchedPictureFill )

پر کردن تصویر کشیده.

StretchedPictureFill

پر کردن تصویر کشیده. صفحه یا عنصر صفحه به طور کامل با تصویر مشخص شده پر می شود. تصویر به گونه ای کشیده شده است که به ظرف خود برسد.

نمایندگی JSON
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
فیلدها
contentUrl

string

خواندن contentUrl:

URL به یک عکس با طول عمر پیش فرض 30 دقیقه. این URL با حساب درخواست کننده برچسب گذاری شده است. هر کسی که URL را داشته باشد به طور موثر به عنوان درخواست کننده اصلی به تصویر دسترسی پیدا می کند. در صورت تغییر تنظیمات اشتراک‌گذاری ارائه، ممکن است دسترسی به تصویر از بین برود.

نوشتن محتوای URL:

تصویر یک بار در زمان درج واکشی می شود و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه عکس ها باید کمتر از 50 مگابایت باشد، نباید بیشتر از 25 مگاپیکسل باشد و باید در یکی از فرمت های PNG، JPEG یا GIF باشد.

URL ارائه شده می تواند حداکثر 2 کیلوبایت طول داشته باشد.

size

object ( Size )

اندازه اصلی تصویر پر شده است. این فیلد فقط خواندنی است.

ColorScheme

پالت رنگ های از پیش تعریف شده برای یک صفحه.

نمایندگی JSON
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
فیلدها
colors[]

object ( ThemeColorPair )

ThemeColorType و جفت رنگ بتن مربوطه.

ThemeColorPair

یک جفت یک نوع رنگ تم را به رنگ بتنی که نشان می دهد نگاشت می کند.

نمایندگی JSON
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
فیلدها
type

enum ( ThemeColorType )

نوع رنگ تم

color

object ( RgbColor )

رنگ بتن مربوط به نوع رنگ تم بالا.

روش ها

get

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

getThumbnail

یک تصویر کوچک از آخرین نسخه از صفحه مشخص شده در ارائه ایجاد می کند و یک URL را به تصویر کوچک برمی گرداند.