Operazioni di presentazione

L'API Google Slides ti consente di creare file di presentazione e gestire quelli esistenti. Gli esempi in questa pagina mostrano alcune operazioni comuni di presentazione delle pagine utilizzando il metodo presentations.batchUpdate.

Questi esempi vengono presentati come richieste HTTP per essere indipendenti dalla lingua. Per scoprire come implementare un aggiornamento batch in diverse lingue utilizzando le librerie client delle API di Google, consulta le seguenti guide:

Creare una presentazione

Il seguente esempio di codice presentations.create mostra come creare un file di presentazione vuoto intitolato "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 Slides 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 presentazioni da Drive, con l'ID file, il nome file e un link per aprire il file. 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 esempio di codice presentations.batchUpdate mostra come utilizzare il metodo ReplaceAllTextRequest per sostituire il testo in tutta la presentazione specificata da 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." Sono inclusi il testo nelle caselle di testo e in altre forme, nelle slide e all'interno dei master. In questo caso, la sostituzione del testo è sensibile alle maiuscole e minuscole 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."
      }
    }
  ]
}