Regole e comportamento di modifica strutturale
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa sezione descrive i comportamenti e le limitazioni che devi comprendere quando modifichi i documenti utilizzando l'API Google Docs.
In generale, non puoi eseguire modifiche che causano la struttura non valida degli elementi all'interno di un documento. Esamina ogni metodo di richiesta documents.batchUpdate per i vincoli e le regole che si applicano a queste richieste.
Le sezioni seguenti riepilogano le regole chiave per questi metodi.
Inserisci testo
- L'inserimento di un carattere di nuova riga crea implicitamente un
Paragraph in
quell'indice. Lo stile del paragrafo del nuovo paragrafo viene copiato dal
paragrafo all'indice di inserimento corrente, inclusi elenchi e punti elenco.
- Il testo deve essere inserito entro i limiti di un
Paragraph esistente. Ad esempio, il testo non può essere inserito all'indice iniziale di una tabella. Il testo deve essere
inserito nel paragrafo precedente.
- L'API potrebbe modificare implicitamente la posizione per impedire inserimenti all'interno
di cluster di grafemi Unicode. In questo caso, il testo viene inserito
immediatamente dopo il cluster di grafemi.
- Gli stili di testo per il testo inserito vengono determinati automaticamente, in genere
mantenendo lo stile del testo adiacente. In genere, lo stile del testo
inserito corrisponde a quello del testo immediatamente precedente all'indice di inserimento.
- Alcuni caratteri di controllo (
U+0000-U+0008, U+000C-U+001F) e caratteri dell'area di utilizzo privato del piano multilingue di base Unicode (U+E000-U+F8FF) vengono rimossi dal testo inserito.
- Per saperne di più, consulta Inserire, eliminare e spostare
il testo.
Inserire immagini in linea
- L'immagine deve avere dimensioni inferiori a 50 MB, non può superare i 25 megapixel e deve
essere in uno dei formati PNG, JPEG o GIF.
- L'URI fornito deve essere accessibile pubblicamente e non superare i 2 KB di lunghezza.
- L'immagine deve essere inserita entro i limiti di un
Paragraph esistente. Ad esempio, il testo non può essere inserito all'indice iniziale di una tabella.
- Le immagini non possono essere inserite all'interno di una nota a piè di pagina o di un'equazione.
- Per ulteriori informazioni, vedi Inserire immagini
inline.
Modificare la formattazione del testo
- Quando applichi la formattazione a livello di paragrafo a un intervallo, la formattazione viene
applicata a qualsiasi paragrafo parzialmente o completamente sovrapposto a quell'intervallo.
- L'intervallo potrebbe essere esteso per includere nuove righe adiacenti.
- Se l'intervallo contiene completamente un paragrafo appartenente a un elenco, anche il
relativo punto elenco viene aggiornato con lo stile di testo corrispondente.
- Per saperne di più, consulta Formattare
il testo.
Creare elenchi puntati per i paragrafi
- Crea elenchi puntati per tutti i paragrafi che si sovrappongono all'intervallo specificato.
- Il livello di nidificazione di ogni paragrafo è determinato dal numero di tabulazioni
iniziali prima di ogni paragrafo.
- I rientri vengono rimossi durante la creazione dei punti elenco, il che potrebbe modificare
gli indici di parti del testo.
- Se aggiungi punti elenco di paragrafo che corrispondono a quelli di un elenco immediatamente prima
del paragrafo di destinazione, il paragrafo viene unito all'elenco.
- Per ulteriori informazioni, vedi Utilizzare gli elenchi.
Eliminare il testo
L'eliminazione di testo che attraversa il confine di un paragrafo potrebbe causare modifiche a
stili di paragrafo, elenchi, oggetti posizionati e segnalibri, poiché i due
paragrafi vengono uniti.
Non sono consentite eliminazioni che causano una struttura del documento non valida. Alcuni
esempi di richieste di eliminazione non valide includono:
Eliminazione di un'unità di codice di una coppia surrogata.
Eliminazione dell'ultimo carattere di nuova riga di un
Body,
Header,
Footer,
Footnote,
TableCell o
TableOfContents.
Eliminazione dell'inizio o della fine di un
Table,
TableOfContents o
Equation
senza eliminare l'intero elemento.
Elimina il carattere di nuova riga prima di un Table, TableOfContents o
SectionBreak
senza eliminare l'elemento.
Eliminare singole righe o celle di una tabella. L'eliminazione dei contenuti in una
cella della tabella è consentita.
Per saperne di più, consulta Inserire, eliminare e spostare
il testo.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[],[],null,["# Structural edit rules and behavior\n\nThis section describes behaviors and limitations that you must understand when\nyou edit documents using the Google Docs API.\n\nIn general, you cannot execute edits that cause the invalid structure of\nelements within a document. Review each\n[`documents.batchUpdate`](/workspace/docs/api/reference/rest/v1/documents/batchUpdate)\nrequest method for constraints and rules that apply to those\n[requests](/workspace/docs/api/reference/rest/v1/documents/request).\n\nThe following sections summarize the key rules across these methods.\n\nInsert text\n-----------\n\n- Inserting a newline character implicitly creates a [`Paragraph`](/workspace/docs/api/reference/rest/v1/documents#paragraph) at that index. The paragraph style of the new paragraph is copied from the paragraph at the current insertion index, including lists and bullets.\n- Text must be inserted within the bounds of an existing `Paragraph`. For example, text cannot be inserted at a table's start index. The text must be inserted in the preceding paragraph.\n- The API may implicitly adjust the location to prevent insertions within Unicode grapheme clusters. When this happens, the text is inserted immediately after the grapheme cluster.\n- Text styles for inserted text are determined automatically, generally preserving the styling of neighboring text. Typically, the text style for the inserted text matches the text immediately before the insertion index.\n- Some control characters (`U+0000-U+0008, U+000C-U+001F`) and characters from the Unicode Basic Multilingual Plane Private Use Area (`U+E000-U+F8FF`) are stripped out of inserted text.\n- For more information, see [Insert, delete, and move\n text](/workspace/docs/api/how-tos/move-text).\n\nInsert inline images\n--------------------\n\n- Image must be less than 50 MB in size, cannot exceed 25 megapixels, and must be in one of PNG, JPEG, or GIF formats.\n- The provided URI must be publicly accessible and at most 2 KB in length.\n- Image must be inserted within the bounds of an existing `Paragraph`. For example, text cannot be inserted at a table's start index.\n- Images can't be inserted inside a footnote or equation.\n- For more information, see [Insert inline\n images](/workspace/docs/api/how-tos/images).\n\nFormat text\n-----------\n\n- When you apply paragraph-level formatting to a range, the formatting is applied to any paragraph that's partially or completely overlapped by that range.\n- The range might be extended to include adjacent newlines.\n- If the range fully contains a paragraph belonging to a list, the paragraph's bullet is also updated with the matching text style.\n- For more information, see [Format\n text](/workspace/docs/api/how-tos/format-text).\n\nCreate paragraph bullets\n------------------------\n\n- Creates bullets for all paragraphs that overlap with the given range.\n- The nesting level of each paragraph is determined by the number of leading tabs before each paragraph.\n- The leading tabs are removed when creating the bullets, which might change the indexes of parts of the text.\n- If you add paragraph bullets that match those of a list immediately before the target paragraph, the paragraph is joined to the list.\n- For more information, see [Work with lists](/workspace/docs/api/how-tos/lists).\n\nDelete text\n-----------\n\n- Deleting text that crosses a paragraph boundary might cause changes to\n paragraph styles, lists, positioned objects, and bookmarks as the two\n paragraphs are merged.\n\n- Deletions that cause an invalid document structure are not permitted. Some\n examples of invalid delete requests include:\n\n - Deleting one code unit of a surrogate pair.\n\n - Deleting the last newline character of a\n [`Body`](/workspace/docs/api/reference/rest/v1/documents#body),\n [`Header`](/workspace/docs/api/reference/rest/v1/documents#header),\n [`Footer`](/workspace/docs/api/reference/rest/v1/documents#footer),\n [`Footnote`](/workspace/docs/api/reference/rest/v1/documents#footnote),\n [`TableCell`](/workspace/docs/api/reference/rest/v1/documents#tablecell), or\n [`TableOfContents`](/workspace/docs/api/reference/rest/v1/documents#tableofcontents).\n\n - Deleting the start or end of a\n [`Table`](/workspace/docs/api/reference/rest/v1/documents#table),\n `TableOfContents`, or\n [`Equation`](/workspace/docs/api/reference/rest/v1/documents#equation)\n without deleting the entire element.\n\n - Deleting the newline character before a `Table`, `TableOfContents`, or\n [`SectionBreak`](/workspace/docs/api/reference/rest/v1/documents#sectionbreak)\n without deleting the element.\n\n - Deleting individual rows or cells of a table. Deleting the content in a\n table cell is allowed.\n\n- For more information, see [Insert, delete, and move\n text](/workspace/docs/api/how-tos/move-text).\n\nRelated topics\n--------------\n\n- [Structure of a Google Docs document](/workspace/docs/api/concepts/structure)\n- [Requests and responses](/workspace/docs/api/concepts/request-response)"]]
