Google Slides API מאפשר ליצור ולשנות מצגות ב-Google Slides.
אפליקציות יכולות להשתלב עם ה-API של Google Slides כדי ליצור תצוגות יפהפיות של שקפים באופן אוטומטי מפרטים שהמשתמשים סיפקו והמערכת. לדוגמה, אפשר: להשתמש בפרטי לקוחות ממסד נתונים ולשלב אותם עם תבניות ואפשרויות התצורה שנבחרו כדי ליצור מצגות שהסתיימו תוך זמן קצר מאוד מהזמן שנדרש כדי ליצור אותם באופן ידני.
סקירה כללית של ה-API
אוסף המצגות כולל שיטות שמאפשרות לקבל ולעדכן רכיבים בתוך המצגת.
רוב העבודה שלכם עם Slides API היא כנראה יצירה ועדכון ומצגות. אפשר לעשות את זה באמצעות batchUpdate; השיטה הזאת לוקחת רשימה בקשה שמאפשרים לבצע פעולות כמו:
- יצירת שקפים
- להוסיף רכיבים לשקפים, כמו צורות או טבלאות
- הוספה, שינוי והסרה של טקסט
- החילו התמרות על יסודות
- שינוי סדר השקפים
לפרטים נוספים, ראו עדכונים באצווה. לעיון במדריכים לתחילת העבודה לקבלת דוגמה פשוטה מקצה לקצה לאופן השימוש ב-API.
המבנה של מצגת
מצגת ב-Slides API מורכבת מדפים שכוללים דף רכיבים.
ניתן לגזור את מזהה המצגת מכתובת ה-URL:
https://docs.google.com/presentation/d/presentationId/edit
מזהה המצגת הוא מחרוזת שמכילה אותיות, מספרים וגם תווים. אפשר להשתמש בביטוי הרגולרי הבא כדי לחלץ את הביטוי מזהה המצגת מכתובת URL של Google Sheets:
/presentation/d/([a-zA-Z0-9-_]+)
אם אתם מכירים את Drive API, ה-presentationId
תואם ל
המזהה של הקובץ
משאב.
דפים ורכיבי דפים מזוהים באמצעות מזהי אובייקטים.
iWork Pages
ב-Google Slides קיימים סוגי הדפים הבאים:
תואר שני | תבניות ראשיות לשקפים מגדירים את סגנונות ברירת המחדל של הטקסט, הרקע והדף שמופיעים בכל השקפים שמשתמשים במאסטר הזה. דף את הרכיבים שחייבים להופיע בכל השקפים יש להוסיף למאסטר. נפוצים למצגות יש מאסטר אחד, אך לחלקן יש כמה מאסטרים או ללא חלק מהן. |
פריסות | הפריסות משמשות כתבנית לאופן שבו רכיבי הדף יסודרו לפי כברירת מחדל בשקפים באמצעות פריסה. כל פריסה משויכת במאסטר. |
מגלשות | הדפים האלה מכילים את התוכן שאתם מציגים לקהל. רוב השקפים מבוססים על מאסטר ופריסה. אפשר לציין פריסה שמותאמת לכל שקף כשיוצרים אותו. |
הערות | הדפים האלה מכילים את התוכן לדפי מידע של מצגות, כולל צורה שמכילה את הערות הדובר בשקף. בכל שקף יש בדף ההערות המתאים. רק הטקסט שמופיע בצורה של הערות הדובר שונה באמצעות ה-API של Slides. |
מאסטרים לפתקים | המאסטרים של ההערות מגדירים את סגנונות הטקסט ואת רכיבי הדף שמוגדרים כברירת מחדל לכל הפריטים בדפי הערות. המאסטרים של ההערות מוגדרים לקריאה בלבד ב-Slides API. |
רכיבי הדף
רכיבי דף הם הרכיבים החזותיים שממוקמים בדפים. ממשק API חושף כמה סוגים של אלמנטים בדף:
קבוצה | קבוצה של רכיבי דף שנחשבים כיחידה בודדת. הן יכולות לעבור, לשנות את קנה המידה ולסובב אותו יחד. |
צורה | אובייקט חזותי פשוט, כמו מלבנים, אליפסות ותיבות טקסט. צורות יכולות להכיל טקסט, ולכן הן רכיבי הדף הנפוצים ביותר לבנייה שקפים. |
תמונה | גרפיקה יובאה אל Slides. |
וידאו | סרטון יובא אל Slides. |
קו | קו חזותי, עקומה או מחבר. |
טבלה | רשת של תוכן. |
WordArt | רכיב טקסט חזותי שמתנהג יותר כמו צורה. |
SheetsChart | תרשים שיובא ל-Slides מ-Google Sheets. |
עדכונים בכמות גדולה
שיטת batchUpdate מאפשרת לעדכן היבטים רבים במצגת. השינויים מקובצים יחד לפי אצווה, כך שאם בקשה אחת תיכשל, אף בקשה לא תהיה תלויה יותר) ושינויים נכתבים.
השיטה batchUpdate
עובדת על ידי שימוש באחת או יותר
בקשה
אובייקטים, שכל אחד מהם מציין סוג אחד של בקשה לביצוע. יש
סוגים רבים ושונים של בקשות. כאן מופיע פירוט של סוגי הבקשות,
בקבוצות שונות.
השיטה batchUpdate
מחזירה גוף תשובה,
שמכיל
תשובה
בכל בקשה. לכל תשובה יש אינדקס זהה לזה של התגובה
בקשה; לבקשות שאין להן תגובה רלוונטית, התגובה באותו אינדקס
תהיה ריקה. בדרך כלל לבקשות השונות של Create
יש תשובות, לכן
שאתם יודעים מהו המזהה של האובייקט החדש שנוסף.
עבודה עם מזהי אובייקטים
מצגת ב-API של Slides מורכבת מדפים ומרכיבי דפים. האובייקטים האלה כוללים מחרוזת מזהה אובייקט ייחודית בתוך מצגת.
ציון מזהי אובייקטים בזמן היצירה
כשיוצרים דפים או רכיבי דף באמצעות batchUpdate, יכול באופן אופציונלי לציין מזהה אובייקט עבור האובייקט החדש. כך אפשר ליצור לאובייקט ולשנות אותו באותה בקשה ב-batchUpdate, תוך צמצום המספר קריאות ל-API של Slides וצמצום השימוש במכסות.
ברוב המקרים מומלץ ליצור מזהה אובייקט אקראי. לדוגמה, אם
משתמשים ב-Java, java.util.UUID.randomUUID().toString()
אמורה לפעול היטב.
כשהאפליקציה רוצה לעקוב אחר אובייקטים לאורך תקופה ארוכה יותר של לא מסתמכים על מזהה האובייקט, כי הוא עשוי להשתנות. כדאי לעיין בנושאים הבאים לקבלת פרטים נוספים.
מעקב אחרי אובייקטים בלי להשתמש במזהה האובייקט
כששולחים בקשת API ל-Slides, מזהה האובייקט נשמר בדרך כלל. (כל ערך המקרים החריגים מצוינים במסמכי העזר של השיטה). ביצוע בעותק של כל המצגת באמצעות Drive API נשמרים גם מזהי האובייקטים.
עם זאת, אי אפשר להסתמך על כך שמזהה אובייקט לא ישתנה אחרי מצגת משתנה בממשק המשתמש של Slides. לדוגמה, אם מישהו משתמש במצגת ב-Slides, ממשק משתמש להעתקה-הדבקה של רכיב בדף ואז מוחק את רכיב הדף המקורי יהיה מזהה ייחודי חדש, והמזהה שסיפקתם בעבר דרך ה-API יאבדו. לכן לא מומלץ לאחסן מזהי אובייקטים ב באחסון של האפליקציה. במקום זאת, צריך למצוא אובייקטים במצגת לפי את תוכן הטקסט או את הטקסט החלופי שלו.
במצגות חדשות שנוצרות בדרך כלל נעשה שימוש בקבוצה עקבית של מזהים כברירת מחדל שקפים, מאסטרים ותיבות טקסט. המזהים האלה עשויים להשתנות עם הזמן. לכן לא מומלץ להשתמש בתכונה הזו. במקום זאת, מצאו את הרכיבים שרוצים לשנות באמצעות אובייקט המצגת שהוחזר על ידי קריאות create() או get().