Panoramica dell'API Google Docs

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

Le applicazioni possono integrarsi con l'API Documenti per creare documenti perfezionati sia con i dati degli utenti che con quelli forniti dal sistema. L'API Documenti ti consente di:

  • Automatizzare i processi
  • Crea la documentazione collettivamente
  • Formattare i documenti
  • Generare fatture o contratti
  • Recuperare attributi specifici degli oggetti

Di seguito è riportato un elenco dei termini comuni utilizzati nell'API Documenti:

ID documento

L'identificatore univoco di un documento. È una determinata stringa contenente lettere, numeri e alcuni caratteri speciali che fanno riferimento a un documento e che può essere ricavata dall'URL del documento. Gli ID documento sono stabili anche se il nome del documento cambia. Per maggiori informazioni su come trovare l'ID, consulta la pagina 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 di Google Workspace

Un file creato da un'applicazione di 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 da Google Workspace e Google Drive.

Indice

La maggior parte degli elementi nel corpo dei contenuti hanno le proprietà startIndex e endIndex. Indicano l'offset dell'inizio e della fine di un elemento, rispetto all'inizio del segmento che lo include.

Immagine incorporata

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

Intervallo denominato

Un intervallo di testo contiguo. 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 un secondo momento in modo programmatico. Un documento può contenere più intervalli denominati con lo stesso nome, ma ogni intervallo denominato ha un ID univoco.

Segment

Gli elementi Body, Header, Footer o Footnote con contenuti strutturali o di contenuto. Gli indici degli elementi all'interno di un segmento si riferiscono all'inizio di quel segmento.

Suggerimento

Vengono apportate modifiche a un documento senza modificare il testo originale. Se il proprietario approva i tuoi suggerimenti, questi sostituiscono il testo originale.

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

  • Per avere una panoramica concettuale di un documento, vedi Documento.

  • Per scoprire come configurare ed eseguire un'app con l'API Documenti, prova la guida rapida di JavaScript.