פעולות בשקף

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

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

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

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

העתקת שקף

הבאים presentations.batchUpdate דוגמת הקוד מראה איך להשתמש 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 דוגמת הקוד מראה איך להשתמש CreateSlideRequest כדי ליצור שקף באמצעות PredefinedLayout מתוך TITLE_AND_TWO_COLUMNS.

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

זה פרוטוקול הבקשה ליצירת שקף ולשינוי placeholders:

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 דוגמת הקוד מראה איך להשתמש 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 דוגמת הקוד מראה איך להשתמש UpdatePagePropertiesRequest כדי להגדיר את תמונת הרקע של שקף שצוין PAGE_ID. ה-API מאחזר את התמונה באמצעות IMAGE_URL

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

לחלופין, אפשר להשתמש ב-method 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"
}