基本書寫

Google Slides API 可讓您在簡報頁面中新增及修改元素。 本頁面的範例說明如何使用 presentations.batchUpdate敬上 方法。

這些範例使用下列變數:

  • PRESENTATION_ID:代表您在何處提供 簡報 ID:你可以 從簡報網址找出這個 ID 的值。
  • PAGE_ID:代表您提供網頁物件的位置 ID:您可以擷取 該網址的值,或是使用 API 讀取要求。
  • PAGE_ELEMENT_ID:表示您提供頁面 元素物件 ID。個人中心 可以為您建立的元素指定此 ID (有 限制) 或允許 Slides API 自動建立投影片。元素 ID 可透過 API 讀取要求擷取。

這些範例會顯示為中立語言的 HTTP 要求。學習 如何使用 Google API 實作不同語言版本的批次更新 用戶端程式庫,請參閱新增形狀和 文字

在投影片中新增文字方塊

下列 presentations.batchUpdate敬上 程式碼範例顯示如何使用 CreateShapeRequest 方法,藉此在 由 PAGE_ID 指定的投影片。指定了兩項要求 要求主體—一個用來建立文字方塊形狀 (指定特定大小且 另一個則用來插入文字。

第一個請求會指定物件 ID: 文字框。如此可讓第二個要求在同一個 API 呼叫中使用,以減少 同時免除不必要的負擔

如要在投影片中新增文字方塊,要求通訊協定如下:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createShape": {
        "objectId": PAGE_ELEMENT_ID,
        "shapeType": "TEXT_BOX",
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 150,
              "unit": "PT"
            },
            "height": {
              "magnitude": 50,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "My Added Text Box",
        "insertionIndex": 0
      }
    }
  ]
}

在投影片中新增圖片

下列 presentations.batchUpdate敬上 程式碼範例顯示如何使用 CreateImageRequest 方法,將圖片新增至 PAGE_ID 指定的投影片。 API 會使用 IMAGE_URL 擷取圖片。這項要求也 縮放及定位投影片中的圖片

以下是在投影片中新增圖片的要求通訊協定:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createImage": {
        "url": IMAGE_URL,
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 30,
              "unit": "PT"
            },
            "height": {
              "magnitude": 30,
              "unit": "PT"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 200,
            "translateY": 100,
            "unit": "PT"
          }
        }
      }
    }
  ]
}

刪除網頁或網頁元素

下列 presentations.batchUpdate敬上 程式碼範例顯示如何使用 DeleteObjectRequest 刪除 PAGE_ELEMENT_ID 所指定網頁元素的方法 以及 PAGE_ID 指定的投影片,使用兩個不同的要求。

以下是刪除網頁或網頁元素的要求通訊協定:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      },
      "deleteObject": {
        "objectId":  PAGE_ID
      }
    }
  ]
}

編輯特定圖案中的文字

下列 presentations.batchUpdate敬上 程式碼範例顯示如何使用 DeleteTextRequest 方法,取代特定形狀的 PAGE_ELEMENT_ID。為了達到這個目的,請先使用 以零為基礎的 startIndex,然後在該位置插入新文字。在本 原始文字字串 "My Shape Text: ????"替換成「我的 Shape Text: Trapezoid"。

這項要求只會影響指定形狀中的文字。取代所有文字 簡報內,請使用 ReplaceAllTextRequest敬上 方法。

下列要求通訊協定可用於編輯特定形狀中的文字:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "deleteText": {
        "objectId": PAGE_ELEMENT_ID,
        "textRange": {
          "type": "FROM_START_INDEX",
          "startIndex": 15
        }
      }
    },
    {
      "insertText": {
        "objectId": PAGE_ELEMENT_ID,
        "text": "Trapezoid",
        "insertionIndex": 15
      }
    }
  ]
}

使用圖片取代形狀標記

標記是具有不重複字串名稱的文字方塊或形狀,例如 「帳戶持有人名稱」。

下列 presentations.batchUpdate敬上 程式碼範例顯示如何使用 CreateImageRequest 方法,將形狀標記的單一例項替換成圖片,維護 將圖片縮放成適合廣告代碼的大小 長寬比。

這項要求也可以用來取代某張圖片。要求 其中包含新映像檔,然後刪除代碼。

CreateImageRequest 方法只會取代指定形狀。更換標記 在簡報中的各個位置使用 ReplaceAllShapesWithImageRequest敬上 方法。

形狀標記包含下列元素 PageElement敬上 資源則可以透過 presentations.pages.get 要求):

{
  "objectId": PAGE_ELEMENT_ID,
  "size": {
    "width": {
      "magnitude": 3000000,
      "unit": "EMU"
    },
    "height": {
      "magnitude": 3000000,
      "unit": "EMU"
    }
  },
  "transform": {
    "scaleX": 1.13,
    "scaleY": 0.62,
    "translateX": 4800000,
    "translateY":  450000,
    "unit": "EMU"
  },
  "shape": {
    "shapeType": "RECTANGLE"
  }
}

形狀位於 PAGE_ID 指定的投影片中。如要指定 會取代形狀的圖片,API 會使用 IMAGE_URL。在限制圖片長寬比的情況下保留圖片顯示比例 配合廣告代碼大小 CreateImageRequest敬上 方法會將圖片大小設為標記大小和比例的乘積。 將圖片縮放比例係數設為 1詳情請參閱「保留切面 比率

以下就是將 Shape 標記替換為圖片的要求通訊協定:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createImage": {
        "url": IMAGE_URL,
        "elementProperties": {
          "pageObjectId":  PAGE_ID,
          "size": {
            "width": {
              "magnitude": 3000000 * 1.13,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 3000000 * 0.62,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1,
            "translateX": 4800000,
            "translateY": 450000,
            "unit": "PT"
          }
        }
      }
    },
    {
      "deleteObject": {
        "objectId": PAGE_ELEMENT_ID
      }
    }
  ]
}