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

סוג הדף.

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

הטקסט שמעובד כ-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 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 הסוגים הראשונים של 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

קריאת התוכן:

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