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)

ראשי מאפיינים ספציפיים. יש להגדיר רק אם סוג הדף = 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 שמייצג אוסף מצורף של רכיבי דף.

ייצוג JSON
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
שדות
children[]

object (PageElement)

אוסף הרכיבים בקבוצה. הגודל המינימלי של הקבוצה הוא 2.

WordArt

סוג PageElement שמייצג אובייקט טקסט מעוצב.

ייצוג JSON
{
  "renderedText": string
}
שדות
renderedText

string

הטקסט שמעובד כ-WordArt.

SpeakerSpotlight

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

ייצוג JSON
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
שדות
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

המאפיינים של 'זרקור על הדובר'.

SpeakerSpotlightProperties

המאפיינים של SpeakerSpotlight.

ייצוג JSON
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
שדות
outline

object (Outline)

המתאר של 'זרקור על הדובר'. אם המאפיין לא מוגדר, אין לו קו מתאר.

shadow

object (Shadow)

הצל של 'זרקור על הדובר'. אם היא לא מוגדרת, אין לה צל.

SlideProperties

המאפיינים של Page שרלוונטיים רק לדפים עם pageType SLIDE.

ייצוג JSON
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
שדות
layoutObjectId

string

מזהה האובייקט של הפריסה שעליה מבוסס השקף הזה. הנכס הזה הוא לקריאה בלבד.

masterObjectId

string

מזהה האובייקט של המאסטר שעליו מבוסס השקף הזה. הנכס הזה הוא לקריאה בלבד.

notesPage

object (Page)

דף ההערות שאליו משויך השקף הזה. הוא מגדיר את המראה החזותי של דף הערות כשמדפיסים או מייצאים שקפים עם הערות הדובר. דף הערות מקבל בירושה מאפיינים מהnotes master. צורת ה-placeholder מהסוג BODY בדף ההערות מכילה את הערות הדובר בשקף הזה. המזהה של הצורה הזו מזוהה באמצעות השדה speakerNotesObjectId. דף ההערות הוא לקריאה בלבד, מלבד תוכן הטקסט והסגנונות של הצורה של הערות הדובר. הנכס הזה הוא לקריאה בלבד.

isSkipped

boolean

ההגדרה קובעת אם לדלג על השקף במצב מצגת. ברירת המחדל היא False.

LayoutProperties

המאפיינים של Page רלוונטיים רק לדפים עם סוג הדף LAYOUT.

ייצוג JSON
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
שדות
masterObjectId

string

מזהה האובייקט של המאסטר שעליו מבוססת הפריסה.

name

string

שם הפריסה.

displayName

string

שם הפריסה, קריא לאנשים.

NotesProperties

המאפיינים של Page שרלוונטיים רק לדפים עם פתקים מסוג pageType.

ייצוג JSON
{
  "speakerNotesObjectId": string
}
שדות
speakerNotesObjectId

string

מזהה האובייקט של הצורה בדף ההערות הזה, שמכיל את הערות הדובר בשקף המתאים. ייתכן שהצורה בפועל לא תמיד תהיה בדף ההערות. הוספת טקסט באמצעות מזהה האובייקט הזה תיצור את הצורה באופן אוטומטי. במקרה הזה, לצורה בפועל יכול להיות מזהה אובייקט שונה. הפעולה presentations.get או pages.get תמיד תחזיר את מזהה האובייקט העדכני ביותר.

MasterProperties

המאפיינים של Page שרלוונטיים רק לדפים עם סוג דף MASTER.

ייצוג JSON
{
  "displayName": string
}
שדות
displayName

string

שם קריא לאנשים של המאסטר.

PageProperties

המאפיינים של Page.

הדף יקבל בירושה נכסים מדף ההורה. בהתאם לסוג הדף, ההיררכיה מוגדרת ב-SlideProperties או ב-LayoutProperties.

ייצוג JSON
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
שדות
pageBackgroundFill

object (PageBackgroundFill)

מילוי הרקע של הדף. אם המדיניות לא מוגדרת, מילוי הרקע עובר בירושה מדף ההורה, אם הוא קיים. אם לדף אין הורה, מילוי הרקע יופיע כברירת מחדל במילוי המתאים בעורך Slides.

colorScheme

object (ColorScheme)

ערכת הצבעים של הדף. אם המדיניות לא מוגדרת, ערכת הצבעים תעבור בירושה מדף ההורה. אם אין לדף הורה, ערכת הצבעים של Slides משתמשת בברירת המחדל של ערכת הצבעים של Slides, שתואמת לברירות המחדל בעורך Slides.

אפשר לערוך רק את צבעי הבטון של 12 ThemeColorType הראשונים. בנוסף, אפשר לעדכן רק את ערכת הצבעים של דפי Master. כדי לעדכן את השדה, צריך לספק ערכת צבעים שמכילה מיפויים מכל 12 ThemeColorTypes הראשונים של צבעי הבטון שלהם. המערכת תתעלם מהצבעים של ThemeColorTypes שנותרו.

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

כתיבת ה-contentUrl:

התמונה תאוחזר פעם אחת בזמן ההוספה, ועותק יישמר להצגה בתוך המצגת. התמונות צריכות להיות בגודל של פחות מ-50MB, לא יותר מ-25 מגה-פיקסלים ועליהן להיות בפורמט PNG , JPEG או GIF.

כתובת ה-URL שצוינה יכולה להיות באורך של 2kB לכל היותר.

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 לתמונה הממוזערת.