פעולות בהצגה

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