פעולות בהצגה

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