Introducción

La Google Slides API te permite crear y modificar presentaciones de Google Slides.

Se pueden integrar apps con la Google Slides API para crear atractivos lotes de diapositivas de manera automática a partir de datos proporcionados por el usuario y el sistema. Por ejemplo, puedes usar información detallada de los clientes incluida en una base de datos y combinarla con plantillas predefinidas y opciones de configuración seleccionadas, a fin de crear presentaciones acabadas en una fracción del tiempo que se necesitaría para crearlas manualmente.

Información general sobre la API

En la colección de presentaciones se proporcionan métodos que te permiten obtener y actualizar elementos de estas.

La mayor parte de tu trabajo con la Slides API probablemente consistirá en crear y actualizar presentaciones. Podrás hacer esto con el método batchUpdate; este método toma una lista de objetos Request que te permiten realizar acciones como las siguientes:

  • Crear diapositivas.
  • Agregar a las diapositivas elementos como formas o tablas.
  • Insertar, cambiar y quitar texto.
  • Aplicar transformaciones a elementos.
  • Cambiar el orden de las diapositivas.

Para obtener más información, consulta Actualizaciones por lotes. Consulta las guías de introducción para hallar un ejemplo de uso de la API simple y completo.

Estructura de una presentación

Una presentación de la Slides API consta de páginas que contienen elementos de página.

Es posible derivar el ID de una presentación a partir de la URL:

https://docs.google.com/presentation/d/presentation ID/edit

Las páginas y los elementos de página se identifican mediante ID de objeto.

Páginas

Google Slides tiene tres clases de páginas:

Patrones Los patrones de diapositivas definen los estilos de texto, el fondo y elementos de página predeterminados que aparecen en todas las diapositivas en las cuales se usan dichos patrones. Los elementos de página que deben aparecer en todas las diapositivas deben agregarse al patrón. La mayoría de las presentaciones tienen un patrón, pero es posible que en algunas haya varios o no exista ninguno.
Diseños Los diseños sirven como plantilla para la disposición predeterminada de elementos de página en diapositivas a las que se aplique un diseño. Cada diseño se asocia con un patrón.
Diapositivas En las siguientes páginas, se ofrece contenido que presentarás a tu público. La mayoría de las diapositivas se basan en un patrón y un diseño. Puedes especificar el diseño que se usará para cada diapositiva al crearla.

Elementos de página

Los elementos de página son los componentes visuales que se disponen en las páginas. La API expone varias clases de elementos de página:

Grupo Conjunto de elementos de página que reciben tratamiento como una unidad separada. Pueden moverse, recibir ajustes de tamaño y girarse en conjunto.
Forma Objeto visible simple, como rectángulos, elipses y cuadros de texto. Las formas pueden contener texto. Por lo tanto, son los elementos de página más comunes a la hora de crear diapositivas.
Imagen Elemento gráfico importado a Slides.
Video Secuencia de video importada a Slides.
Línea Línea, curva o conector visible.
Tabla Cuadrícula de contenido.
WordArt Elemento de texto visible cuyo comportamiento responde más al de una forma.
SheetsChart Gráfico importado a Slides desde Google Sheets.

Actualizaciones por lotes

El método batchUpdate te permite actualizar muchos aspectos de una presentación. Los cambios se agrupan en un lote para que no se escriba ninguno de los demás (potencialmente dependientes) si una solicitud falla.

El método batchUpdate funciona tomando uno o más objetos Request, cada uno de los cuales especifica una clase de solicitud que se realizará. Existen muchas clases diferentes de solicitudes. A continuación se ofrece un desglose de los tipos de solicitudes, agrupados en diferentes categorías.

Para trabajar con Slides: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
Para trabajar con elementos de página: CreateShapeRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
Para trabajar con tablas: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableCellPropertiesRequest
DeleteObjectRequest
Para trabajar con gráficos: CreateSheetsChartRequest
RefreshSheetsChartRequest
DeleteObjectRequest
Para trabajar con imágenes y video: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
Para trabajar con texto: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
UpdateTextStyleRequest

El método batchUpdate muestra un cuerpo de respuesta, que contiene un elemento Response para cada solicitud. Cada respuesta ocupa el mismo índice que la solicitud correspondiente; en el caso de las solicitudes para las cuales no haya respuestas aplicables, la respuesta del índice en cuestión estará vacía. Para las diferentes solicitudes Create normalmente existen respuestas. De esta manera, podrás conocer el ID de los objetos agregados recientemente.

Cómo trabajar con los ID de objeto

Una presentación de la Slides API consta de páginas y elementos de página. Estos objetos incluyen una string de ID de objeto que es exclusiva dentro de una presentación.

Cómo especificar los ID de objeto al crearlos

Al crear páginas o elementos de página usando el método batchUpdate, tienes la opción de especificar un ID de objeto para el nuevo objeto. Esto te permite crear un objeto y modificarlo dentro de la misma solicitud batchUpdate, lo cual minimiza el número de llamadas a la Slides API y reduce el uso de cuota.

En la mayoría de los casos, recomendamos generar un ID de objeto aleatorio. Por ejemplo, si usas Java, java.util.UUID.randomUUID().toString() debería funcionar bien.

Cuando tu aplicación intente realizar un seguimiento de los objetos por un período de tiempo más prolongado, no debes recurrir al ID de objeto porque puede cambiar. Para obtener más información, consulta la siguiente sección.

Cómo realizar un seguimiento de los objetos sin usar el ID de objeto

Cuando se realiza una solicitud de Slides API, el ID de objeto normalmente se conserva. (Todas las excepciones se citan en la documentación de referencia). Cuando se hace una copia de una presentación completa con la Drive API también se conservan los ID de objeto.

Sin embargo, no se puede confiar en que el ID de un objeto no se modificará después de que se cambie una presentación en la IU de Slides. Por ejemplo, si alguien usa la IU de Slides para copiar y pegar un elemento de página y luego borra el original, el elemento pasará a tener un ID único nuevo y se perderá el que proporcionaste previamente a través de la API. Como resultado, no recomendamos que almacenes los ID de objeto en el espacio de almacenamiento de tu aplicación. En lugar de ello, debes hallar objetos en la presentación a través de su contenido de texto o texto alternativo.

En las presentaciones nuevas normalmente se usa un conjunto uniforme de ID para diapositivas , patrones y cuadros de texto predeterminados. Con el tiempo, estos ID están sujetos a cambios. Por este motivo no te recomendamos recurrir a esta función. En lugar de esto, encuentra elementos que desees modificar usando el objeto de presentación que se obtenga mediante llamadas a create() o get().

Enviar comentarios sobre…