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.

PageType

סוג הדף.

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

רכיב בדף Word Art.
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 (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 רלוונטיים רק לדפים עם pageType LAYOUT.

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

string

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

string

שם הפריסה.
displayName

string

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

NotesProperties

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

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

string

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

MasterProperties

המאפיינים של Page שרלוונטיים רק לדפים עם pageType 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.

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

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