Method: presentations.create

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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

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