En esta sección, se describen los comportamientos y las limitaciones que debes comprender cuando editas documentos con la API de Documentos de Google.
En general, no puedes ejecutar ediciones que causan la estructura no válida de los elementos dentro de un documento. Revisa cada método de solicitud documents.batchUpdate para conocer las restricciones y reglas que se aplican a esas solicitudes.
En las siguientes secciones, se resumen las reglas clave de estos métodos.
Insertar texto
- Si insertas un carácter de salto de línea, se crea de forma implícita un
Paragraphen ese índice. El estilo de párrafo del nuevo párrafo se copia del párrafo en el índice de inserción actual, incluidas las listas y las viñetas. - El texto debe insertarse dentro de los límites de una
Paragraphexistente. Por ejemplo, no se puede insertar texto en el índice de inicio de una tabla. El texto debe insertarse en el párrafo anterior. - La API puede ajustar la ubicación de forma implícita para evitar inserciones dentro de clústeres de Grapheme Unicode. Cuando esto sucede, el texto se inserta inmediatamente después del clúster de grafema.
- Los estilos de texto para el texto insertado se determinan automáticamente y, por lo general, mantienen el estilo del texto adyacente. Por lo general, el estilo del texto insertado coincide con el texto justo antes del índice de inserción.
- Algunos caracteres de control (
U+0000-U+0008, U+000C-U+001F) y los caracteres del Área privada de uso privado del plano multilingüe básico de Unicode (U+E000-U+F8FF) se quitan del texto insertado. - Para obtener más información, consulta Cómo insertar, borrar y mover texto.
Inserta imágenes
- La imagen debe tener un tamaño inferior a 50 MB, no puede superar los 25 megapíxeles y debe estar en formato PNG, JPEG o GIF.
- El URI proporcionado debe ser de acceso público y debe tener como máximo 2 KB de longitud.
- La imagen debe insertarse dentro de los límites de una
Paragraphexistente. Por ejemplo, no se puede insertar texto en el índice de inicio de una tabla. - No se pueden insertar imágenes dentro de una nota al pie o una ecuación.
- Para obtener más información, consulta Cómo insertar imágenes intercaladas.
Dale formato al texto
- Cuando aplicas formato a nivel de párrafo a un rango, el formato se aplica a cualquier párrafo que ese rango se superponga de forma parcial o total.
- El rango puede extenderse para incluir saltos de línea adyacentes.
- Si el rango contiene por completo un párrafo que pertenece a una lista, la viñeta del párrafo también se actualiza con el estilo de texto coincidente.
- Para obtener más información, consulta Cómo dar formato al texto.
Crear viñetas de párrafo
- Crea viñetas para todos los párrafos que se superponen con el rango especificado.
- El nivel de anidación de cada párrafo se determina por la cantidad de tabulaciones iniciales antes de cada párrafo.
- Las pestañas iniciales se quitan cuando se crean las viñetas, lo que podría cambiar los índices de las partes del texto.
- Si agregas viñetas de párrafo que coincidan con las de una lista justo antes del párrafo de destino, este se unirá a la lista.
- Para obtener más información, consulta Trabaja con listas.
Borrar texto
Borrar el texto que cruza el límite de un párrafo puede provocar cambios en los diseños, las listas, los objetos posicionados y los favoritos del párrafo, ya que se combinan los dos párrafos.
No se permiten las eliminaciones que provocan una estructura de documento no válida. Estos son algunos ejemplos de solicitudes de eliminación no válidas:
Borra una unidad de código de un par subrogado.
Borrar el último carácter de línea nueva de
Body,Header,Footer,Footnote,TableCelloTableOfContentsBorrar el inicio o el final de un
Table,TableOfContentsoEquationsin borrar todo el elementoBorrar el carácter de línea nueva antes de
Table,TableOfContentsoSectionBreaksin borrar el elementoBorrar filas o celdas individuales de una tabla. Puedes borrar el contenido de una celda de la tabla.
Para obtener más información, consulta Cómo insertar, borrar y mover texto.