Method: presentations.create

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 (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 nella 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 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:

  • Le forme segnaposto in uno schema contengono gli stili di testo predefiniti e le proprietà di forma di tutte le forme segnaposto sulle pagine che utilizzano lo schema.
  • Le proprietà della pagina principale definiscono le proprietà comuni della pagina ereditate dai relativi layout.
  • Qualsiasi altra forma nella 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 il modo in cui i contenuti vengono organizzati e definiti nelle slide che ereditano da quel layout.

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 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

object (Page)

Lo schema delle note nella presentazione. Ha tre scopi:

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

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.