Panoramica dell'API Google Docs

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 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 di MIME supportati per Google Workspace e Google Drive.

Indice

La maggior parte degli elementi nel corpo dei contenuti 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 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 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.

Segment

Gli elementi Body, Header, Footer o Footnote 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.

  • 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.