L'API Google Slides ti consente di creare file di presentazione e di gestire quelli esistenti.
Gli esempi in questa pagina mostrano alcune operazioni comuni di presentazione della pagina che utilizzano il metodo presentations.batchUpdate
.
Questi esempi sono presentati come richieste HTTP per essere indipendenti dalla lingua. Per scoprire come implementare un aggiornamento collettivo in lingue diverse utilizzando le librerie client dell'API Google, consulta le seguenti guide:
Creare una presentazione
Il seguente
presentations.create
esempio di codice mostra come creare un file di presentazione vuoto denominato "La mia nuova presentazione".
È anche possibile creare file di presentazione vuoti utilizzando il metodo files.create
dell'API Google Drive specificando application/vnd.google-apps.presentation
come tipo MIME.
Di seguito è riportato il protocollo di richiesta per creare una presentazione:
POST https://slides.googleapis.com/v1/presentations
{ "title": "My New Presentation" }
Elenca i file di presentazione esistenti
L'API Presentazioni non fornisce un metodo per recuperare un elenco di presentazioni, ma l'API Drive sì.
Il metodo files.list
(descritto di seguito) utilizza le maschere di campo per restituire un elenco di file di presentazione da Drive, con l'ID file, il nome del file e un link per aprirlo. La richiesta specifica anche application/vnd.google-apps.presentation
come tipo MIME.
Di seguito è riportato il protocollo di richiesta per elencare i file di presentazione esistenti:
GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)
La risposta a questa richiesta ha la seguente struttura:
{ "files": [ { "id": "abcdefghijklmnopqrstuvwxyz0123456789", "name": "Project Vision", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk" }, { "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", "name": "Untitled Presentation", "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk" }, ... ] }
Sostituire il testo in una presentazione
Il seguente
presentations.batchUpdate
esempio di codice mostra come utilizzare il
ReplaceAllTextRequest
metodo per sostituire il testo in tutta la presentazione specificata dall'PRESENTATION_ID. Puoi trovare il valore dell'ID presentazione dall'URL della presentazione.
Ogni istanza della stringa "Gizmo Corp." viene sostituita con il testo "Gadget
Inc." Sono inclusi il testo nelle caselle di testo e in altre forme, nelle diapositive e nei modelli. In questo caso, la sostituzione del testo è sensibile alle maiuscole impostando
matchCase
su true
.
Di seguito è riportato il protocollo di richiesta per sostituire il testo in una presentazione:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "replaceAllText": { "containsText": { "text": "Gizmo Corp.", "matchCase": true }, "replaceText": "Gadget Inc." } } ] }