使用要求中提供的標題建立空白簡報。如果提供 presentationId
,則會將其做為新簡報的 ID。否則,系統會產生新的 ID。系統會忽略要求中的其他欄位 (包括任何提供的內容)。傳回建立的簡報。
HTTP 要求
POST https://slides.googleapis.com/v1/presentations
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "presentationId": string, "pageSize": { object ( |
欄位 | |
---|---|
presentationId |
簡報的 ID。 |
pageSize |
簡報頁面的大小。 |
slides[] |
簡報中的投影片。投影片會沿用投影片版面配置的屬性。 |
title |
簡報的標題。 |
masters[] |
簡報中的投影片大師。投影片主投影片包含所有通用網頁元素,以及一組版面配置的常見屬性。用途有三種:
|
layouts[] |
簡報中的版面配置。版面配置是一種範本,可以決定投影片上對於版面配置內容的排列和樣式。 |
locale |
簡報的語言代碼,採用 IETF BCP 47 語言代碼。 |
revisionId |
僅供輸出。簡報的修訂版本 ID。可用於更新要求,以宣告簡報修訂版本自上次讀取作業後並未變更。只有在使用者擁有簡報的編輯權限時,才會填入資料。 修訂版本 ID 不是連續數字,而是連續字串。修訂版本 ID 的格式可能會隨著時間變更,因此應以不透明的方式處理。傳回的修訂版本 ID 必須在傳回後 24 小時內有效,且無法與所有使用者共用。如果每次呼叫之間的修訂版本 ID 沒有變更,表示簡報並未變更。反之,變更 ID (適用於同一個簡報和使用者) 通常表示簡報也已更新。不過,ID 格式變更等內部因素也可能造成 ID 變更。 |
notesMaster |
簡報中的備忘稿。有三種目的:
備忘錄主要版本為唯讀項目。 |
回應主體
如果成功,回應主體會包含新建立的 Presentation
例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/presentations
詳情請參閱授權指南。