Regole e comportamento di modifica strutturale

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 corrispondenza di 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 saperne di più, 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 qualsiasi paragrafo parzialmente o completamente sovrapposto a questo 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 saperne di più, consulta Utilizzare gli elenchi.

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