פעולות בהצגה

באמצעות Google Slides API אפשר ליצור קובצי מצגות ולנהל קובצי מצגות קיימים. בדוגמאות בדף הזה מוצגות כמה פעולות נפוצות של הצגת דפים באמצעות השיטה presentations.batchUpdate.

הדוגמאות האלה מוצגות כבקשות HTTP כדי שיהיו ניטרליות מבחינת שפה. במדריכים הבאים מוסבר איך מטמיעים עדכון באצווה בשפות שונות באמצעות ספריות הלקוח של Google API:

יצירת מצגת

בדוגמת הקוד הבאה ב-presentations.create מוסבר איך יוצרים קובץ מצגת ריק בשם 'המצגת החדשה שלי'.

אפשר גם ליצור קבצי מצגות ריקים באמצעות השיטה files.create של Google Drive API, על ידי ציון application/vnd.google-apps.presentation בתור סוג ה-MIME.

זהו פרוטוקול הבקשה ליצירת מצגת:

POST https://slides.googleapis.com/v1/presentations
{
  "title": "My New Presentation"
}

הצגת רשימה של קובצי מצגות קיימים

ב-Slides API אין שיטה לאחזור רשימה של מצגות, אבל ב-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 מראה איך להשתמש ב-method ReplaceAllTextRequest כדי להחליף טקסט במצגת שצוינה ב-PRESENTATION_ID. תוכלו למצוא את הערך של מזהה המצגת בכתובת ה-URL של המצגת.

כל מופע של המחרוזת 'Gizmo Corp.‎' מוחלף בטקסט 'Gadget Inc.‎' כולל טקסט בתיבות טקסט ובצורות אחרות, בשקופיות ובתבניות ראשיות. במקרה הזה, החלפת הטקסט היא תלוית אותיות רישיות על ידי הגדרת הערך matchCase ל-true.

זהו פרוטוקול הבקשה להחליפת טקסט במהלך מצגת:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}