פעולות בהצגה

ממשק ה-API של Google Slides מאפשר ליצור קבצים של מצגות ולנהל קבצים קיימים. בדוגמאות שבדף הזה מוצגות כמה פעולות נפוצות של הצגת דפים באמצעות השיטה 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."
      }
    }
  ]
}