פעולות בהצגה

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

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

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

יצירת מצגת

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

אפשר גם ליצור קובצי מצגת ריקים באמצעות ה-method files.create של Google Drive API, על ידי ציון 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.' מוחלף בטקסט 'גאדג'ט Inc'. זה כולל טקסט בתיבות טקסט ובצורות אחרות, בשקפים ובמאסטרים. במקרה כזה, החלפת הטקסט היא תלוית אותיות רישיות על ידי הגדרת הערך matchCase ל-true.

לפניכם פרוטוקול הבקשה להחלפת טקסט לאורך מצגת:

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

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