Comportamiento y reglas de edición estructurales

En esta sección, se describen comportamientos y limitaciones que debes comprender cuando editar documentos con la API de Documentos de Google.

En general, no puedes ejecutar ediciones que causen la estructura no válida de elementos dentro de un documento. Revisar cada documents.batchUpdate método de solicitud para 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

  • Cuando se inserta un carácter de línea nueva, se crea de forma implícita un Paragraph en ese rango índice. El estilo de párrafo del nuevo párrafo se copia del párrafo. en el índice de inserción actual, incluidas listas y viñetas.
  • El texto debe insertarse dentro de los límites de un Paragraph existente. Para ejemplo, no se puede insertar texto en el índice de inicio de una tabla. El texto debe tener insertado en el párrafo anterior.
  • La API puede ajustar implícitamente la ubicación para evitar inserciones dentro Clústeres de grafemo Unicode. Cuando esto sucede, el texto se inserta inmediatamente después del cúmulo del grafema.
  • Los estilos de texto del texto insertado se determinan automáticamente; en general, y preservar el estilo del texto cercano. Por lo general, el estilo de texto de El 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 de el Área de uso privado del plano multilingüe básico de Unicode (U+E000-U+F8FF) son sin el 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 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. Para 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 a cualquier párrafo que se superponga, ya sea de forma parcial o total, del rango de destino de la ruta.
  • 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, el espacio la viñeta 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 está determinado por la cantidad de entradas tabulaciones antes de cada párrafo.
  • Las pestañas principales se quitan cuando se crean las viñetas, lo que puede cambiar los índices de partes del texto.
  • Si agregas viñetas de párrafo que coincidan con las de una lista inmediatamente antes el párrafo de destino, 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 estilos de párrafo, listas, objetos posicionados y marcadores como los dos se fusionan los párrafos.

  • No se permiten las eliminaciones que provocan una estructura de documento no válida. Algunos Algunos ejemplos de solicitudes de eliminación no válidas incluyen los siguientes:

    • Borra una unidad de código de un par subrogado.

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

    • Eliminar el inicio o el final de una Table, TableOfContents o Equation sin eliminando todo el elemento.

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

    • Borrar filas o celdas individuales de una tabla Borra el contenido en una celda de la tabla.

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