פעולות בהצגה

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

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

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

יצירת מצגת

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

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

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

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 דוגמת הקוד מראה איך להשתמש 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."
      }
    }
  ]
}