Operazioni di presentazione

L'API Presentazioni Google 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 presentations.batchUpdate metodo.

Questi esempi sono 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 Google, consulta le seguenti guide:

Creare una presentazione

Il seguente presentations.create esempio di codice 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"
}

Elencare 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 (presentato di seguito) utilizza maschere di campo per restituire un elenco di file di presentazione da Drive, con l'ID file, il nome file e un link per aprire il file.files.list La richiesta specifica anche application/vnd.google-apps.presentation come il 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 nella 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 nelle slide master. In questo caso, la sostituzione del testo fa distinzione tra 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."
      }
    }
  ]
}