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 presentaciones atractivas automáticamente con los datos proporcionados por el usuario y el sistema. Por ejemplo, podrías usan los detalles de clientes de una base de datos y los combinan con plantillas y las opciones de configuración seleccionadas para crear presentaciones terminadas en una fracción del tiempo que llevaría crearlos manualmente.
Descripción general de la API
La colección de presentaciones ofrece 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. Para ello, utilizarás el batchUpdate; este método toma una lista de Solicitar objetos 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 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 cómo usar la API de forma integral.
La estructura de una presentación
En la API de Presentaciones, una presentación se compone de páginas que contienen o de terceros.
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 algunas caracteres. La siguiente expresión regular se puede usar para extraer el ID de presentación desde una URL de Hojas de cálculo de Google:
/presentation/d/([a-zA-Z0-9-_]+)
Si conoces la API de Drive, presentationId corresponde a la
ID del archivo
recurso.
Las páginas y sus elementos se identifican mediante ID 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 la página predeterminados. elementos que aparecen en todas las diapositivas que usan este diseño maestro. Página los elementos que deben aparecer en todas las diapositivas deben agregarse al diseño maestro. Más probable las presentaciones tienen un maestro, pero algunas pueden tener varios o ninguno. |
| Diseños | Los diseños sirven como plantilla para ver cómo se organizarán los elementos de página de forma predeterminada en las diapositivas con un diseño. Cada diseño se asocia con un principal. |
| Presentaciones | Estas páginas incluyen el contenido que le 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 para cada diapositiva que se cree. |
| Notas | Estas páginas incluyen el contenido de los folletos de la presentación, que incluye un una forma que contiene las notas del orador de la diapositiva. Cada diapositiva tiene una página de notas correspondiente. Solo se puede agregar el texto con forma de Notas del orador con la API de Presentaciones. |
| Maestros de notas | Los patrones de notas definen los estilos de texto y los elementos de página predeterminados para todos 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 se tratan como una unidad individual. Pueden mover, escalar y rotar juntos. |
| Forma | Es un objeto visual simple, como rectángulos, elipses y cuadros de texto. Las formas pueden contener texto, de modo que son los elementos de página más comunes que se deben crear diapositivas. |
| Imagen | Un gráfico importado a Presentaciones. |
| Video | Es un video importado a Presentaciones. |
| Línea | Una línea, curva o conector visual. |
| Tabla | Cuadrícula de contenido |
| WordArt | Es un 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, si falla una solicitud, ninguna de las demás (posiblemente dependiente) se escriben los cambios.
El método batchUpdate toma uno o más
Solicitar
cada uno de los cuales especifica
un solo tipo de solicitud para realizar. Existen
muchos tipos diferentes de solicitudes. Este es un desglose de los tipos de solicitudes,
agruparse en diferentes categorías.
El método batchUpdate muestra un cuerpo de respuesta.
que contiene un
Respuesta
para cada solicitud. Cada respuesta ocupa el mismo índice que la respuesta
solicitud; Para solicitudes sin una respuesta aplicable, la respuesta en ese índice
estarán vacías. Las diversas solicitudes Create normalmente tienen respuestas, por lo que
que conoces el ID del objeto agregado recientemente.
Trabaja con IDs de objeto
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 presentación.
Especifica los IDs de objeto durante la creación
Al crear páginas o elementos de página con la batchUpdate, de manera opcional, puede especificar un ID para el objeto nuevo. Esto te permite crear y modifícalo dentro de la misma solicitud method, lo que minimiza el número de llamadas a la API de Presentaciones y reducir el uso de la cuota.
En la mayoría de los casos, recomendamos generar un ID de objeto aleatorio. Por ejemplo, si
usan Java, java.util.UUID.randomUUID().toString() debería funcionar bien.
Cuando tu aplicación quiere hacer un seguimiento de los objetos durante un período más largo no confíes en el ID del objeto, ya que puede cambiar. Consulta lo siguiente 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. (Cualquiera excepciones se mencionan en la documentación de referencia del método). Hacer un una copia de una presentación completa con la API de Drive también conserva los ID de objeto.
Sin embargo, no puedes depender de que el ID de un objeto no se modifique después de una presentación. se cambia en la IU de Presentaciones. Por ejemplo, si alguien usa el panel IU para copiar y pegar un elemento de página y, luego, borrar el original; el elemento de página ahora tendrá un nuevo ID único y el ID que proporcionó anteriormente a través de la API se perderán. Por eso, no recomendamos que almacenes IDs de objeto en tu en el almacenamiento de la aplicación. En cambio, debes encontrar objetos en la presentación su contenido de texto o texto alternativo.
Por lo general, las presentaciones recién creadas utilizan un conjunto de ID uniformes para la configuración diapositivas, patrones y cuadros de texto. Estos IDs están sujetos a cambios con el tiempo, por lo que no recomendamos utilizar esta función. En cambio, busca los elementos y quieres modificar con el objeto de presentación devuelto por las llamadas a create() o get().