Panoramica dell'API Google Docs
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
L'API Google Docs ti 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:
- 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, ad esempio 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.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[],[],null,["# Google Docs API overview\n\nThe Google Docs API lets you create and modify documents in Google Docs.\n\nApplications can integrate with the Docs API to create polished\ndocuments from both user and system-provided data. The Docs API lets\nyou:\n\n- Automate processes\n- Create documentation in bulk\n- Format documents\n- Generate invoices or contracts\n- Retrieve specific attributes of objects\n\nThe following is a list of common terms used in the Docs API:\n\n*Document ID*\n\n: The unique identifier for a document. It's a particular string containing\n letters, numbers, and some special characters that reference a document and\n it can be derived from the document's URL. Document IDs are stable, even if\n the document name changes. For more information on how to find the ID, see\n [Document ID](/workspace/docs/api/concepts/document#document-id).\n\n https://docs.google.com/document/d/\u003cvar translate=\"no\"\u003eDOCUMENT_ID\u003c/var\u003e/edit\n\n*Element*\n\n: The structure that makes up a document. Top-level elements of a document\n include the [`Body`](/workspace/docs/api/reference/rest/v1/documents#body),\n [`DocumentStyle`](/workspace/docs/api/reference/rest/v1/documents#documentstyle), and\n [`List`](/workspace/docs/api/reference/rest/v1/documents#list).\n\n*Google Workspace document*\n\n: A file that a Google Workspace application, like Google Docs, creates.\n The MIME type format for Docs is\n `application/vnd.google-apps.document`. For a list of MIME types, see [Google Workspace and Google Drive supported MIME types](/drive/api/guides/mime-types).\n\n*Index*\n\n: Most *elements* within the content body have the `startIndex` and `endIndex`\n properties. These indicate the offset of an element's beginning and end,\n relative to the beginning of its enclosing *segment*.\n\n*Inline image*\n\n: An image that appears in the flow of text within a document. It's not an\n attachment.\n\n*Named range*\n\n: A contiguous range of text. A\n [`NamedRange`](/workspace/docs/api/reference/rest/v1/documents#namedrange) is a\n collection of ranges with the same `namedRangeId`. Named ranges allow\n developers to associate parts of a document with an arbitrary user-defined\n label so their contents can be programmatically read or edited later. A\n document can contain multiple named ranges with the same name, but every\n named range has a unique ID.\n\n*Segment*\n\n: The `Body`, [`Header`](/workspace/docs/api/reference/rest/v1/documents#header),\n [`Footer`](/workspace/docs/api/reference/rest/v1/documents#footer), or\n [`Footnote`](/workspace/docs/api/reference/rest/v1/documents#footnote) containing\n structural or content *elements* . The *indexes* of the elements within a\n segment are relative to the beginning of that segment.\n\n*Suggestion*\n\n: Changes to a document without changing the original text. If the owner\n approves your suggestions, they replace the original text.\n\nRelated topics\n--------------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Develop on\n Google Workspace](/workspace/guides/get-started).\n\n- To get a conceptual overview of a document, see\n [Document](/workspace/docs/api/concepts/document).\n\n- To learn how to configure and run a Docs API app, try the\n [JavaScript quickstart](/workspace/docs/api/quickstart/js)."]]
