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
eList
.- 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
eendIndex
. 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 stessonamedRangeId
. 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
oFootnote
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.
Argomenti correlati
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.