Introducción

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.

Cómo trabajar con Presentaciones: CreateSlideRequest
UpdateSlidesPositionRequest
DuplicateObjectRequest
UpdatePagePropertiesRequest
DeleteObjectRequest
Cómo trabajar con elementos de página: CreateShapeRequest
CreateLineRequest
UpdatePageElementTransformRequest
UpdateShapePropertiesRequest
DuplicateObjectRequest
DeleteObjectRequest
Cómo trabajar con tablas: CreateTableRequest
InsertTableRowsRequest
InsertTableColumnsRequest
DeleteTableRowRequest
DeleteTableColumnRequest
UpdateTableRowPropertiesRequest
UpdateTableColumnPropertiesRequest
UpdateTableBorderPropertiesRequest
UpdateTableCellPropertiesRequest
MergeTableCellsRequest
UnmergeTableCellsRequest
DeleteObjectRequest
Trabajar con gráficos: CreateSheetsChartRequest
RefreshSheetsChartRequest
ReplaceAllShapesWithSheetsChartRequest
DeleteObjectRequest
Cómo trabajar con imágenes y video: 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 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().