Regole e comportamento di modifica strutturale

Questa sezione descrive i comportamenti e le limitazioni che è necessario comprendere quando modifichi i documenti utilizzando l'API Google Documenti.

In generale, non puoi eseguire modifiche che causano la struttura non valida di elementi all'interno di un documento. Rivedi ogni documents.batchUpdate per i vincoli e le regole che si applicano 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 quel momento 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 elemento Paragraph esistente. Per Ad esempio, il testo non può essere inserito all'indice iniziale di una tabella. Il testo deve essere inserita nel paragrafo precedente.
  • L'API può modificare implicitamente la località per impedire inserimenti all'interno di Cluster di grafema Unicode. In questo caso, il testo viene inserito subito dopo l'ammasso grafeme.
  • Gli stili del testo per il testo inserito vengono determinati automaticamente, in genere mantenendo lo stile del testo circostante. In genere, lo stile del testo il testo inserito corrisponde a quello immediatamente prima dell'indice di inserimento.
  • Alcuni caratteri di controllo (U+0000-U+0008, U+000C-U+001F) e caratteri da l'area a uso privato del piano multilingue di base Unicode (U+E000-U+F8FF) rimosso 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 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. Per 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 un paragrafo che è parzialmente o completamente sovrapposto intervallo.
  • L'intervallo potrebbe essere esteso per includere nuove righe adiacenti.
  • Se l'intervallo contiene interamente un paragrafo appartenente a un elenco, lo stato il punto elenco 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 tabulazioni prima di ogni paragrafo.
  • Le schede iniziali vengono rimosse durante la creazione dei punti elenco, che potrebbero cambiare gli indici di parti del testo.
  • Se aggiungi punti di elenco che corrispondono a quelli di un elenco subito prima paragrafo di destinazione, il paragrafo viene aggiunto all'elenco.
  • Per ulteriori informazioni, vedi Utilizzare gli elenchi.

Eliminare il testo

  • L'eliminazione di testo che supera il limite di un paragrafo può causare modifiche stili di paragrafo, elenchi, oggetti posizionati e segnalibri come paragrafi vengono uniti.

  • Non sono consentite eliminazioni che causano una struttura di documenti non valida. Alcune esempi di richieste di eliminazione non valide includono:

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

    • L'eliminazione dell'ultimo carattere di nuova riga di un Body, Header, Footer, Footnote, TableCell oppure TableOfContents.

    • L'eliminazione dell'inizio o della fine di un Table, TableOfContents, oppure Equation senza eliminando l'intero elemento.

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

    • Eliminazione di singole righe o celle di una tabella. Eliminazione dei contenuti in una cella della tabella.

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