פעולות בשקף

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

בדוגמאות הבאות נעשה שימוש במשתנים הבאים:

• PRESENTATION_ID – מציין איפה מזינים את מזהה המצגת. תוכלו לגלות את הערך של המזהה הזה בכתובת ה-URL של המצגת.
• PAGE_ID ו-PAGE_ID2 – מציין איפה מזינים את מזהי האובייקטים בדף. תוכלו לאחזר את הערך הזה מכתובת ה-URL או באמצעות בקשת קריאה ל-API.

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

העתקת שקף

דוגמת הקוד הבאה של presentations.batchUpdate מראה איך להשתמש ב-method DuplicateObjectRequest כדי להעתיק שקף ולהוסיף אותו אחרי המקור במצגת. השקף המקורי צוין על ידי PAGE_ID.

הבקשה מאפשרת לציין אם חלק ממזהי הרכיבים של הדף או כולם צריכים להיות בעותק (עם הגבלות מסוימות). בדוגמה הזו, השקף המקורי מכיל רכיב של טבלה (צוין על ידי TABLE_ELEMENT_ID), שממופה לטבלה חדשה (שצוין על ידי COPY_TABLE_ELEMENT_ID) בעותק השקף (שצוין על ידי COPY_PAGE_ID). כל שאר הרכיבים בעותק מקבלים מזהים אקראיים.

למידע נוסף על העתקה של PageElement, כולל תיבות טקסט, תמונות, טבלאות, צורות בסיסיות, קווים וסרטונים מוטמעים, ראו העתקה ועריכה של רכיב.

לפניכם פרוטוקול הבקשה להעתקת שקף:

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

{
  "requests": [
    {
      "duplicateObject": {
        "objectId": PAGE_ID,
        "objectIds": {
          "PAGE_ID": "COPY_PAGE_ID",
          "TABLE_ELEMENT_ID": "COPY_TABLE_ELEMENT_ID"
        }
      }
    }
  ]
}

יצירת שקף

דוגמת הקוד הבאה presentations.batchUpdate ממחישה איך להשתמש בשיטה CreateSlideRequest כדי ליצור שקף ולהוסיף אותו כשקף הרביעי (באמצעות insertionIndex שמבוסס על אפס) במצגת.

השקף החדש מוגדר להשתמש ב-PredefinedLayout של TITLE_AND_TWO_COLUMNS. אפשר לציין מחרוזת שתשמש כ-PAGE_ID בשקף (עם הגבלות מסוימות), או לאפשר ל-API ליצור את PAGE_ID על ידי השמטת השדה בבקשה.

לפניכם פרוטוקול הבקשה ליצירת שקף:

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

{
  "requests": [
    {
      "createSlide": {
        "objectId": "PAGE_ID",
        "insertionIndex": 3,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        }
      }
    }
  ]
}

יצירת שקף ושינוי ערכי placeholder

דוגמת הקוד הבאה presentations.batchUpdate ממחישה איך להשתמש ב-method CreateSlideRequest כדי ליצור שקף באמצעות PredefinedLayout של TITLE_AND_TWO_COLUMNS.

אפשר לציין מחרוזת שתשמש כ-PAGE_ID לשקף (עם הגבלות מסוימות). הקוד placeholderIdMappings משתמש ב-Type של TITLE. השדה TITLE_ID מפנה לצורה של ה-placeholder של השקף, כדי שאפשר יהיה לשנות אותו.

לפניכם פרוטוקול הבקשה ליצירת שקף ולשינוי ערכי placeholder:

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

{
  "requests": [
    {
      "createSlide": {
        "objectId": PAGE_ID,
        "slideLayoutReference": {
          "predefinedLayout": "TITLE_AND_TWO_COLUMNS"
        },
        "placeholderIdMappings": [
          {
            "layoutPlaceholder": {
              "type": "TITLE",
              "index": 0
            },
            "objectId": TITLE_ID,
           },
        ],
      }
    },
    {
      "insertText": {
        "objectId": TITLE_ID,
        "text": "This is my slide title",
      }
    },
  ]
}

העברת שקפים למיקום חדש

דוגמת הקוד הבאה של presentations.batchUpdate מראה איך להשתמש ב-method UpdateSlidesPositionRequest כדי להעביר את שני השקפים שצוינו ולהעביר אותם לתחילת המצגת, תוך שמירה על הסדר היחסי שלהם.

יש לספק את מזהי השקפים שצוינו (PAGE_ID ו-PAGE_ID2) בסדר הקיים של המצגת, ללא כפילויות. השדה insertionIndex מבוסס-אפס מציין איפה צריך להוסיף את השקפים, לפי הסדר לפני ביצוע ההעברה. הערך חייב להיות בין אפס למספר השקפים במצגת, כולל.

לפניכם פרוטוקול הבקשה להעברת שקפים למיקום חדש:

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

{
  "requests": [
    {
      "updateSlidesPosition": {
        "slideObjectIds": [
          PAGE_ID,
          PAGE_ID2
          ],
        "insertionIndex": 0
      }
    }
  ]
}

הגדרה של תמונת רקע לשקף

דוגמת הקוד הבאה של presentations.batchUpdate מראה איך להשתמש ב-method UpdatePagePropertiesRequest כדי להגדיר את תמונת הרקע של שקף שצוין ב-PAGE_ID. ה-API מאחזר את התמונה באמצעות IMAGE_URL.

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

לחלופין, אפשר להשתמש בשיטה UpdatePagePropertiesRequest כדי להגדיר את הרקע של שקף לצבע אחיד.

לפניכם פרוטוקול הבקשה להגדרת תמונת רקע של שקף:

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

{
  "requests": [
    {
      "updatePageProperties": {
        "objectId": PAGE_ID,
        "pageProperties": {
          "pageBackgroundFill": {
            "stretchedPictureFill": {
              "contentUrl": IMAGE_URL
            }
          }
        },
        "fields": "pageBackgroundFill"
      }
    }
  ]
}

יצירת תמונה ממוזערת

אפשר ליצור תמונה ממוזערת של הגרסה האחרונה של דף מסוים במצגת באמצעות השיטה presentations.pages.getThumbnail, שמחזירה תמונה ממוזערת של הדף ככתובת URL של תוכן. כברירת מחדל, לכתובת ה-URL של התמונה יש משך חיים של 30 דקות.

אפשר גם לציין את השדה mimeType ואת הערך thumbnailSize שהוחזרו באמצעות השדה ThumbnailProperties כפרמטר של שאילתה.

זה פרוטוקול הבקשה ליצירת התמונה הממוזערת של הדף עם הערך ThumbnailProperties:

 GET https://slides.googleapis.com/v1/presentations/PRESENTATION_ID/pages/PAGE_ID/thumbnail?thumbnailProperties.mimeType=PNG&thumbnailProperties.thumbnailSize=MEDIUM

{
  "width": 800,
  "height": 450,
  "contentUrl": "CONTENT_URL"
}