Panoramica dell'API Google Docs

L'API Google Docs ti consente di creare e modificare documenti in Documenti Google.

Le applicazioni possono integrarsi con l'API Documenti per creare documenti raffinati a partire dai dati forniti dall'utente e dal sistema. L'API Docs ti consente di:

  • Automatizzare i processi
  • Creare documentazione in blocco
  • Formattare i documenti
  • Generare fatture o contratti
  • Recuperare attributi specifici degli oggetti

Di seguito è riportato un elenco di termini comuni utilizzati nell'API Docs:

ID documento

L'identificatore univoco di un documento. Si tratta di una stringa particolare contenente lettere, numeri e alcuni caratteri speciali che fanno riferimento a un documento e può essere derivata dall'URL del documento. Gli ID documento sono stabili, anche se il nome del documento cambia. Per saperne di più su come trovare l'ID, consulta ID documento.

https://docs.google.com/document/d/DOCUMENT_ID/edit
Elemento

La struttura che compone un documento. Gli elementi di primo livello di un documento includono Body, DocumentStyle e List.

Documento Google Workspace

Un file creato da un'applicazione Google Workspace, come Documenti Google. Il formato del tipo MIME per Documenti è application/vnd.google-apps.document. Per un elenco dei tipi MIME, vedi Tipi MIME supportati per Google Workspace e Google Drive.

Indice

La maggior parte degli elementi all'interno del corpo del contenuto ha le proprietà startIndex e endIndex. Indicano l'offset dell'inizio e della fine di un elemento, rispetto all'inizio del segmento che lo contiene.

Immagine in linea

Un'immagine che appare nel flusso di testo all'interno di un documento. Non è un allegato.

Intervallo denominato

Un intervallo contiguo di testo. Un NamedRange è una raccolta di intervalli con lo stesso namedRangeId. Gli intervalli denominati consentono agli sviluppatori di associare parti di un documento a un'etichetta arbitraria definita dall'utente in modo che i relativi contenuti possano essere letti o modificati in modo programmatico in un secondo momento. Un documento può contenere più intervalli denominati con lo stesso nome, ma ogni intervallo denominato ha un ID univoco.

Segmento

Body, Header, Footer o Footnote contenente elementi strutturali o di contenuti. Gli indici degli elementi all'interno di un segmento sono relativi all'inizio del segmento.

Suggerimento

Modifiche a un documento senza modificare il testo originale. Se il proprietario approva i tuoi suggerimenti, il testo originale verrà sostituito.

  • Per informazioni sullo sviluppo con le API Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta Sviluppare su Google Workspace.

  • Per una panoramica concettuale di un documento, consulta Documento.

  • Per scoprire come configurare ed eseguire un'app API Google Docs, prova la guida rapida JavaScript.