Introduzione

L'API Presentazioni Google consente di creare e modificare presentazioni Google.

Le app possono integrarsi con l'API Presentazioni Google per creare fantastiche presentazioni automaticamente dai dati forniti dall'utente e dal sistema. Ad esempio, potresti utilizzare i dettagli dei clienti da un database e combinarli con modelli e opzioni di configurazione selezionate per creare presentazioni completate in una frazione del tempo necessario per crearle manualmente.

Panoramica dell'API

La raccolta presentations fornisce che consentono di ottenere e aggiornare gli elementi della presentazione.

La maggior parte del lavoro con l'API Presentazioni verrà probabilmente creata e aggiornata presentazioni. Per farlo, devi utilizzare batchUpdate; questo metodo prende un elenco Richiedi che ti consentono di eseguire operazioni quali:

  • Crea slide
  • Aggiungere elementi a slide come forme o tabelle
  • Inserire, modificare e rimuovere testo
  • Applicare le trasformazioni agli elementi
  • Modificare l'ordine delle slide

Per ulteriori dettagli, consulta Aggiornamenti batch. Consulta le guide introduttive per un semplice esempio end-to-end di come utilizzare l'API.

La struttura di una presentazione

Una presentazione nell'API Presentazioni è composta da pagine che contengono elementi.

L'ID di una presentazione può essere ricavato dall'URL:

https://docs.google.com/presentation/d/presentationId/edit

L'ID presentazione è una stringa contenente lettere, numeri e alcuni caratteri speciali caratteri. La seguente espressione regolare può essere utilizzata per estrarre ID presentazione da un URL di Fogli Google:

/presentation/d/([a-zA-Z0-9-_]+)

Se hai familiarità con l'API Drive, il presentationId corrisponde alle ID del file risorsa.

Le pagine e gli elementi della pagina sono identificati da ID oggetto.

Pagine

Presentazioni Google presenta i seguenti tipi di pagine:

Master Gli schemi delle slide definiscono gli stili di testo, lo sfondo e la pagina predefiniti gli elementi visualizzati in tutte le slide che utilizzano lo schema. Pagina gli elementi che devono apparire su tutte le slide devono essere aggiunti allo schema. Più alta presentazioni hanno un master, ma alcuni possono averne diversi o nessuno.
Layout I layout fungono da modello per la disposizione degli elementi della pagina in base a per impostazione predefinita sulle slide usando un layout. Ogni layout è associato a un principale.
Presentazioni Queste pagine includono i contenuti che presenti al tuo pubblico. La maggior parte delle slide si basa su uno schema e su un layout. Puoi specificare quale opzione layout da usare per ogni slide quando viene creata.
Note Queste pagine includono i contenuti per le dispense di presentazione, tra cui una che contiene le note del relatore della slide. Ogni slide contiene pagina delle note corrispondente. È possibile specificare solo il testo nelle note del relatore modificato con l'API Presentazioni.
Master delle note Gli schemi Note definiscono gli stili di testo e gli elementi di pagina predefiniti per tutti pagine delle note. Nell'API Presentazioni, i master Note sono di sola lettura.

Elementi pagina

Gli elementi di pagina sono i componenti visivi posizionati nelle pagine. L'API espone diversi tipi di elementi della pagina:

Gruppo Un insieme di elementi di pagina trattati come una singola unità. Possono possono essere spostati, scalati e ruotati insieme.
Shape Un oggetto visivo semplice, come rettangoli, ellissi e caselle di testo. Le forme possono contenere testo e, pertanto, sono gli elementi di pagina più comuni da creare slide.
Immagine Un'immagine importata in Presentazioni.
Video Un video importato in Presentazioni.
Linea Una linea, una curva o un connettore visiva.
Tabella Una griglia di contenuti.
WordArt Un elemento di testo visivo che si comporta più come una forma.
SheetsChart Un grafico importato in Presentazioni da Fogli Google.

Aggiornamenti batch

Il metodo batchUpdate consente di aggiornare molti aspetti di una presentazione. Le modifiche vengono raggruppate in un batch in modo che se una richiesta non va a buon fine, nessuna delle altre (potenzialmente dipendente) vengono scritte le modifiche.

Il metodo batchUpdate funziona prendendo uno o più Richiedi specifici, ognuno dei quali specifica un solo tipo di richiesta da eseguire. Esistono molti tipi diversi di richieste. Ecco una suddivisione dei tipi di richieste, raggruppate in diverse categorie.

Lavorare con Presentazioni: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
Lavorare con gli elementi della pagina: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
Utilizzo delle tabelle: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
Utilizzo dei grafici: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
Utilizzo di immagini e video: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
Uso del testo: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

Il metodo batchUpdate restituisce un corpo della risposta, che contiene un Risposta per ogni richiesta. Ogni risposta occupa lo stesso indice della risposta richiesta; per le richieste senza una risposta applicabile, la risposta in quell'indice sarà vuoto. In genere le varie richieste Create hanno risposte, quindi di conoscere l'ID dell'oggetto appena aggiunto.

Utilizzo degli ID oggetto

Una presentazione nell'API Presentazioni è composta da pagine ed elementi di pagina. Questi oggetti includono una stringa di ID oggetto univoca all'interno di un una presentazione.

Specificare gli ID oggetto al momento della creazione

Quando crei pagine o elementi di pagina utilizzando la proprietà batchUpdate, puoi facoltativamente, puoi specificare un ID oggetto per il nuovo oggetto. In questo modo puoi creare e lo modifichiamo all'interno della stessa richiesta batchUpdate, riducendo al minimo il numero delle chiamate all'API Presentazioni e riducendo l'utilizzo delle quote.

Nella maggior parte dei casi, consigliamo di generare un ID oggetto casuale. Ad esempio, se utilizzano Java, java.util.UUID.randomUUID().toString() dovrebbe funzionare bene.

Se la tua applicazione vuole tenere traccia degli oggetti per un periodo più lungo di non fare affidamento sull'ID oggetto, perché potrebbe cambiare. Consulta quanto segue: per ulteriori dettagli.

Monitoraggio degli oggetti senza utilizzare l'ID oggetto

Quando effettui una richiesta all'API Presentazioni, di solito l'ID oggetto viene conservato. (Qualsiasi sono indicate nella documentazione di riferimento del metodo. Inventa copia di un'intera presentazione con l'API Drive conserva anche gli ID oggetto.

Tuttavia, non puoi dipendere dal fatto che un ID oggetto non venga modificato dopo una presentazione è stata modificata nella UI di Presentazioni. Ad esempio, se un utente utilizza il file UI che consente di copiare e incollare un elemento di pagina e poi di eliminare l'originale, quello della pagina avrà ora un nuovo ID univoco e l'ID fornito in precedenza tramite l'API andranno perse. Di conseguenza, sconsigliamo di archiviare gli ID oggetto nel lo spazio di archiviazione dell'applicazione. Dovresti invece trovare gli oggetti nella presentazione i relativi contenuti testuali o il testo alternativo.

Per le presentazioni appena create, di solito viene utilizzato un insieme coerente di ID slide, schemi e caselle di testo. Questi ID sono soggetti a modifiche nel tempo, quindi ti sconsigliamo di fare affidamento su questa funzione. Trova invece gli elementi che desideri modificare utilizzando l'oggetto presentazione restituito dalle chiamate a create() oppure get().