La API de Presentaciones de Google te permite crear y modificar presentaciones de Presentaciones de Google.
Las apps se pueden integrar con la API de Presentaciones de Google 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 detalles de los 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 se necesitaría para crearlas manualmente.
Descripción general de la API
La colección presentaciones proporciona métodos que te permiten obtener y actualizar elementos de estas.
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 Request 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 ver un ejemplo de uso de la API simple y completo.
La estructura de una presentación
Una presentación de la API de Presentaciones 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/presentationId/edit
El ID de la 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 la presentación de una URL de Hojas de cálculo de Google:
/presentation/d/([a-zA-Z0-9-_]+)
Si conoces la Drive API, 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:
| Máster | 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 patrón. 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 maestro. |
| Presentaciones | 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. |
| Notas | Estas páginas incluyen el contenido para los documentos de las presentaciones, 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 puede modificarse 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 separada. Pueden moverse, recibir ajustes de tamaño y girarse en conjunto. |
| Forma | 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 | Elemento gráfico importado a Presentaciones. |
| Video | Es un video importado a Presentaciones. |
| Línea | Una línea, curva o conector visual. |
| Tabla | Una cuadrícula de contenido. |
| WordArt | Es un elemento de texto visual cuyo comportamiento responde más al de 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, si una solicitud falla, no se escriba ninguno de los demás (potencialmente dependientes).
El método batchUpdate funciona tomando uno o más objetos Request, cada uno de los cuales especifica un solo tipo de solicitud que se debe realizar. Existen muchos tipos diferentes de solicitudes. A continuación, se ofrece un desglose de los tipos de solicitudes, agrupados en diferentes categorías.
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 para las cuales no haya respuestas aplicables, la respuesta del índice en cuestión estará vacía. Por lo general, las diferentes solicitudes de Create tienen respuestas para que conozcas el ID del objeto agregado recientemente.
Cómo trabajar con IDs de objetos
Una presentación de la API de Presentaciones consta 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.
Especifica los IDs de objeto al crearlos
Cuando creas páginas o elementos de página con el método batchUpdate, puedes especificar un ID de objeto para el objeto nuevo de forma opcional. Esto te permite crear un objeto y modificarlo dentro de la misma solicitud batchUpdate, lo cual minimiza el número 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 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. Consulta la siguiente sección para obtener más detalles.
Realiza 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 citan en la documentación de referencia del método). Cuando se hace una copia de una presentación completa con la API de Drive, también se conservan los IDs 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 Presentaciones. Por ejemplo, si alguien usa la IU de Presentaciones para copiar y pegar un elemento de página y, luego, borra el original, el elemento de página ahora tendrá un ID único nuevo y se perderá el que proporcionaste previamente a través de la API. Por lo tanto, no recomendamos que almacenes los IDs 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 IDs para diapositivas, patrones y cuadros de texto predeterminados. Con el tiempo, estos IDs están sujetos a cambios, por lo que no te recomendamos recurrir a esta función. En su lugar, encuentra los elementos que deseas modificar usando el objeto de presentación que se obtiene mediante llamadas a create() o get().