Method: presentations.create

使用要求中提供的標題建立空白簡報。如果提供 presentationId，系統會將其用做新簡報的 ID。否則，系統會產生新的 ID。要求中的其他欄位 (包括任何提供的內容) 都會遭到忽略。傳回已建立的簡報。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "presentationId": string,
  "pageSize": {
    object (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
欄位
presentationId

string

簡報的 ID。
pageSize

object (Size)

簡報中的頁面大小。
slides[]

object (Page)

簡報中的投影片。投影片會繼承投影片版面配置的屬性。
title

string

簡報的標題。
masters[]

object (Page)

簡報中的投影片主控項。投影片母片包含所有常見的頁面元素，以及一組版面的常見屬性。這些資訊有三個用途：

  • 母版上的預留位置形狀包含使用該母版的頁面上所有預留位置形狀的預設文字樣式和形狀屬性。
  • 主頁面屬性定義了其版面配置會繼承的一般頁面屬性。
  • 主投影片中的任何其他形狀都會顯示在使用該主投影片的所有投影片中，無論其版面配置為何。
layouts[]

object (Page)

簡報中的版面配置。版面配置是指由範本決定的內容排版方式，並決定繼承該版面配置的投影片樣式。
locale

string

簡報的語言代碼，以 IETF BCP 47 語言標記表示。
revisionId

string

僅供輸出。簡報的修訂版本 ID。可用於更新要求，用於宣告自上次讀取作業以來，呈現版面版本未變更。只有在使用者擁有簡報的編輯權限時，才會填入這項資料。

修訂版本 ID 不是連續編號，而是一串模糊的字串。修訂版本 ID 的格式可能會隨著時間而變更，因此應以不透明的方式處理。系統傳回的修訂版本 ID 只保證在傳回後的 24 小時內有效，且無法跨使用者共用。如果修訂 ID 在呼叫之間未變更，表示簡報內容並未變更。相反地，如果 ID 有所變更 (針對相同的簡報和使用者)，通常表示簡報已更新。不過，ID 變更也可能是因為 ID 格式變更等內部因素造成。
notesMaster

object (Page)

簡報中的備忘稿主控項。這項功能有三個用途：

  • 筆記母版上的預留位置形狀包含 notes pages 上所有預留位置形狀的預設文字樣式和形狀屬性。具體來說，SLIDE_IMAGE 預留位置圖形包含投影片縮圖，而 BODY 預留位置圖形則包含講者筆記。
  • 備註主頁面屬性定義了所有 notes pages 會繼承的常見頁面屬性。
  • 筆記母片上的任何其他形狀都會顯示在所有 notes pages 中。

備忘稿母片為唯讀。

回應主體

如果成功，回應主體會包含新建立的 Presentation 例項。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations

詳情請參閱授權指南。