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)
  },
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
欄位
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 上。

備忘稿母片為唯讀。
comments[]

object (CommentThread)

僅供輸出。與簡報相關聯的留言串。
commentsViewMode

enum (CommentsViewMode)

僅供輸出。套用至簡報的註解檢視模式。

回應主體

如果成功，回應主體會包含新建立的 Presentation 執行個體。

授權範圍

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

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

詳情請參閱授權指南。