Introducción

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

Se pueden integrar apps con la API de Presentaciones de Google para crear atractivas presentaciones de diapositivas automáticamente a partir de datos proporcionados por el usuario y el sistema. Por ejemplo, puedes usar detalles de clientes de una base de datos y combinarlos con plantillas prediseñadas y opciones de configuración seleccionadas para crear presentaciones terminadas en una fracción del tiempo que tomaría crearlas de forma manual.

Descripción general de la API

La colección de presentaciones proporciona métodos que te permiten obtener y actualizar elementos de la presentación.

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

  • Crear diapositivas
  • Agregar elementos a las diapositivas, como formas o tablas
  • Cómo insertar, cambiar y quitar texto
  • Aplica transformaciones a los elementos
  • Cómo cambiar el orden de las diapositivas

Consulta Actualizaciones por lotes para obtener más detalles. Consulta las guías de introducción para obtener un ejemplo simple de extremo a extremo de cómo usar la API.

La estructura de una presentación

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

El ID de una presentación se puede derivar de la URL:

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

El ID de presentación es una cadena que contiene letras, números y algunos caracteres especiales. La siguiente expresión regular se puede usar para extraer el ID de presentación de una URL de Hojas de cálculo de Google:

/presentation/d/([a-zA-Z0-9-_]+)

Si estás familiarizado con la API de Drive, presentationId corresponde al ID del recurso File.

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

Páginas

Presentaciones de Google tiene los siguientes tipos de páginas:

Maestrías Los patrones de diapositivas definen los estilos de texto, el fondo y los elementos de página predeterminados que aparecen en todas las diapositivas que usan este diseño maestro. Los elementos de página que deben aparecer en todas las diapositivas deben agregarse al diseño maestro. La mayoría de las presentaciones tienen un diseño maestro, pero es posible que algunas tengan varios o ninguno.
Diseños Los diseños sirven como plantilla para la forma en que se organizarán los elementos de página de forma predeterminada en las diapositivas que usan un diseño. Cada diseño está asociado con un diseño maestro.
Diapositivas Estas páginas incluyen el contenido que estás presentando a tu público. La mayoría de las diapositivas se basan en un patrón y un diseño. Puedes especificar qué diseño usar para cada diapositiva cuando la crees.
Notas Estas páginas incluyen el contenido de los folletos de la presentación, incluida una forma que contiene las notas del orador de la diapositiva. Cada diapositiva tiene una página de notas correspondiente. Solo el texto en la forma de las notas del orador se puede modificar con la API de Presentaciones.
Maestros de notas Los patrones de notas definen los elementos de página y estilos de texto predeterminados para todas las páginas de notas. Los patrones de notas son de solo lectura en la API de Presentaciones.

Elementos de página

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

Grupo Es un conjunto de elementos de página que reciben tratamiento como una unidad individual. Pueden moverse, escalarse y rotarse en conjunto.
Forma Es un objeto visual 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 Es un gráfico importado a Presentaciones.
Video Un video importado a Presentaciones
Line Una línea, curva o conector visual.
Tabla Cuadrícula de contenido.
WordArt Elemento de texto visual que se comporta más como una forma.
SheetsChart Gráfico importado a Presentaciones desde Hojas de cálculo de Google.

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 falla una solicitud.

El método batchUpdate toma uno o más objetos Request, cada uno de los cuales especifica un solo tipo de solicitud que se realizará. Existen muchos tipos diferentes de solicitudes. A continuación, se muestra un desglose de los tipos de solicitudes, agrupados en diferentes categorías.

Cómo trabajar con Presentaciones: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
Cómo trabajar con los elementos de página: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
Trabaja con tablas: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
Cómo trabajar con gráficos: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
Cómo trabajar con imágenes y videos: CreateImageRequest
CreateVideoRequest
UpdateImagePropertiesRequest
UpdateVideoPropertiesRequest
ReplaceAllShapesWithImageRequest
DuplicateObjectRequest
DeleteObjectRequest
Cómo trabajar con texto: InsertTextRequest
DeleteTextRequest
ReplaceAllTextRequest
CreateParagraphBulletsRequest
DeleteParagraphBulletsRequest
UpdateTextStyleRequest
UpdateParagraphStyleRequest

El método batchUpdate muestra un cuerpo de respuesta, que contiene una respuesta para cada solicitud. Cada respuesta ocupa el mismo índice que la solicitud correspondiente. En el caso de las solicitudes sin respuesta aplicable, la respuesta en ese índice estará vacía. Por lo general, las distintas solicitudes Create tienen respuestas para que conozcas el ID del objeto recién agregado.

Cómo trabajar con IDs de objetos

En la API de Presentaciones, una presentación se compone de páginas y elementos de página. Estos objetos incluyen una cadena de ID de objeto que es única dentro de una presentación.

Especificación de los IDs de objeto durante la creación

Cuando creas páginas o elementos de página con el método batchUpdate, tienes la opción de especificar un ID de objeto para el objeto nuevo. Esto te permite crear un objeto y modificarlo dentro de la misma solicitud CSEK, lo que minimiza la cantidad de llamadas a la API de Presentaciones 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 quiera realizar un seguimiento de los objetos durante un período más largo, no dependas del ID del objeto, ya que puede cambiar. Consulta la siguiente sección para obtener más detalles.

Hacer un seguimiento de los objetos sin usar el ID de objeto

Cuando se realiza una solicitud a la API de Presentaciones, el ID de objeto normalmente se conserva. (todas las excepciones se mencionan en la documentación de referencia del método). Hacer una copia de una presentación completa con la API de Drive también conserva los IDs de objeto.

Sin embargo, no puedes confiar en que el ID de un objeto no se modificará después de que se modifique una presentación en la IU de Presentaciones. Por ejemplo, si alguien usa la IU de Presentaciones para copiar y pegar un elemento de la página y, luego, borra el original, el elemento de la página ahora tendrá un ID único nuevo y se perderá el que proporcionaste antes a través de la API. Por lo tanto, no recomendamos que almacenes los ID de objeto en el almacenamiento de la aplicación. En cambio, debes encontrar objetos en la presentación a través de su contenido de texto o texto alternativo.

Las presentaciones nuevas suelen usar un conjunto coherente de ID para diapositivas, patrones y cuadros de texto predeterminados. Estos IDs están sujetos a cambios con el tiempo, por lo que no te recomendamos que utilices esta función. En su lugar, encuentra los elementos que quieras modificar mediante el objeto de presentación que se muestra con las llamadas a create() o get().