Crea una presentazione vuota utilizzando il titolo specificato nella richiesta. Se viene fornito un valore presentationId
, questo verrà utilizzato come ID della nuova presentazione. In caso contrario, viene generato un nuovo ID. Gli altri campi della richiesta, compresi i contenuti forniti, vengono ignorati. Restituisce la presentazione creata.
Richiesta HTTP
POST https://slides.googleapis.com/v1/presentations
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "presentationId": string, "pageSize": { object ( |
Campi | |
---|---|
presentationId |
L'ID della presentazione. |
pageSize |
Le dimensioni delle pagine della presentazione. |
slides[] |
Le slide della presentazione. Una slide eredita le proprietà da un layout della slide. |
title |
Il titolo della presentazione. |
masters[] |
Gli schemi delle slide della presentazione. Uno schema slide contiene tutti gli elementi di pagina comuni e le proprietà comuni di un insieme di layout. Hanno tre scopi:
|
layouts[] |
I layout della presentazione. Un layout è un modello che determina l'organizzazione e lo stile dei contenuti nelle slide che ereditano da quel layout. |
locale |
Le impostazioni internazionali della presentazione, espresse come tag di lingua IETF BCP 47. |
revisionId |
Solo output. L'ID revisione della presentazione. Può essere utilizzato nelle richieste di aggiornamento per affermare che la revisione della presentazione non è cambiata dall'ultima operazione di lettura. Compilato solo se l'utente dispone dell'accesso in modifica alla presentazione. L'ID revisione non è un numero sequenziale, ma una stringa nebulosa. Il formato dell'ID revisione può cambiare nel tempo, pertanto deve essere considerato in modo opaco. Un ID revisione restituito è valido solo per 24 ore dalla restituzione e non può essere condiviso tra gli utenti. Se l'ID revisione rimane invariato tra le chiamate, la presentazione non è cambiata. Al contrario, un ID modificato (per la stessa presentazione e lo stesso utente) di solito indica che la presentazione è stata aggiornata. Tuttavia, la modifica di un ID può essere dovuta anche a fattori interni, come le modifiche al formato dell'ID. |
notesMaster |
Lo schema delle note nella presentazione. Ha tre scopi:
Lo schema delle note è di sola lettura. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di Presentation
appena creata.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/presentations
Per ulteriori informazioni, consulta la guida all'autorizzazione.