Operazioni di presentazione

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 presentations.batchUpdate .

Questi esempi vengono presentati come richieste HTTP per essere indipendenti dal linguaggio. Per apprendere come implementare un aggiornamento batch in lingue diverse utilizzando l'API di Google librerie client, consulta le seguenti guide:

Crea una presentazione

Le seguenti presentations.create esempio di codice mostra come creare un file di presentazione vuoto intitolato "My New presentazione".

È anche possibile creare file di presentazioni vuoti utilizzando l'API Google Drive files.create specificando application/vnd.google-apps.presentation come MIME tipo.

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 di Google Cloud, mentre l'API Drive sì. Il metodo files.list (presentato di seguito) utilizza le maschere di campo per restituire un elenco i file di presentazioni dal tuo Drive, con ID, nome file e un link per aprire il file. La richiesta specifica inoltre application/vnd.google-apps.presentation come MIME predefinito.

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 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

Le seguenti presentations.batchUpdate l'esempio di codice mostra come utilizzare ReplaceAllTextRequest per sostituire il testo in tutta la presentazione specificato dal metodo PRESENTATION_ID. Puoi scoprire il valore per ID presentazione dall'URL della presentazione.

Ogni istanza della stringa "Gizmo Corp". viene sostituito dal testo "Gadget Inc." È incluso il testo nelle caselle di testo e in altre forme, nelle slide e all'interno maestri. In questo caso, la sostituzione di testo è sensibile alle maiuscole impostando matchCase a 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."
      }
    }
  ]
}