Regole e comportamento di modifica strutturale

Questa sezione descrive i comportamenti e le 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 documents.batchUpdate per verificare la presenza di vincoli e regole che si applicano a queste richieste.

Le sezioni seguenti riepilogano le regole principali di questi metodi.

Inserisci testo

  • L'inserimento di un carattere di nuova riga crea implicitamente un carattere Paragraph in quell'indice. Lo stile del paragrafo del nuovo paragrafo viene copiato dal paragrafo nell'indice di inserzione corrente, inclusi elenchi e elenchi puntati.
  • Il testo deve essere inserito nei limiti di un Paragraph esistente. Ad esempio, non è possibile inserire del testo nell'indice iniziale di una tabella. Il testo deve essere inserito nel paragrafo precedente.
  • L'API potrebbe modificare implicitamente la posizione per impedire le inserzioni 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 di 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 caratteri dell'area di uso privato del piano multilingue di base Unicode (U+E000-U+F8FF) vengono rimossi dal testo inserito.
  • Per ulteriori informazioni, consulta Inserire, eliminare e spostare il testo.

Inserire immagini in linea

  • L'immagine deve avere dimensioni inferiori a 50 MB, non deve superare i 25 megapixel e deve essere in uno dei formati PNG, JPEG o GIF.
  • L'URI fornito deve essere accessibile pubblicamente e avere una lunghezza massima di 2 KB.
  • L'immagine deve essere inserita nei limiti di un Paragraph esistente. Ad esempio, non è possibile inserire del testo nell'indice iniziale di una tabella.
  • Le immagini non possono essere inserite in una nota a piè di pagina o in 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 tutti i paragrafi parzialmente o completamente sovrapposti dall'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 di testo corrispondente.
  • Per ulteriori informazioni, consulta Formattare il testo.

Creare elenchi puntati di 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.
  • Le tabulazioni iniziali vengono rimosse durante la creazione degli elenchi puntati, il che potrebbe modificare gli indici di alcune parti del testo.
  • Se aggiungi elenchi puntati 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 agli stili di paragrafo, agli elenchi, agli oggetti posizionati e ai segnalibri durante l'unione dei due paragrafi.

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

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

    • Eliminazione dell'ultimo carattere di a capo 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 a capo prima di Table, TableOfContents o SectionBreak senza eliminare l'elemento.

    • Eliminazione di singole righe o celle di una tabella. L'eliminazione dei contenuti in una cella della tabella è consentita.

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