Comportamiento y reglas de edición estructurales

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 causen la estructura no válida de los elementos en 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 Paragraph en ese índice. El estilo de párrafo del párrafo nuevo 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 un Paragraph existente. 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 de forma implícita la ubicación para evitar inserciones en clústeres de grafema Unicode. Cuando esto sucede, el texto se inserta inmediatamente después del clúster de grafema.
  • Los estilos de texto del texto insertado se determinan automáticamente y, por lo general, conservan el estilo del texto cercano. Por lo general, el estilo de texto del texto insertado coincide con el texto inmediatamente anterior al índice de inserción.
  • Algunos caracteres de control (U+0000-U+0008, U+000C-U+001F) y del área 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 tener una longitud máxima de 2 KB.
  • La imagen debe insertarse dentro de los límites de un Paragraph existente. Por ejemplo, no se puede insertar texto en el índice de inicio de una tabla.
  • No se pueden insertar imágenes en una nota al pie ni en 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 se superponga de forma parcial o total con ese rango.
  • El rango se puede extender para incluir líneas nuevas 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.
  • Si deseas obtener más información, consulta Da formato al texto.

Crear viñetas de párrafo

  • Crea viñetas para todos los párrafos que se superponen con el rango dado.
  • 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 principales se quitan cuando se crean las viñetas, lo que puede 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, el párrafo se unirá a la lista.
  • Para obtener más información, consulta Cómo trabajar con listas.

Borrar texto

  • Borrar texto que cruza el límite de un párrafo puede provocar cambios en los estilos de párrafo, las listas, los objetos posicionados y los favoritos, 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 salto de línea de un Body, Header, Footer, Footnote, TableCell o TableOfContents

    • Borrar el inicio o el final de un Table, TableOfContents o Equation sin borrar todo el elemento.

    • Borrar el carácter de salto de línea antes de un Table, TableOfContents o SectionBreak sin borrar el elemento

    • Borrar filas o celdas individuales de una tabla Se puede borrar el contenido de una celda de una tabla.

  • Para obtener más información, consulta Cómo insertar, borrar y mover texto.