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 presentazioni 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 lo stile 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 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.
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 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 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().