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 generen una estructura no válida de los elementos dentro de un documento. Revisa cada método de solicitud documents.batchUpdate en busca de restricciones y reglas que se apliquen 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 los viñetas.
  • El texto se debe insertar 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 se debe insertar en el párrafo anterior.
  • La API puede ajustar la ubicación de forma implícita para evitar inserciones dentro de los 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, preservan 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 tener un tamaño inferior a 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 se debe insertar 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 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 el formato a nivel de párrafo a un rango, el formato se aplica a cualquier párrafo que ese rango superponga de forma parcial o total.
  • El rango puede extenderse 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.
  • Para obtener más información, consulta Cómo dar formato al texto.

Crea viñetas de párrafo

  • Crea viñetas para todos los párrafos que se superponen con el rango determinado.
  • El nivel de anidación de cada párrafo se determina por la cantidad de tabulaciones iniciales antes de cada párrafo.
  • Las tabulaciones iniciales se quitan cuando se crean las viñetas, lo que podría cambiar los índices de partes del texto.
  • Si agregas viñetas de párrafo que coinciden con las de una lista inmediatamente antes del párrafo objetivo, este se une a la lista.
  • Para obtener más información, consulta Cómo trabajar con listas.

Borrar texto

  • Si borras texto que cruza el límite de un párrafo, es posible que se produzcan cambios en los estilos de párrafo, las listas, los objetos posicionados y los marcadores a medida que se combinan los dos párrafos.

  • No se permiten las eliminaciones que causen 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 subrogado

    • Borrar el último carácter de línea nueva de un Body, Header, Footer, Footnote, TableCell o TableOfContents

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

    • Borrar el carácter de línea nueva 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.