Regras e comportamento de edição estrutural

Esta seção descreve os comportamentos e as limitações que você precisa entender ao editar documentos usando a API Google Docs.

Em geral, não é possível executar edições que causem a estrutura inválida de elementos em um documento. Revise cada método de solicitação documents.batchUpdate para restrições e regras aplicáveis a essas solicitações.

As seções a seguir resumem as principais regras desses métodos.

Inserir texto

  • Inserir um caractere de nova linha cria implicitamente um Paragraph nesse índice. O estilo do novo parágrafo é copiado do parágrafo no índice de inserção atual, incluindo listas e marcadores.
  • O texto precisa ser inserido dentro dos limites de um Paragraph. Por exemplo, não é possível inserir texto no índice inicial de uma tabela. O texto precisa ser inserido no parágrafo anterior.
  • A API pode ajustar implicitamente o local para evitar inserções em clusters de grafemas Unicode. Quando isso acontece, o texto é inserido imediatamente após o cluster de grafemas.
  • Os estilos de texto inserido são determinados automaticamente, geralmente preservando o estilo do texto vizinho. Normalmente, o estilo do texto inserido corresponde ao texto imediatamente antes do índice de inserção.
  • Alguns caracteres de controle (U+0000-U+0008, U+000C-U+001F) e caracteres da área de uso privado do Plano Multilíngue Básico do Unicode (U+E000-U+F8FF) são removidos do texto inserido.
  • Para mais informações, consulte Inserir, excluir e mover texto.

Inserir imagens inline

  • A imagem precisa ter menos de 50 MB, não pode exceder 25 megapixels e precisa estar em um dos formatos PNG, JPEG ou GIF.
  • O URI fornecido precisa ser acessível publicamente e ter no máximo 2 KB de comprimento.
  • A imagem precisa ser inserida nos limites de um Paragraph existente. Por exemplo, não é possível inserir texto no índice inicial de uma tabela.
  • Não é possível inserir imagens dentro de uma nota de rodapé ou equação.
  • Para mais informações, consulte Inserir imagens inline.

Formatar texto

  • Quando você aplica a formatação no nível do parágrafo a um intervalo, ela é aplicada a qualquer parágrafo que seja parcial ou totalmente sobreposto por esse intervalo.
  • O intervalo pode ser estendido para incluir novas linhas adjacentes.
  • Se o intervalo contiver totalmente um parágrafo pertencente a uma lista, o marcador do parágrafo também será atualizado com o estilo de texto correspondente.
  • Para mais informações, consulte Formatar texto.

Criar marcadores de parágrafo

  • Cria marcadores para todos os parágrafos que se sobrepõem ao intervalo especificado.
  • O nível de aninhamento de cada parágrafo é determinado pelo número de tabulações à esquerda antes de cada um.
  • As tabulações iniciais são removidas ao criar os marcadores, o que pode mudar os índices de partes do texto.
  • Se você adicionar marcadores de parágrafo que correspondam aos de uma lista imediatamente antes do parágrafo de destino, o parágrafo será unido à lista.
  • Para mais informações, consulte Trabalhar com listas.

Excluir texto

  • Excluir texto que cruza o limite de um parágrafo pode causar mudanças nos estilos de parágrafo, listas, objetos posicionados e favoritos, já que os dois parágrafos são mesclados.

  • Não são permitidas exclusões que causem uma estrutura de documento inválida. Alguns exemplos de solicitações de exclusão inválidas incluem:

    • Excluir uma unidade de código de um par substituto.

    • Excluir o último caractere de nova linha de um Body, Header, Footer, Footnote, TableCell ou TableOfContents.

    • Excluir o início ou o fim de um Table, TableOfContents ou Equation sem excluir o elemento inteiro.

    • Excluir o caractere de nova linha antes de um Table, TableOfContents ou SectionBreak sem excluir o elemento.

    • Excluir linhas ou células individuais de uma tabela. É permitido excluir o conteúdo de uma célula de tabela.

  • Para mais informações, consulte Inserir, excluir e mover texto.