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 causam a estrutura inválida de elementos em um documento. Revise cada
método de solicitação documents.batchUpdate
para conferir as 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 um
Paragraph
nesse índice. O estilo do novo parágrafo será copiado do parágrafo do índice de inserção atual, incluindo listas e marcadores. - O texto precisa ser inserido nos limites de um
Paragraph
atual. Por exemplo, o texto não pode ser inserido no índice inicial de uma tabela. O texto precisa ser inserido no parágrafo anterior. - A API pode ajustar implicitamente o local para impedir inserções em clusters de grafema Unicode. Quando isso acontece, o texto é inserido imediatamente após o cluster de grafema.
- Os estilos do 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 da Área de uso particular do plano multilíngue Unicode Basic (U+E000-U+F8FF
) são retirados 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 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. Por 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 no nível do parágrafo a um intervalo, ela é aplicada a qualquer parágrafo parcialmente ou completamente 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 guias antes de cada parágrafo.
- As guias iniciais são removidas ao criar os marcadores, o que pode alterar 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
A exclusão de texto que ultrapassa um limite de parágrafo pode causar mudanças em estilos de parágrafo, listas, objetos posicionados e favoritos à medida que os dois parágrafos são mesclados.
Não é permitido fazer exclusões que causam uma estrutura de documento inválida. Alguns exemplos de solicitações de exclusão inválidas incluem:
Exclusão de uma unidade de código de um par alternativo.
Excluir o último caractere de nova linha de
Body
,Header
,Footer
,Footnote
,TableCell
ouTableOfContents
.Excluir o início ou o fim de uma
Table
,TableOfContents
ouEquation
sem excluir o elemento inteiro.Excluir o caractere de nova linha antes de
Table
,TableOfContents
ouSectionBreak
sem excluir o elemento.Exclusão de linhas ou células individuais de uma tabela. É permitido excluir o conteúdo de uma célula da tabela.
Para mais informações, consulte Inserir, excluir e mover texto.