Regras e comportamento de edição estrutural

Esta seção descreve comportamentos e 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 dentro de um documento. Revise cada uma documents.batchUpdate para restrições e regras que se aplicam 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 uma Paragraph nisso índice. O estilo de parágrafo do novo parágrafo é copiado do parágrafo no índice de inserção atual, incluindo listas e marcadores.
  • O texto precisa ser inserido nos limites de um Paragraph atual. Para exemplo, o texto não pode ser inserido no índice inicial de uma tabela. O texto deve ser no parágrafo anterior.
  • A API pode ajustar implicitamente a localização para impedir inserções dentro Clusters de grafema Unicode. Quando isso acontece, o texto é inserido logo após o cluster de grafema.
  • Estilos de texto para o texto inserido são determinados automaticamente, geralmente o estilo do texto ao redor. Normalmente, o estilo de texto o 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 de a Área de uso particular de plano multilíngue Unicode Basic (U+E000-U+F8FF) está retirado do texto inserido.
  • Veja mais informações em Inserir, excluir e mover ou texto.

Inserir imagens inline

  • A imagem precisa ter menos de 50 MB, não pode exceder 25 megapixels e estar em um dos formatos PNG, JPEG ou GIF.
  • O URI fornecido precisa estar acessível publicamente e ter no máximo 2 KB.
  • A imagem precisa ser inserida nos limites de um Paragraph atual. Para exemplo, o texto não pode ser inserido 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 de nível de parágrafo a um intervalo, a formatação é aplicada a qualquer parágrafo parcialmente ou completamente sobreposto por do intervalo 10.240.0.0/16.
  • O intervalo pode ser estendido para incluir novas linhas adjacentes.
  • Se o intervalo contiver completamente um parágrafo pertencente a uma lista, a propriedade marcador também é 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 guias antes de cada parágrafo.
  • As guias iniciais são removidas durante a criação dos marcadores, que podem mudar os índices de partes do texto.
  • Se você adicionar marcadores de parágrafo que correspondam aos de uma lista imediatamente antes o parágrafo de destino, ele é unido à lista.
  • Para mais informações, consulte Trabalhar com listas.

Excluir texto

  • Excluir o texto que ultrapassa os limites de um parágrafo pode causar alterações em estilos de parágrafo, listas, objetos posicionados e favoritos como os dois e parágrafos são mesclados.

  • Não é permitido fazer exclusões que causam uma estrutura de documento inválida. Algumas Exemplos de solicitações de exclusão inválidas incluem:

    • Exclusão de uma unidade de código de um par alternativo.

    • Exclusão do ú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 excluindo o elemento inteiro.

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

    • Exclusão de linhas ou células individuais de uma tabela. excluir o conteúdo em uma célula da tabela é permitido.

  • Veja mais informações em Inserir, excluir e mover ou texto.