Omówienie interfejsu API Dokumentów Google
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Interfejs Google Docs API umożliwia tworzenie i modyfikowanie dokumentów w Dokumentach Google.
Aplikacje mogą integrować się z interfejsem Docs API, aby tworzyć dopracowane dokumenty na podstawie danych dostarczonych przez użytkownika i system. Interfejs Docs API umożliwia:
- Automatyzacja procesów
- Zbiorcze tworzenie dokumentacji
- Formatowanie dokumentów
- generować faktury lub umowy,
- Pobieranie określonych atrybutów obiektów
Oto lista najczęstszych terminów używanych w interfejsie Docs API:
- Identyfikator dokumentu
Unikalny identyfikator dokumentu. Jest to ciąg znaków zawierający litery, cyfry i niektóre znaki specjalne, który odnosi się do dokumentu i może być wyodrębniony z jego adresu URL. Identyfikatory dokumentów są stałe, nawet jeśli nazwa dokumentu ulegnie zmianie. Więcej informacji o tym, jak znaleźć identyfikator, znajdziesz w artykule Identyfikator dokumentu.
https://docs.google.com/document/d/DOCUMENT_ID/edit
- Element
Struktura, która tworzy dokument. Elementy najwyższego poziomu dokumentu to Body, DocumentStyle i List.
- Dokument Google Workspace
Plik utworzony przez aplikację Google Workspace, np. Dokumenty Google.
Format typu MIME w przypadku Dokumentów to application/vnd.google-apps.document. Listę typów MIME znajdziesz w artykule
Obsługiwane typy MIME w Google Workspace i na Dysku Google.
- Indeks
Większość elementów w treści ma właściwości startIndex i endIndex. Określają one przesunięcie początku i końca elementu względem początku otaczającego go segmentu.
- Obraz w treści
Obraz, który pojawia się w tekście dokumentu. Nie jest to załącznik.
- Zakres nazwany
Ciągły zakres tekstu. NamedRange to zbiór zakresów o tym samym namedRangeId. Nazwane zakresy umożliwiają deweloperom powiązanie części dokumentu z dowolną etykietą zdefiniowaną przez użytkownika, dzięki czemu zawartość można później odczytywać lub edytować automatycznie. Dokument może zawierać wiele zakresów nazwanych o tej samej nazwie, ale każdy zakres nazwany ma unikalny identyfikator.
- Segment
Element Body, Header, Footer lub Footnote zawierający elementy strukturalne lub treści. Indeksy elementów w segmencie są określane względem początku tego segmentu.
- Sugestia
zmiany w dokumencie bez edytowania oryginalnego tekstu. Jeśli właściciel zatwierdzi Twoje sugestie, zastąpią one oryginalny tekst.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]
