Method: presentations.create

Crea una presentazione vuota utilizzando il titolo indicato nella richiesta. Se viene fornito un presentationId, questo viene utilizzato come ID della nuova presentazione. In caso contrario, viene generato un nuovo ID. Gli altri campi della richiesta, inclusi 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 (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)
}
Campi
presentationId

string

L'ID della presentazione.
pageSize

object (Size)

Le dimensioni delle pagine della presentazione.
slides[]

object (Page)

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

string

Il titolo della presentazione.
masters[]

object (Page)

Gli schemi delle slide della presentazione. Uno schema delle slide contiene tutti gli elementi comuni della pagina e le proprietà comuni per un insieme di layout. Hanno tre scopi:

  • Le forme segnaposto di uno schema contengono gli stili di testo e le proprietà delle forme predefiniti di tutte le forme segnaposto delle pagine che utilizzano lo schema.
  • Le proprietà della pagina dello schema definiscono le proprietà comuni della pagina ereditate dai relativi layout.
  • Qualsiasi altra forma sulla slide dello schema viene visualizzata su tutte le slide che utilizzano lo schema, indipendentemente dal layout.
layouts[]

object (Page)

I layout della presentazione. Un layout è un modello che determina la disposizione e lo stile dei contenuti sulle slide che ereditano da quel layout.
locale

string

Le impostazioni internazionali della presentazione, come tag di 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. Un ID revisione restituito è valido solo per 24 ore dopo la restituzione e non può essere condiviso tra gli utenti. Se l'ID revisione non viene modificato tra le chiamate, significa che la presentazione non è stata modificata. 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 modifiche al formato dell'ID.
notesMaster

object (Page)

Lo schema delle note della presentazione. Ha tre scopi:

  • Le forme segnaposto di uno schema delle note contengono gli stili di testo e le proprietà delle forme predefiniti di tutte le forme segnaposto delle notes pages. In particolare, una forma segnaposto SLIDE_IMAGE contiene la miniatura della slide e una forma segnaposto BODY contiene le note del relatore.
  • Le proprietà della pagina dello schema delle note definiscono le proprietà comuni della pagina ereditate da tutte le notes pages.
  • Qualsiasi altra forma nello schema delle note viene visualizzata su tutte le notes pages.

Lo schema delle note è di sola lettura.
comments[]

object (CommentThread)

Solo output. I thread di commenti associati alla presentazione.

commentsViewMode

enum (CommentsViewMode)

Solo output. La modalità di visualizzazione dei commenti applicata alla presentazione.

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.