פעולות בהצגה

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

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

• יצירה וניהול של מצגות
• איך מחפשים קבצים ותיקיות
• מיזוג נתונים במצגת

יצירת מצגת

בדוגמה הבאה של קוד presentations.create אפשר לראות איך יוצרים קובץ מצגת ריק בשם My New Presentation.

אפשר גם ליצור קובצי מצגת ריקים באמצעות השיטה 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 אפשר לראות איך משתמשים בשיטה 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."
      }
    }
  ]
}