L'API Presentazioni Google ti consente di creare file di presentazioni e gestire file esistenti.
Gli esempi in questa pagina mostrano alcune operazioni comuni di presentazione della pagina utilizzando il metodo presentations.batchUpdate.
Questi esempi vengono presentati come richieste HTTP per essere indipendenti dal linguaggio. Per scoprire come implementare un aggiornamento batch in diversi linguaggi utilizzando le librerie client dell'API di Google, consulta le seguenti guide:
Crea una presentazione
Il seguente esempio di codice presentations.create mostra come creare un file di presentazione vuoto intitolato "My New Presentaation".
È anche possibile creare file di presentazioni 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 presentazioni 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 di file di presentazione dal tuo Drive, con l'ID file, il nome del file e un link per l'apertura del file. Nella richiesta è inoltre specificato
application/vnd.google-apps.presentation come tipo
MIME.
Di seguito è riportato il protocollo di richiesta per elencare i file di presentazioni 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 esempio di codice presentations.batchUpdate mostra come utilizzare il metodo ReplaceAllTextRequest per sostituire il testo in tutta la presentazione specificata da PRESENTATION_ID. Puoi trovare il valore dell'ID presentazione
nell'URL della presentazione.
Ogni istanza della stringa "Gizmo Corp." viene sostituita con il testo "Gadget
Inc." tra cui testo in caselle di testo e altre forme, sulle slide e all'interno
degli schemi. In questo caso, la sostituzione di 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."
}
}
]
}