Google Slides API מאפשר ליצור, להעביר ולמחוק שקפים. הדוגמאות בדף הזה מציגות פעולות נפוצות בשקפים באמצעות השיטה presentations.batchUpdate
.
בדוגמאות הבאות נעשה שימוש במשתנים הבאים:
- PRESENTATION_ID – מציין איפה מזינים את מזהה המצגת. תוכלו לגלות את הערך של המזהה הזה בכתובת ה-URL של המצגת.
- PAGE_ID ו-PAGE_ID2 – מציין איפה מזינים את מזהי האובייקטים בדף. תוכלו לאחזר את הערך הזה מכתובת ה-URL או באמצעות בקשת קריאה ל-API.
הדוגמאות האלה מוצגות כבקשות HTTP ניטרליות מבחינת שפה. במדריכים הבאים מוסבר איך להטמיע עדכון באצווה בשפות שונות באמצעות ספריות הלקוח של Google API: יצירת שקף והוספת צורות וטקסט.
העתקת שקף
דוגמת הקוד הבאה של presentations.batchUpdate
מראה איך להשתמש ב-method DuplicateObjectRequest
כדי להעתיק שקף ולהוסיף אותו אחרי המקור במצגת.
השקף המקורי צוין על ידי PAGE_ID.
הבקשה מאפשרת לציין אם חלק ממזהי הרכיבים של הדף או כולם צריכים להיות בעותק (עם הגבלות מסוימות). בדוגמה הזו, השקף המקורי מכיל רכיב של טבלה (צוין על ידי TABLE_ELEMENT_ID), שממופה לטבלה חדשה (שצוין על ידי COPY_TABLE_ELEMENT_ID) בעותק השקף (שצוין על ידי COPY_PAGE_ID). כל שאר הרכיבים בעותק מקבלים מזהים אקראיים.
למידע נוסף על העתקה של PageElement
, כולל תיבות טקסט, תמונות, טבלאות, צורות בסיסיות, קווים וסרטונים מוטמעים, ראו העתקה ועריכה של רכיב.
לפניכם פרוטוקול הבקשה להעתקת שקף:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "duplicateObject": { "objectId": PAGE_ID, "objectIds": { "PAGE_ID": "COPY_PAGE_ID", "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID" } } } ] }
יצירת שקף
דוגמת הקוד הבאה presentations.batchUpdate
ממחישה איך להשתמש בשיטה CreateSlideRequest
כדי ליצור שקף ולהוסיף אותו כשקף הרביעי (באמצעות insertionIndex
שמבוסס על אפס) במצגת.
השקף החדש מוגדר להשתמש ב-PredefinedLayout
של TITLE_AND_TWO_COLUMNS
. אפשר לציין מחרוזת שתשמש כ-PAGE_ID בשקף (עם הגבלות מסוימות), או לאפשר ל-API ליצור את PAGE_ID על ידי השמטת השדה בבקשה.
לפניכם פרוטוקול הבקשה ליצירת שקף:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": "PAGE_ID", "insertionIndex": 3, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" } } } ] }
יצירת שקף ושינוי ערכי placeholder
דוגמת הקוד הבאה presentations.batchUpdate
ממחישה איך להשתמש ב-method CreateSlideRequest
כדי ליצור שקף באמצעות PredefinedLayout
של TITLE_AND_TWO_COLUMNS
.
אפשר לציין מחרוזת שתשמש כ-PAGE_ID לשקף (עם הגבלות מסוימות).
הקוד placeholderIdMappings
משתמש ב-Type
של TITLE
. השדה TITLE_ID מפנה לצורה של ה-placeholder של השקף, כדי שאפשר יהיה לשנות אותו.
לפניכם פרוטוקול הבקשה ליצירת שקף ולשינוי ערכי placeholder:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createSlide": { "objectId": PAGE_ID, "slideLayoutReference": { "predefinedLayout": "TITLE_AND_TWO_COLUMNS" }, "placeholderIdMappings": [ { "layoutPlaceholder": { "type": "TITLE", "index": 0 }, "objectId": TITLE_ID, }, ], } }, { "insertText": { "objectId": TITLE_ID, "text": "This is my slide title", } }, ] }
העברת שקפים למיקום חדש
דוגמת הקוד הבאה של presentations.batchUpdate
מראה איך להשתמש ב-method UpdateSlidesPositionRequest
כדי להעביר את שני השקפים שצוינו ולהעביר אותם לתחילת המצגת, תוך שמירה על הסדר היחסי שלהם.
יש לספק את מזהי השקפים שצוינו (PAGE_ID ו-PAGE_ID2) בסדר הקיים של המצגת, ללא כפילויות. השדה insertionIndex
מבוסס-אפס מציין איפה צריך להוסיף את השקפים, לפי הסדר לפני ביצוע ההעברה. הערך חייב להיות בין אפס למספר השקפים במצגת, כולל.
לפניכם פרוטוקול הבקשה להעברת שקפים למיקום חדש:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateSlidesPosition": { "slideObjectIds": [ PAGE_ID, PAGE_ID2 ], "insertionIndex": 0 } } ] }
הגדרה של תמונת רקע לשקף
דוגמת הקוד הבאה של presentations.batchUpdate
מראה איך להשתמש ב-method UpdatePagePropertiesRequest
כדי להגדיר את תמונת הרקע של שקף שצוין ב-PAGE_ID. ה-API מאחזר את התמונה באמצעות IMAGE_URL.
מסכת שדה משמשת כדי לציין שצריך לשנות רק את רקע השקף על מנת לשמור את המאפיינים האחרים. השימוש במסכות של שדות גם משפר את הביצועים.
לחלופין, אפשר להשתמש בשיטה UpdatePagePropertiesRequest
כדי להגדיר את הרקע של שקף לצבע אחיד.
לפניכם פרוטוקול הבקשה להגדרת תמונת רקע של שקף:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updatePageProperties": { "objectId": PAGE_ID, "pageProperties": { "pageBackgroundFill": { "stretchedPictureFill": { "contentUrl": IMAGE_URL } } }, "fields": "pageBackgroundFill" } } ] }
יצירת תמונה ממוזערת
אפשר ליצור תמונה ממוזערת של הגרסה האחרונה של דף מסוים במצגת באמצעות השיטה presentations.pages.getThumbnail
, שמחזירה תמונה ממוזערת של הדף ככתובת URL של תוכן. כברירת מחדל, לכתובת ה-URL של התמונה יש משך חיים של 30 דקות.
אפשר גם לציין את השדה mimeType
ואת הערך thumbnailSize
שהוחזרו באמצעות השדה ThumbnailProperties
כפרמטר של שאילתה.
זה פרוטוקול הבקשה ליצירת התמונה הממוזערת של הדף עם הערך ThumbnailProperties
:
GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM
{ "width": 800, "height": 450, "contentUrl": "CONTENT_URL" }