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. מאפיינים שספציפיים לכל סוג דף. לא נדרשים נכסים נוספים כדי ליצור קובצי master. הערך של properties יכול להיות רק אחת מהאפשרויות הבאות:
slideProperties

object (SlideProperties)

מאפיינים ספציפיים לשקף. השדה מוגדר רק אם pageType = SLIDE.
layoutProperties

object (LayoutProperties)

נכסים ספציפיים לפריסה. השדה מוגדר רק אם pageType = LAYOUT.
notesProperties

object (NotesProperties)

הערות לגבי נכסים ספציפיים. מוגדר רק אם pageType = NOTES.
masterProperties

object (MasterProperties)

נכסי הורה ספציפיים. השדה מוגדר רק אם pageType = MASTER.

PageType

סוג הדף.

טיפוסים בני מנייה (enum)
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

הטקסט שעבר עיבוד כ-Word Art.

SpeakerSpotlight

סוג PageElement שמייצג 'זרקור על הדובר'.

ייצוג ב-JSON 
{
  "speakerSpotlightProperties": {
    object (