Operaciones de presentación

La API de Presentaciones de Google te permite crear archivos de presentación y administrar los existentes. En los ejemplos de esta página, se muestran algunas operaciones comunes de presentación de páginas con el presentations.batchUpdate método.

Estos ejemplos se presentan como solicitudes HTTP para que sean independientes del lenguaje. Para obtener información sobre cómo implementar una actualización por lotes en diferentes lenguajes con las bibliotecas cliente de las APIs de Google, consulta las siguientes guías:

Crear una presentación

En el siguiente presentations.create ejemplo de código, se muestra cómo crear un archivo de presentación en blanco titulado "Mi nueva presentación".

También es posible crear archivos de presentación en blanco con el método de la API de Google Drive files.create si especificas application/vnd.google-apps.presentation como el tipo MIME.

El siguiente es el protocolo de solicitud para crear una presentación:

POST https://slides.googleapis.com/v1/presentations
 
{
  "title": "My New Presentation"
}

Cómo enumerar los archivos de presentación existentes

La API de Presentaciones no proporciona un método para recuperar una lista de presentaciones, pero la API de Drive sí. El files.list método (que se muestra a continuación) usa máscaras de campo para mostrar una lista de archivos de presentación de tu unidad, con el ID del archivo, el nombre del archivo y un vínculo para abrirlo. La solicitud también especifica application/vnd.google-apps.presentation como el tipo MIME.

El siguiente es el protocolo de solicitud para enumerar los archivos de presentación existentes:

GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)

La respuesta a esta solicitud tiene la siguiente estructura:

{
 "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"
    },
    ...
  ]
}

Cómo reemplazar texto en una presentación

En el siguiente presentations.batchUpdate ejemplo de código, se muestra cómo usar el método ReplaceAllTextRequest para reemplazar texto en la presentación especificada por PRESENTATION_ID. Puedes descubrir el valor del ID de la presentación en la URL de la presentación.

Cada instancia de la cadena "Gizmo Corp." se reemplaza por el texto "Gadget Inc.". Esto incluye texto en cuadros de texto y otras formas, en diapositivas y en patrones. En este caso, el reemplazo de texto distingue mayúsculas de minúsculas cuando se establece matchCase en true.

El siguiente es el protocolo de solicitud para reemplazar texto en una presentación:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
 
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}