פעולות בהצגה

ממשק ה-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."
      }
    }
  ]
}