פעולות בהצגה

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

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

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

יצירת מצגת

דוגמת הקוד הבאה של presentations.create מראה איך יוצרים קובץ מצגת ריק בשם 'המצגת החדשה שלי'.

אפשר גם ליצור קובצי מצגת ריקים באמצעות Google Drive API files.create באמצעות ציון application/vnd.google-apps.presentation כסוג MIME.

זה הפרוטוקול של הבקשה ליצירת מצגת:

POST https://slides.googleapis.com/v1/presentations

{
  "title": "My New Presentation"
}

הצגת רשימה של קובצי מצגות קיימים

ה-API של Slides לא מספק שיטה לאחזור רשימת מצגות, אבל 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 מראה איך להשתמש ב-method ReplaceAllTextRequest כדי להחליף טקסט במצגת שצוינה ב-PRESENTATION_ID. תוכלו למצוא את הערך של מזהה המצגת בכתובת ה-URL של המצגת.

כל מופע של המחרוזת 'Gizmo Corp. ' מוחלף בטקסט ' Gizmo Corp. '. זה כולל טקסט בתיבות טקסט ובצורות אחרות, בשקפים ובמאסטרים. במקרה הזה, החלפת הטקסט היא תלוית אותיות רישיות על ידי הגדרת הערך matchCase ל-true.

זה פרוטוקול הבקשה להחלפת טקסט במצגת:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate

{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}