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 Google Docs.

En general, no puedes ejecutar ediciones que provoquen 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 implícitamente 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.
  • Es posible que la API ajuste la ubicación de forma implícita para evitar inserciones dentro de clústeres de grafemas Unicode. Cuando esto sucede, el texto se inserta inmediatamente después del clúster de grafemas.
  • Los estilos de texto para el texto insertado se determinan automáticamente y, por lo general, conservan el estilo del texto adyacente. 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 caracteres 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.

Cómo insertar imágenes intercaladas

  • La imagen debe pesar menos de 50 MB, no puede superar los 25 megapíxeles y debe estar en uno de los formatos 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.
  • Las imágenes no se pueden insertar 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 se superponga de forma parcial o completa con ese rango.
  • El rango se puede extender 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.

Cómo crear viñetas de párrafo

  • Crea viñetas para todos los párrafos que se superponen con el rango determinado.
  • La cantidad de tabulaciones iniciales antes de cada párrafo determina el nivel de anidación de cada párrafo.
  • Las tabulaciones 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 inmediatamente antes del párrafo de destino, el párrafo se unirá a la lista.
  • Para obtener más información, consulta Trabaja 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 marcadores, ya que los dos párrafos se combinan.

  • No se permiten los borrados que provoquen una estructura de documento no válida. Estos son algunos ejemplos de solicitudes de eliminación no válidas:

    • Borrar una unidad de código de un par sustituto

    • Borra el último carácter de nueva 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

    • Borra el carácter de nueva línea antes de un Table, TableOfContents o SectionBreak sin borrar el elemento.

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

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