本頁面由 Cloud Translation API 翻譯而成。

投影片作業

Google Slides API 可讓您建立、移動及刪除投影片。本頁面將介紹一些常見的投影片操作 presentations.batchUpdate敬上方法。

這些範例使用下列變數：

PRESENTATION_ID：代表您在何處提供簡報 ID：你可以從簡報網址找出這個 ID 的值。
PAGE_ID 和 PAGE_ID2：表示在何處您需要提供網頁物件 ID。您可以擷取該網址的值，或是使用 API 讀取要求。

這些範例會顯示為中立語言的 HTTP 要求。學習如何使用 Google API 實作不同語言版本的批次更新請參閱下列指南：建立和新增圖案和文字。

複製投影片

下列 presentations.batchUpdate敬上程式碼範例顯示如何使用 DuplicateObjectRequest 方法，將投影片插入簡報中的原始投影片，然後再插入簡報中。原始投影片由 PAGE_ID 指定。

這項要求可讓您指定是否要加入部分或所有網頁元素 ID 副本 (有些人限制)。在這個範例中，原始投影片含有表格元素 (由 TABLE_ELEMENT_ID)，對應至新資料表 (由 COPY_TABLE_ELEMENT_ID) 加入投影片文案 (由 COPY_PAGE_ID)。副本中的所有其他元素皆會隨機顯示而非客戶 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 方法建立投影片，並將其插入至第四張投影片 (使用從 0 開始的 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"
        }
      }
    }
  ]
}

建立投影片並修改預留位置

下列 presentations.batchUpdate敬上程式碼範例顯示如何使用 CreateSlideRequest 方法建立投影片 PredefinedLayout (共 TITLE_AND_TWO_COLUMNS)。

您可以指定一個字串做為投影片的 PAGE_ID (有有些限制)。 placeholderIdMappings敬上採用 Type/ TITLE。TITLE_ID 會參照投影片的預留位置形狀以便進行修改

以下是建立投影片與修改預留位置的要求通訊協定：

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 取得兩張投影片，並將該投影片移至開頭相對排序

指定的投影片 ID (PAGE_ID 和 PAGE_ID2) 按照現有的呈現順序提供，不可重複。以零為基礎的 insertionIndex 表示應插入投影片的位置 (以 0 為基礎) 。值必須介於 0 至以及簡報中的投影片數量 (含首尾)。

如要將投影片移至新位置，請遵循下列要求通訊協定：

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。

欄位遮罩的用途是指出必須變更投影片背景來保留其他屬性。使用欄位口罩也有助於提高效能。

或者，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敬上方法，會傳回網頁的縮圖圖片做為內容網址。圖片網址的預設生命週期為 30 分鐘。

您也可以使用mimeTypethumbnailSize 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"
}