L'API Presentazioni Google consente di creare file di presentazioni e gestire quelli esistenti.
Gli esempi in questa pagina mostrano alcune operazioni di presentazione di pagina comuni utilizzando il metodo presentations.batchUpdate.
Questi esempi sono presentati come richieste HTTP per essere neutrali di lingua. Per scoprire come implementare un aggiornamento batch in lingue diverse utilizzando le librerie client dell'API di Google, consulta le seguenti guide:
Creare una presentazione
Il seguente esempio di codice di presentations.create mostra come creare un file di presentazione vuoto intitolato "My New
Presentation".
È 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 (presentato
di seguito) utilizza le maschere di campo per restituire un elenco dei file di presentazione dal tuo Drive, con l'ID e il nome 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 tutta la presentazione
Il seguente esempio di codice di presentations.batchUpdate mostra come utilizzare il metodo ReplaceAllTextRequest per sostituire il testo in tutta la presentazione specificata dal PRESENTATION_ID. Puoi scoprire il valore dell'ID presentazione dall'URL della presentazione.
Ogni istanza della stringa "Gizmo Corp." viene sostituita con il testo "Gadget Inc.". Questo include il testo in caselle di testo e altre forme, nelle slide e all'interno degli schemi. In questo caso, la sostituzione del testo è sensibile alle maiuscole impostando
matchCase
su true.
Di seguito è riportato il protocollo di richiesta per la sostituzione del 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."
}
}
]
}