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