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 metodo di richiesta documents.batchUpdate per individuare i vincoli e le regole che si applicano a queste richieste.

Le seguenti sezioni riepilogano le regole chiave di questi metodi.

Inserisci testo

  • L'inserimento di un carattere di nuova riga crea implicitamente una Paragraph in quell'indice. Lo stile del paragrafo del nuovo paragrafo viene copiato da quello nell'indice di inserimento corrente, inclusi elenchi e punti elenco.
  • Il testo deve essere inserito entro i limiti di un elemento 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 può modificare in modo implicito la località per impedire inserimenti all'interno dei cluster di grafema Unicode. In questo caso, il testo viene inserito immediatamente dopo il cluster di grafeme.
  • Gli stili del testo inserito vengono determinati automaticamente, mantenendo in genere lo stile del testo vicino. In genere, lo stile del testo inserito corrisponde a quello immediatamente prima dell'indice di inserimento.
  • Alcuni caratteri di controllo (U+0000-U+0008, U+000C-U+001F) e dell'area di utilizzo privato del piano multilingue di base Unicode (U+E000-U+F8FF) vengono rimossi dal testo inserito.
  • Per ulteriori informazioni, consulta Inserire, eliminare e spostare testo.

Inserisci immagini in linea

  • L'immagine deve avere dimensioni inferiori a 50 MB, non può superare i 25 megapixel e deve 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 elemento 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 in linea.

Modificare la formattazione del testo

  • Quando applichi la formattazione a livello di paragrafo a un intervallo, la formattazione viene applicata a ogni paragrafo che è parzialmente o completamente sovrapposto da quell'intervallo.
  • L'intervallo potrebbe essere esteso per includere nuove righe adiacenti.
  • Se l'intervallo contiene interamente un paragrafo appartenente a un elenco, anche il punto elenco del paragrafo viene aggiornato con lo stile di testo corrispondente.
  • Per ulteriori informazioni, vedi Formattare il testo.

Creare elenchi puntati di paragrafo

  • Crea elenchi puntati per tutti i paragrafi che si sovrappongono all'intervallo specificato.
  • Il livello di nidificazione di ogni paragrafo è determinato dal numero di schede iniziali prima di ogni paragrafo.
  • Le schede iniziali vengono rimosse durante la creazione dei punti elenco, il che potrebbe modificare gli indici di parti del testo.
  • Se aggiungi punti di elenco che corrispondono a quelli di un elenco immediatamente prima del paragrafo di destinazione, il paragrafo viene aggiunto all'elenco.
  • Per ulteriori informazioni, vedi Utilizzare gli elenchi.

Eliminare il testo

  • L'eliminazione di un testo che supera il limite di un paragrafo potrebbe causare modifiche agli stili del paragrafo, agli elenchi, agli oggetti posizionati e ai preferiti man mano che i due paragrafi vengono uniti.

  • Non sono consentite eliminazioni che causano una struttura di documenti 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 della nuova riga di Body, Header, Footer, Footnote, TableCell o TableOfContents.

    • Eliminando l'inizio o la fine di una Table, TableOfContents o Equation senza eliminare l'intero elemento.

    • Eliminando il carattere di nuova riga prima di Table, TableOfContents o SectionBreak senza eliminare l'elemento.

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

  • Per ulteriori informazioni, consulta Inserire, eliminare e spostare testo.