L'API Presentazioni Google consente di creare e modificare presentazioni Google.
Le app possono integrarsi con l'API Presentazioni Google per creare automaticamente fantastiche presentazioni dai dati forniti dall'utente e dal sistema. Ad esempio, puoi utilizzare i dettagli dei clienti da un database e combinarli con modelli predefiniti 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 metodi che ti consentono di recuperare e aggiornare elementi all'interno della presentazione.
La maggior parte del tuo lavoro con l'API Presentazioni si occuperà probabilmente di creare e aggiornare presentazioni. A tal fine puoi utilizzare il metodo batchUpdate. Questo metodo richiede un elenco di oggetti Request 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 usare l'API.
La struttura di una presentazione
Una presentazione nell'API Presentazioni è composta da pagine, che contengono elementi di pagina.
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. La seguente espressione regolare può essere utilizzata per estrarre l'ID presentazione da un URL di Fogli Google:
/presentation/d/([a-zA-Z0-9-_]+)
Se hai familiarità con l'API Drive, presentationId corrisponde all'ID della risorsa File.
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 gli elementi della pagina predefiniti che vengono visualizzati in tutte le slide che utilizzano lo schema. Gli elementi della pagina che devono apparire su tutte le slide devono essere aggiunti allo schema. La maggior parte delle presentazioni ha un solo master, ma alcune possono averne diversi o nessuno. |
| Layout | I layout fungono da modello per la disposizione predefinita degli elementi di pagina nelle slide usando un layout. Ogni layout è associato a un master. |
| 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 layout utilizzare per ogni slide quando viene creata. |
| Note | Queste pagine includono i contenuti per le dispense della presentazione, tra cui una forma che include le note del relatore della slide. Ogni slide ha una pagina delle note corrispondente. Solo il testo nella forma delle note del relatore può essere modificato con l'API Presentazioni. |
| Master delle note | I master delle note definiscono gli stili di testo e gli elementi della pagina predefiniti per tutte le 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 essere spostati, scalati e ruotati insieme. |
| Shape | Un oggetto visivo semplice, come rettangoli, ellissi e caselle di testo. Le forme possono contenere testo, per cui sono gli elementi di pagina più comuni per creare slide. |
| Immagine | Un'immagine importata in Presentazioni. |
| Video | Un video importato in Presentazioni. |
| A linee | 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, non venga scritta nessuna delle altre modifiche (potenzialmente dipendenti).
Il metodo batchUpdate utilizza uno o più oggetti Request, ognuno dei quali specifica un singolo tipo di richiesta da eseguire. Esistono molti tipi diversi di richieste. Ecco una suddivisione dei tipi di
richieste, raggruppati in diverse categorie.
Il metodo batchUpdate restituisce un corpo della risposta, che contiene una risposta
per ogni richiesta. Ogni risposta occupa lo stesso indice della richiesta corrispondente; per le richieste senza una risposta applicabile, la risposta in tale indice sarà vuota. In genere le varie richieste Create hanno delle risposte, quindi conosci 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 ID oggetto univoca all'interno di una presentazione.
Specificare gli ID oggetto al momento della creazione
Quando crei pagine o elementi di pagina utilizzando il metodo batchUpdate, puoi facoltativamente specificare un ID oggetto per il nuovo oggetto. Ciò consente di creare un oggetto e modificarlo all'interno della stessa richiesta batchUpdate, riducendo al minimo il numero di 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 utilizzi Java, java.util.UUID.randomUUID().toString() dovrebbe funzionare bene.
Se la tua applicazione desidera tenere traccia degli oggetti per un periodo di tempo più lungo, non fare affidamento sull'ID oggetto, perché potrebbe cambiare. Per ulteriori dettagli, consulta la sezione che segue.
Monitoraggio degli oggetti senza utilizzare l'ID oggetto
Quando effettui una richiesta all'API Presentazioni, di solito l'ID oggetto viene conservato. Eventuali eccezioni sono indicate nella documentazione di riferimento del metodo. Anche la creazione di una copia di un'intera presentazione con l'API Drive conserva gli ID oggetto.
Tuttavia, non è possibile fare in modo che un ID oggetto non venga modificato dopo la modifica di una presentazione nell'interfaccia utente di Presentazioni. Ad esempio, se un utente utilizza l'interfaccia utente di Presentazioni per copiare e incollare un elemento di pagina e poi elimina l'originale, quest'ultimo avrà un nuovo ID univoco e l'ID fornito in precedenza tramite l'API andrà perso. Di conseguenza, sconsigliamo di archiviare gli ID oggetto nello spazio di archiviazione dell'applicazione. Dovresti trovare gli oggetti della presentazione in base al contenuto testuale o al testo alternativo.
Le presentazioni appena create utilizzano in genere un insieme coerente di ID per le slide, gli schemi e le caselle di testo predefiniti. Questi ID sono soggetti a modifiche nel tempo, quindi non è consigliabile utilizzare questa funzionalità. Trova invece gli elementi da modificare utilizzando l'oggetto di presentazione restituito dalle chiamate a create() o get().