La API de Google Slides te permite crear y editar tablas en las páginas. En los ejemplos de esta página, se muestran algunas operaciones comunes de tablas con el método presentations.batchUpdate.
En estos ejemplos, se usan las siguientes variables:
- PRESENTATION_ID: Indica dónde proporcionas el ID de la presentación. Puedes descubrir el valor de este ID en la URL de la presentación.
- PAGE_ID: Indica dónde proporcionas los IDs de objetos de página. Puedes recuperar el valor de la URL o con una solicitud de lectura de la API.
- TABLE_ID: Indica dónde proporcionas el ID del objeto del elemento de la página para una tabla con la que trabajas. Puedes especificar este ID para los elementos que crees (con algunas restricciones) o permitir que la API de Slides cree uno automáticamente. Los IDs de elementos se pueden recuperar a través de una solicitud de lectura de la API.
Estos ejemplos se presentan como solicitudes HTTP para que sean independientes del idioma. Para obtener información sobre cómo implementar una actualización por lotes en diferentes lenguajes con las bibliotecas cliente de las APIs de Google, consulta Cómo agregar formas y texto.
Crea una tabla
En el siguiente ejemplo de código de presentations.batchUpdate, se muestra cómo usar el método CreateTableRequest para agregar una tabla a una diapositiva especificada por PAGE_ID.
Esta tabla tiene ocho filas y cinco columnas. Ten en cuenta que la API de Slides ignora cualquier campo size o transform que se proporcione como parte de elementProperties.
En cambio, la API crea una tabla que está aproximadamente centrada en la diapositiva y tiene el tamaño adecuado para incluir la cantidad especificada de filas y columnas, si es posible.
El siguiente es el protocolo de solicitud para crear una tabla:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createTable": {
"objectId": TABLE_ID,
"elementProperties": {
"pageObjectId": PAGE_ID,
},
"rows": 8,
"columns": 5
}
}
]
}Cómo borrar filas o columnas de una tabla
En la siguiente muestra de código de presentations.batchUpdate, se muestra cómo usar el método DeleteTableRowRequest para quitar la sexta fila. Luego, usa el método DeleteTableColumnRequest para quitar la cuarta columna. La tabla se especifica con TABLE_ID. Tanto rowIndex como columnIndex dentro de cellLocation se basan en cero.
A continuación, se muestra el protocolo de solicitud para borrar filas o columnas de una tabla:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"deleteTableRow": {
"tableObjectId": TABLE_ID,
"cellLocation": {
"rowIndex": 5
}
}
},
{
"deleteTableColumn": {
"tableObjectId": TABLE_ID,
"cellLocation": {
"columnIndex": 3
}
}
}
]
}Cómo editar datos de tablas
En el siguiente ejemplo de código de presentations.batchUpdate, se muestra cómo usar el método DeleteTextRequest para quitar todo el texto de una celda dentro de textRange. Luego, usa el método InsertTextRequest para reemplazarlo por el texto nuevo "Canguro".
La tabla se especifica con TABLE_ID. La celda afectada se encuentra en la quinta fila y la tercera columna. Tanto rowIndex como columnIndex dentro de cellLocation se basan en cero.
A continuación, se muestra el protocolo de solicitud para editar los datos de la tabla:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteText": { "objectId": TABLE_ID, "cellLocation": { "rowIndex": 4, "columnIndex": 2 }, "textRange": { "type": "ALL", } } }, { "insertText": { "objectId": TABLE_ID, "cellLocation": { "rowIndex": 4, "columnIndex": 2 }, "text": "Kangaroo", "insertionIndex": 0 } } ] }
Cómo dar formato a una fila de encabezado de tabla
En el siguiente ejemplo de código de presentations.batchUpdate, se muestra cómo usar el método UpdateTableCellPropertiesRequest para dar formato a la fila de encabezado de un elemento de tabla, dentro del tableRange, especificado por TABLE_ID. Luego, usa el método TableCellProperties para establecer el color de fondo de la fila del encabezado en negro.
Cada solicitud siguiente usa el método UpdateTextStyleRequest para establecer el formato de texto en negrita, con fuente Cambria blanca de 18 pt en una celda de la fila de encabezado dentro de textRange. Luego, debes repetir esta solicitud para cada celda adicional del encabezado.
Tanto rowIndex como columnIndex dentro de location y cellLocation se basan en cero.
A continuación, se muestra el protocolo de solicitud para dar formato a una fila de encabezado de tabla:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateTableCellProperties": { "objectId": TABLE_ID, "tableRange": { "location": { "rowIndex": 0, "columnIndex": 0 }, "rowSpan": 1, "columnSpan": 3 }, "tableCellProperties": { "tableCellBackgroundFill": { "solidFill": { "color": { "rgbColor": { "red": 0.0, "green": 0.0, "blue": 0.0 } } } } }, "fields": "tableCellBackgroundFill.solidFill.color" } }, { "updateTextStyle": { "objectId": TABLE_ID, "cellLocation": { "rowIndex": 0, "columnIndex": 0 }, "style": { "foregroundColor": { "opaqueColor": { "rgbColor": { "red": 1.0, "green": 1.0, "blue": 1.0 } } }, "bold": true, "fontFamily": "Cambria", "fontSize": { "magnitude": 18, "unit": "PT" } }, "textRange": { "type": "ALL" }, "fields": "foregroundColor,bold,fontFamily,fontSize" } }, // Repeat the above request for each additional cell in the header row.... ] }
Así se ve la fila de encabezado con formato después de estas actualizaciones:
Cómo insertar filas o columnas en una tabla
En el siguiente ejemplo de código de presentations.batchUpdate, se muestra cómo usar el método InsertTableRowsRequest para agregar tres filas debajo de la sexta. Luego, usa el método InsertTableColumnsRequest para agregar dos columnas a la izquierda de la cuarta columna en la misma tabla.
La tabla se especifica con TABLE_ID. Tanto rowIndex como columnIndex dentro de cellLocation se basan en cero.
A continuación, se muestra el protocolo de solicitud para insertar filas o columnas de la tabla:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"insertTableRows": {
"tableObjectId": TABLE_ID,
"cellLocation": {
"rowIndex": 5
},
"insertBelow": true,
"number": 3
}
},
{
"insertTableColumns": {
"tableObjectId": TABLE_ID,
"cellLocation": {
"columnIndex": 3
},
"insertRight": false,
"number": 2
}
}
]
}