Regole e comportamento di modifica strutturale

Questa sezione descrive i comportamenti e le limitazioni che devi comprendere quando modifichi i documenti utilizzando l'API Documenti Google.

In generale, non puoi eseguire modifiche che causano la struttura non valida degli elementi all'interno di un documento. Esamina ogni documents.batchUpdate metodo di richiesta per i vincoli e le regole che si applicano a queste richieste.

Le sezioni seguenti riepilogano le regole chiave di questi metodi.

Inserisci testo

  • L'inserimento di un carattere di nuova riga crea implicitamente un Paragraph a 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 nell'indice iniziale di una tabella. Il testo deve essere inserito nel paragrafo precedente.
  • L'API potrebbe modificare implicitamente la posizione per impedire gli inserimenti all'interno dei 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 per il testo inserito corrisponde al testo immediatamente precedente all'indice di inserimento.
  • Alcuni caratteri di controllo (U+0000-U+0008, U+000C-U+001F) e i 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 testo.

Inserisci immagini in linea

  • Le dimensioni dell'immagine devono essere inferiori a 50 MB, non possono superare i 25 megapixel e devono essere in formato PNG, JPEG o GIF.
  • L'URI fornito deve essere accessibile pubblicamente e avere una lunghezza massima di 2 KB.
  • L'immagine deve essere inserita entro i limiti di un Paragraph esistente. Ad esempio, il testo non può essere inserito nell'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 saperne di più, consulta Inserire immagini in linea.

Modificare la formattazione del testo

  • Quando applichi la formattazione a livello di paragrafo a un intervallo, la formattazione viene applicata a qualsiasi paragrafo sovrapposto parzialmente o completamente a quell'intervallo.
  • L'intervallo potrebbe essere esteso per includere le nuove righe adiacenti.
  • Se l'intervallo contiene completamente un paragrafo appartenente a un elenco, anche il punto elenco del paragrafo viene aggiornato con lo stile del testo corrispondente.
  • Per saperne di più, consulta Modificare la formattazione del testo.

Crea punti elenco per i paragrafi

  • Crea punti elenco 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.
  • Le tabulazioni iniziali vengono rimosse durante la creazione dei punti elenco, il che potrebbe modificare gli indici delle parti del testo.
  • Se aggiungi punti elenco per i paragrafi che corrispondono a quelli di un elenco immediatamente precedente al paragrafo di destinazione, il paragrafo viene unito all'elenco.
  • Per saperne di più, consulta Utilizzare gli elenchi.

Elimina testo

  • L'eliminazione di testo che attraversa un limite di paragrafo potrebbe causare modifiche agli stili dei paragrafi, agli elenchi, agli oggetti posizionati e ai segnalibri quando i due paragrafi vengono uniti.

  • Non sono consentite eliminazioni che causano una struttura del documento non valida. Ecco alcuni esempi di richieste di eliminazione non valide:

    • Eliminazione di un'unità di codice di una coppia di surrogati.

    • 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.

    • Eliminazione del carattere di nuova riga prima di un Table, TableOfContents, o SectionBreak senza eliminare l'elemento.

    • Eliminazione di singole righe o celle di una tabella. È consentito eliminare i contenuti di una cella della tabella.

  • Per saperne di più, consulta Inserire, eliminare e spostare testo.