Method: presentations.create

Crea una presentazione vuota utilizzando il titolo fornito 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 della slide.
title

string

Il titolo della presentazione.
masters[]

object (Page)

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

  • Le forme segnaposto in una slide master contengono gli stili di testo e le proprietà delle forme predefiniti di tutte le forme segnaposto nelle pagine che utilizzano quella slide master.
  • Le proprietà della pagina master definiscono le proprietà comuni della pagina ereditate dai relativi layout.
  • Tutte le altre forme nella slide master vengono visualizzate in tutte le slide che utilizzano quella master, indipendentemente dal layout.
layouts[]

object (Page)

I layout nella presentazione. Un layout è un modello che determina la disposizione e lo stile dei contenuti nelle slide che lo ereditano.
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 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 trattato in modo opaco. Un ID revisione restituito è garantito valido solo per 24 ore dopo la restituzione e non può essere condiviso tra gli utenti. Se l'ID revisione rimane invariato tra le chiamate, 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ò anche essere dovuto a fattori interni, come modifiche al formato dell'ID.
notesMaster

object (Page)

La pagina Note nella presentazione. Ha tre scopi:

  • Le forme segnaposto in una pagina master delle note contengono gli stili di testo e le proprietà delle forme predefiniti 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 del relatore.
  • Le proprietà della pagina master delle note definiscono le proprietà comuni della pagina ereditate da tutti i notes pages.
  • Qualsiasi altra forma nel master delle note viene visualizzata in 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.