Method: presentations.create

Crea una presentazione vuota utilizzando il titolo specificato nella richiesta. Se viene fornito 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 (Size)
  },
  "slides": [
    {
      object (Page)
    }
  ],
  "title": string,
  "masters": [
    {
      object (Page)
    }
  ],
  "layouts": [
    {
      object (Page)
    }
  ],
  "locale": string,
  "revisionId": string,
  "notesMaster": {
    object (Page)
  }
}
Campi
presentationId

string

L'ID della presentazione.
pageSize

object (Size)

Le dimensioni delle pagine della presentazione.
slides[]

object (Page)

Le slide della presentazione. Una diapositiva eredita le proprietà da un layout.
title

string

Il titolo della presentazione.
masters[]

object (Page)

Gli schemi delle diapositive nella presentazione. Un master di diapositiva contiene tutti gli elementi comuni della pagina e le proprietà comuni per un insieme di layout. Hanno tre scopi:

  • Le forme segnaposto in un modello contengono gli stili di testo e le proprietà delle forme predefinite di tutte le forme segnaposto nelle pagine che utilizzano il modello.
  • Le proprietà della pagina principale definiscono le proprietà comuni delle pagine ereditate dai relativi layout.
  • Tutte le altre forme presenti nella diapositiva principale vengono visualizzate in tutte le diapositive che la utilizzano, indipendentemente dal layout.
layouts[]

object (Page)

I layout della presentazione. Un layout è un modello che determina la disposizione e lo stile dei contenuti nelle diapositive che lo ereditano.
locale

string

Le impostazioni internazionali della presentazione, come tag lingua IETF BCP 47.
revisionId

string

Solo output. L'ID revisione della presentazione. Può essere utilizzato nelle richieste di aggiornamento per verificare che la revisione della presentazione non sia cambiata dall'ultima operazione di lettura. Viene 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. L'ID revisione restituito è garantito come valido solo per 24 ore dopo la restituzione e non può essere condiviso tra utenti. Se l'ID revisione non cambia tra una chiamata e l'altra, significa che 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, un ID modificato può essere dovuto anche a fattori interni, come le modifiche al formato dell'ID.
notesMaster

object (Page)

Lo schema delle note nella presentazione. Ha tre scopi:

  • Le forme segnaposto in un modello di note contengono gli stili di testo e le proprietà delle forme predefinite di tutte le forme segnaposto in notes pages. Nello specifico, una forma segnaposto SLIDE_IMAGE contiene la miniatura della slide e una forma segnaposto BODY contiene le note dell'altoparlante.
  • Le proprietà della pagina principale delle note definiscono le proprietà comuni delle pagine ereditate da tutti i notes pages.
  • Tutte le altre forme nel modello di note vengono visualizzate in tutti i notes pages.

Il documento principale 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.