בעזרת ה-API של Google Slides אפשר ליצור קובצי מצגות ולנהל קבצים קיימים.
הדוגמאות בדף הזה מציגות כמה פעולות נפוצות בהצגת דפים באמצעות
ה
presentations.batchUpdate
.
הדוגמאות האלה מוצגות כבקשות HTTP כך שהשפה תהיה ניטרלית. למידה איך לבצע עדכון בכמות גדולה בשפות שונות באמצעות Google API קראו את המדריכים הבאים:
יצירת מצגת
הבאים
presentations.create
דוגמת קוד שמראה איך ליצור קובץ מצגת ריק בשם 'החדש שלי'
מצגת".
אפשר גם ליצור קובצי מצגת ריקים באמצעות Google Drive API
files.create
באמצעות ציון
application/vnd.google-apps.presentation
כ-MIME
type.
זה פרוטוקול הבקשה ליצירת מצגת:
POST https://slides.googleapis.com/v1/presentations
{ "title": "My New Presentation" }
הצגת רשימה של קובצי מצגות קיימים
ה-API של Slides לא מספק שיטה לאחזור רשימה של
מצגות, אבל Drive API כן.
השיטה files.list
(מוצגת
למטה) משתמש במסכות של שדות כדי להחזיר רשימה של
קובצי מצגת מה-Drive שלכם, עם מזהה הקובץ, שם הקובץ
וקישור לפתיחת הקובץ. הבקשה מציינת גם
application/vnd.google-apps.presentation
בתור ה-MIME
.
זה פרוטוקול הבקשה להצגת קובצי מצגת קיימים:
GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)
התגובה להודעה הבקשה היא במבנה הבא:
{ "files": [ { "id": "abcdefghijklmnopqrstuvwxyz0123456789", "name": "Project Vision", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk" }, { "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", "name": "Untitled Presentation", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk" }, ... ] }
החלפת טקסט במצגת
הבאים
presentations.batchUpdate
דוגמת הקוד מראה איך להשתמש
ReplaceAllTextRequest
שיטה להחלפת טקסט לאורך כל המצגת שצוינה על ידי
PRESENTATION_ID. אפשר לגלות את הערך של
מזהה המצגת
מכתובת ה-URL של המצגת.
כל מופע של המחרוזת 'Gizmo Corp. ' מוחלף בטקסט "גאדג'ט
Inc. " הדבר כולל טקסט בתיבות טקסט ובצורות אחרות, בשקפים ובתוכו
במאסטרים. במקרה הזה, החלפת הטקסט היא תלוית אותיות רישיות על ידי ההגדרה
matchCase
אל true
.
זה פרוטוקול הבקשה להחלפת טקסט במצגת:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "replaceAllText": { "containsText": { "text": "Gizmo Corp.", "matchCase": true }, "replaceText": "Gadget Inc." } } ] }