L'API Documenti Google consente di creare e modificare documenti in Documenti Google.
Le applicazioni possono integrarsi con l'API Docs per creare documenti raffinati a partire dai dati forniti dall'utente e dal sistema. L'API Docs ti consente di:
- Automatizza i processi
- Crea documentazione in blocco
- Formattare i documenti
- Generare fatture o contratti
- Recuperare attributi specifici degli oggetti
Di seguito è riportato un elenco dei termini comuni utilizzati nell'API Docs:
- ID documento
L'identificatore univoco di un documento. È una stringa particolare che contiene lettere, numeri e alcuni caratteri speciali che fanno riferimento a un documento e 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 ID documento.
https://docs.google.com/document/d/DOCUMENT_ID/edit
- Elemento
La struttura che compongono 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 di MIME supportati per Google Workspace e Google Drive.- Indice
La maggior parte degli elementi nel corpo dei contenuti ha le proprietà
startIndex
eendIndex
. Indicano l'offset dell'inizio e della fine di un elemento, rispetto all'inizio del segmento che lo contiene.- Immagine incorporata
Un'immagine visualizzata 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 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.- Segment
Gli elementi
Body
,Header
,Footer
oFootnote
contenenti elementi strutturali o di contenuti. Gli indici degli elementi all'interno di un segmento sono relativi all'inizio di quel segmento.- Suggerimento
Modifiche a un documento senza modificare il testo originale. Se il proprietario approva i suggerimenti, il testo originale verrà sostituito.
Argomenti correlati
Per scoprire di più sullo sviluppo con le API Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta Sviluppare su Google Workspace.
Per ottenere una panoramica concettuale di un documento, consulta Documento.
Per scoprire come configurare ed eseguire un'app con l'API Docs, prova la guida rapida di JavaScript.