Operaciones con tablas

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.

Crear 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
      }
    }
  ]
}

Cómo 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. Tanto el rowIndex como el 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:

Resultado de la receta para dar formato a la fila de encabezado.

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
      }
    }
  ]
}