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

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

גוף התשובה

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

היקפי הרשאות

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

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

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