Crea una presentazione vuota utilizzando il titolo indicato nella richiesta. Se viene specificato, un presentationId
viene utilizzato come ID della nuova presentazione. In caso contrario, viene generato un nuovo ID. Gli altri campi della richiesta, inclusi eventuali 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 nella presentazione. |
slides[] |
Le slide della presentazione. Una slide eredita le proprietà da un layout di slide. |
title |
Il titolo della presentazione. |
masters[] |
Gli schemi delle slide nella presentazione. Uno schema di slide contiene tutti gli elementi comuni della pagina e le proprietà comuni di un insieme di layout. Hanno tre scopi:
|
layouts[] |
I layout della presentazione. Un layout è un modello che determina il modo in cui i contenuti vengono organizzati e definiti nelle slide che ereditano da quel layout. |
locale |
Le impostazioni internazionali della presentazione, come tag 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 ha 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 trattato in modo opaco. Un ID revisione restituito è garantito di essere valido solo per 24 ore dalla restituzione e non può essere condiviso tra gli utenti. Se l'ID revisione è rimasto invariato tra una chiamata e l'altra, la presentazione non ha subito modifiche. Al contrario, un ID modificato (per la stessa presentazione e lo stesso utente) di solito significa che la presentazione è stata aggiornata. Tuttavia, un ID modificato può essere dovuto 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.