באמצעות Google Slides API אפשר ליצור, להעביר ולמחוק שקפים. הדוגמאות באתר
בדף הזה תמצאו כמה פעולות נפוצות בשקף באמצעות
presentations.batchUpdate
.
בדוגמאות האלה משתמשים במשתנים הבאים:
- PRESENTATION_ID – מציין איפה אתם מספקים את מצגת מזהה. אפשר לגלות את הערך של המזהה בכתובת ה-URL של המצגת.
- PAGE_ID וPAGE_ID2 – מציין איפה מספקים את אובייקט הדף מזהים. אפשר לאחזר את הערך הזה מכתובת ה-URL או באמצעות בקשת קריאה ל-API.
הדוגמאות האלה מוצגות כבקשות HTTP כך שהשפה תהיה ניטרלית. למידה איך לבצע עדכון בכמות גדולה בשפות שונות באמצעות Google API לספריות לקוח, קראו את המדריכים הבאים: שקף והוספת צורות text.
העתקת שקף
הבאים
presentations.batchUpdate
דוגמת הקוד מראה איך להשתמש
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
דוגמת הקוד מראה איך להשתמש
CreateSlideRequest
כדי ליצור שקף באמצעות
PredefinedLayout
מתוך TITLE_AND_TWO_COLUMNS
.
אפשר לציין מחרוזת שתשמש כ-PAGE_ID בשקף
(עם חלק
הגבלות).
placeholderIdMappings
משתמשת ב
Type
מתוך
TITLE
. הרכיב TITLE_ID מפנה לצורת ה-placeholder של השקף
כדי שאפשר יהיה לשנות אותו.
זה פרוטוקול הבקשה ליצירת שקף ולשינוי placeholders:
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
דוגמת הקוד מראה איך להשתמש
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
דוגמת הקוד מראה איך להשתמש
UpdatePagePropertiesRequest
כדי להגדיר את תמונת הרקע של שקף שצוין
PAGE_ID. ה-API מאחזר את התמונה באמצעות
IMAGE_URL
נעשה שימוש באנונימיזציה של שדות כדי לציין שרק כדי לשמר את המאפיינים האחרים, צריך לשנות את הרקע של השקף. שימוש בשדה מסכות גם משפרות את הביצועים.
לחלופין, אפשר להשתמש ב-method 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" }