La API de Presentaciones de Google te permite crear y editar tablas en páginas. Los ejemplos en
en esta página, se muestran algunas operaciones comunes de tablas con el
presentations.batchUpdate
.
En estos ejemplos, se usan las siguientes variables:
- PRESENTATION_ID: Indica dónde proporcionas la presentación correcto. Puedes descubrirá el valor para este ID desde la URL de presentación.
- PAGE_ID: Indica dónde se proporciona el objeto de página. IDs. Puedes recuperar el valor para esto desde la URL o mediante una solicitud de lectura de la API.
- TABLE_ID: Indica dónde proporcionas la página. ID de objeto de elemento de un tabla con la que estás trabajando. Puedes especificar este ID para los elementos que crees (con algunos restricciones de uso) o permitir que la API de Presentaciones cree uno automáticamente. IDs de elementos se puede recuperar a través de una solicitud de lectura de API.
Estos ejemplos se presentan como solicitudes HTTP para que no tengan idioma. Para aprender cómo implementar una actualización por lotes en diferentes idiomas con la API de Google bibliotecas cliente, consulta Cómo agregar formas y texto.
Crea una tabla
Lo siguiente
presentations.batchUpdate
de muestra de código muestra cómo usar el
CreateTableRequest
para agregar una tabla a una diapositiva especificada por el PAGE_ID.
Esta tabla tiene ocho filas y cinco columnas. Ten en cuenta que la API de Presentaciones
ignora todos los campos size o transform proporcionados como parte de la
elementProperties
En cambio, la API crea una tabla que está más centrada en la diapositiva y está
ajustada para adaptarse al número especificado 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
}
}
]
}
Borrar filas o columnas de la tabla
Lo siguiente
presentations.batchUpdate
de muestra de código muestra cómo usar el
DeleteTableRowRequest
para quitar la sexta fila. Luego, usa
DeleteTableColumnRequest
método para quitar la cuarta columna. La tabla se especifica mediante el
TABLE_ID Tanto el rowIndex como el columnIndex dentro de
cellLocation se basan en cero.
A continuación, se muestra el protocolo de solicitud para borrar filas o columnas de la 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
}
}
}
]
}
Editar datos de la tabla
Lo siguiente
presentations.batchUpdate
de muestra de código muestra cómo usar el
DeleteTextRequest
para quitar todo el texto de una celda dentro del
textRange Integra
y, luego, usa
InsertTextRequest
para reemplazarlo por el nuevo texto "Kangaroo".
La tabla se especifica mediante TABLE_ID. La celda afectada se encuentra en
la quinta fila y la tercera columna. Los elementos rowIndex y columnIndex dentro
cellLocation se basan en cero.
El siguiente es 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 la fila de encabezado de una tabla
Lo siguiente
presentations.batchUpdate
de muestra de código muestra cómo usar el
UpdateTableCellPropertiesRequest
para dar formato a la fila de encabezado de un elemento de tabla, dentro del
tableRange,
especificadas por el TABLE_ID. Luego, usa
TableCellProperties
para establecer el color de fondo de la fila de encabezado en negro.
Cada solicitud siguiente usa el
UpdateTextStyleRequest
método para establecer el formato de texto en negrita, blanco de 18-pt en una celda de la fila de encabezado
Cambria en el espacio
textRange Tú
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....
]
}
A continuación, se muestra cómo se ve la fila del encabezado con formato después de estas actualizaciones:
Insertar filas o columnas de la tabla
Lo siguiente
presentations.batchUpdate
de muestra de código muestra cómo usar el
InsertTableRowsRequest
para sumar tres filas debajo de la sexta fila. Luego, usa
InsertTableColumnsRequest
método para agregar dos columnas a la izquierda de la cuarta columna en la misma tabla.
La tabla se especifica mediante TABLE_ID. Tanto rowIndex como
las columnIndex dentro de cellLocation se basan en cero.
A continuación, se muestra el protocolo de solicitud para insertar filas o columnas en 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
}
}
]
}