Regole e comportamento di modifica strutturale

Questa sezione descrive comportamenti e limitazioni che devi conoscere 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 di documents.batchUpdate per verificare la presenza di vincoli e 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 un elemento Paragraph in corrispondenza dell'indice. Lo stile di paragrafo del nuovo paragrafo viene copiato dal paragrafo nell'indice di inserimento corrente, inclusi elenchi e punti elenco.
  • Il testo deve essere inserito entro i limiti di un valore 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 può modificare in modo implicito la posizione per impedire posizionamenti all'interno di cluster Unicode grafeme. In questi casi, il testo viene inserito immediatamente dopo il cluster di grafeme.
  • Gli stili di testo per il testo inserito vengono determinati automaticamente, in genere mantenendo lo stile del testo adiacente. In genere, lo stile di testo per il testo inserito corrisponde al testo immediatamente prima dell'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 Unicode Basic (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 un 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 nell'indice iniziale di una tabella.
  • Le immagini non possono essere inserite in una nota a piè di pagina o un'equazione.
  • Per ulteriori informazioni, consulta Inserire immagini in linea.

Modificare la formattazione del testo

  • Quando applichi la formattazione a livello di paragrafo a un intervallo, questa viene applicata a qualsiasi paragrafo che è parzialmente o completamente sovrapposto all'intervallo.
  • L'intervallo può essere esteso per includere nuove righe adiacenti.
  • Se l'intervallo contiene per intero 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 punti elenco di paragrafo

  • Crea punti elenco 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 elenco di paragrafo che corrispondono a quelli di un elenco subito 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 supera il limite di un paragrafo potrebbe causare modifiche agli stili di paragrafo, agli elenchi, agli oggetti posizionati e ai preferiti 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 Body, Header, Footer, Footnote, TableCell o TableOfContents.

    • Eliminazione dell'inizio o della fine di un'istanza Table, TableOfContents o Equation senza eliminare l'intero elemento.

    • Eliminazione del 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 il contenuto di una cella di una tabella.

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