Method: presentations.create

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

בקשת HTTP

POST https://slides.googleapis.com/v1/presentations

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

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

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

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע חדש של Presentation.

היקפי ההרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

מידע נוסף זמין במדריך להרשאות.