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 método presentations.batchUpdate
.
Estos ejemplos se presentan como solicitudes HTTP para que tengan lenguaje neutro. Si quieres aprender a implementar una actualización por lotes en diferentes lenguajes con las bibliotecas cliente de la API de Google, consulta las siguientes guías:
- Cómo crear y administrar presentaciones
- Cómo buscar archivos y carpetas
- Cómo combinar datos en una presentación
Crear una presentación
En la siguiente muestra de código presentations.create
, se indica cómo crear un archivo de presentación en blanco denominado "My New Slides".
También es posible crear archivos de presentación en blanco con el método files.create
de la API de Google Drive especificando application/vnd.google-apps.presentation
como el tipo de MIME.
El siguiente es el protocolo de solicitud para crear una presentación:
POST https://slides.googleapis.com/v1/presentations
{ "title": "My New Presentation" }
Enumerar 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 método files.list
(que se presenta a continuación) usa máscaras de campo para mostrar una lista de archivos de presentación de tu unidad de Drive, con el ID y el nombre del archivo, y un vínculo para abrirlo. La solicitud también especifica application/vnd.google-apps.presentation
como el tipo de 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" }, ... ] }
Reemplazar el texto durante una presentación
En la siguiente muestra de código de presentations.batchUpdate
, se indica cómo usar el método ReplaceAllTextRequest
para reemplazar texto en toda la presentación que especifica PRESENTATION_ID. Puedes descubrir el valor del ID de presentación desde la URL de la presentación.
Cada instancia de la cadena "Gizmo Corp." se reemplaza por el texto "Gadget Inc.". Esto incluye el texto en los cuadros de texto y otras formas, en las diapositivas y en las maestros. En este caso, el reemplazo de texto distingue mayúsculas de minúsculas, ya que establece matchCase
en true
.
El siguiente es el protocolo de solicitud para reemplazar texto durante una presentación:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "replaceAllText": { "containsText": { "text": "Gizmo Corp.", "matchCase": true }, "replaceText": "Gadget Inc." } } ] }