REST Resource: presentations

משאב: מצגת

מצגת ב-Google Slides.

ייצוג JSON 
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
שדות
presentationId

string

המזהה של המצגת.
pageSize

object (Size)

גודל הדפים במצגת.
slides[]

object (Page)

השקפים במצגת. שקף יורש מאפיינים מתבנית שקף.
title

string

שם המצגת.
masters[]

object (Page)

תבניות השקפים במצגת. תבנית שקף מכילה את כל רכיבי הדף הנפוצים ואת המאפיינים הנפוצים של קבוצת פריסות. יש להם שלוש מטרות:

  • צורות placeholder במאסטר כוללות את סגנונות הטקסט ואת מאפייני הצורה שמוגדרים כברירת מחדל בכל הצורות למעקב אחרי ביקורים בדפים שמשתמשים במאסטר הזה.
  • המאפיינים של דף המאסטר מגדירים את המאפיינים הנפוצים של הדף שעברו בירושה לפריסות שלו.
  • כל הצורות האחרות בשקף הראשי מופיעות בכל השקפים שמשתמשים בשקף הראשי הזה, ללא קשר לפריסה שלהן.
layouts[]

object (Page)

הפריסות במצגת. פריסה היא תבנית שקובעת את האופן שבו התוכן מוצג ומתוכנן בשקפים שעוברים בירושה את הפריסה הזו.
locale

string

הלוקאל של המצגת, בתור תג שפה של IETF BCP 47.
revisionId

string

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

מזהה הגרסה הוא לא מספר רציף, אלא מחרוזת לא ברורה. הפורמט של מזהה הגרסה עשוי להשתנות עם הזמן, לכן צריך להתייחס אליו כאל ערך אטום. מובטח שמזהה הגרסה שהוחזר יהיה תקף רק ל-24 שעות לאחר החזרתו, ולא ניתן לשתף אותו עם משתמשים. אם מזהה הגרסה לא השתנה בין הקריאות, סימן שהמצגת לא השתנתה. לעומת זאת, אם המזהה השתנה (באותו משתמש ובאותה מצגת), בדרך כלל המשמעות היא שהמצגת עודכנה. עם זאת, שינוי במזהה יכול לנבוע גם מגורמים פנימיים, כמו שינויים בפורמט המזהה.
notesMaster

object (Page)

גיליון הערות הראשי במצגת. הוא משמש לשלוש מטרות:

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

גיליון הערות הראשי הוא לקריאה בלבד.

שיטות

batchUpdate

 החלת עדכון אחד או יותר על המצגת.

create

 יצירת מצגת ריקה לפי הכותרת שמופיעה בבקשה.

get

 קבלת הגרסה האחרונה של המצגת שצוינה.