Operações de tabela

A API Google Slides permite criar e editar tabelas em páginas. Os exemplos em esta página mostram algumas operações de tabela comuns usando a presentations.batchUpdate .

Esses exemplos usam as seguintes variáveis:

  • PRESENTATION_ID: indica onde você fornece apresentação ID. Você pode descobrir o valor desse ID no URL da apresentação.
  • PAGE_ID: indica onde você fornece o objeto de página IDs. Você pode recuperar o valor dele no URL ou usando uma solicitação de leitura da API.
  • TABLE_ID: indica onde você fornece a página ID de objeto do elemento para um tabela com a qual está trabalhando. É possível especificar esse ID para os elementos criados (com alguns restrições). ou permitir que a Slides API crie um automaticamente. IDs de elementos podem ser recuperados por meio de uma solicitação de leitura da API.

Esses exemplos são apresentados como solicitações HTTP para serem neutros em relação à linguagem. Para saber como implementar uma atualização em lote em idiomas diferentes usando a API do Google bibliotecas de clientes, consulte Adicionar formas e ou texto.

Criar uma tabela

O seguinte presentations.batchUpdate um exemplo de código mostra como usar a CreateTableRequest para adicionar uma tabela a um slide especificado por PAGE_ID.

Essa tabela tem oito linhas e cinco colunas. A API Slides ignora os campos size ou transform fornecidos como parte da elementProperties. Em vez disso, a API cria uma tabela que está aproximadamente centralizada no slide e é dimensionada para acomodar o número especificado de linhas e colunas, se possível.

Confira a seguir o protocolo de solicitação para criar uma tabela:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "createTable": {
        "objectId": TABLE_ID,
        "elementProperties": {
          "pageObjectId": PAGE_ID,
        },
        "rows": 8,
        "columns": 5
      }
    }
  ]
}

Excluir linhas ou colunas da tabela

O seguinte presentations.batchUpdate um exemplo de código mostra como usar a DeleteTableRowRequest para remover a sexta linha. Em seguida, ele usa o DeleteTableColumnRequest para remover a quarta coluna. A tabela é especificada pela TABLE_ID: Tanto o rowIndex quanto o columnIndex em cellLocation são baseados em zero.

Confira a seguir o protocolo de solicitação para excluir linhas ou colunas da tabela:

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 dados da tabela

O seguinte presentations.batchUpdate um exemplo de código mostra como usar a DeleteTextRequest para remover todo o texto de uma célula dentro da textRange. Ela usa o InsertTextRequest para substituí-lo pelo novo texto de "Kangaroo".

A tabela é especificada pelo TABLE_ID. A célula afetada está em a quinta linha e a terceira coluna. Tanto o rowIndex quanto o columnIndex em cellLocation são baseados em zero.

Confira a seguir o protocolo da solicitação para editar dados da tabela:

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

Formatar uma linha de cabeçalho de tabela

O seguinte presentations.batchUpdate um exemplo de código mostra como usar a UpdateTableCellPropertiesRequest para formatar a linha de cabeçalho de um elemento de tabela, no tableRange, especificado pelo TABLE_ID. Em seguida, ele usa o TableCellProperties para definir a cor de fundo da linha do cabeçalho como preto.

Cada solicitação a seguir usa o UpdateTextStyleRequest para definir o formato de texto em uma célula da linha do cabeçalho como negrito, branco de 18 pt Fonte Cambria no textRange Você precisará repetir essa solicitação para cada célula adicional no cabeçalho.

Tanto o rowIndex quanto o columnIndex nos location e cellLocation são baseados em zero.

Veja a seguir o protocolo de solicitação para formatar uma linha de cabeçalho de tabela:

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

Veja como ficará a linha de cabeçalho formatada depois dessas atualizações:

Resultado do roteiro da linha de cabeçalho "Formatar".

Inserir linhas ou colunas da tabela

O seguinte presentations.batchUpdate um exemplo de código mostra como usar a InsertTableRowsRequest para adicionar três linhas abaixo da sexta linha. Em seguida, ele usa o InsertTableColumnsRequest para adicionar duas colunas à esquerda da quarta coluna na mesma tabela.

A tabela é especificada pelo TABLE_ID. Tanto o rowIndex quanto os columnIndex no cellLocation são baseados em zero.

Confira a seguir o protocolo de solicitação para inserir linhas ou colunas da tabela:

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