Google Dokümanlar API'sına genel bakış
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Google Dokümanlar API, Google Dokümanlar'da doküman oluşturmanıza ve değiştirmenize olanak tanır.
Uygulamalar, hem kullanıcı hem de sistem tarafından sağlanan verilerden kusursuz dokümanlar oluşturmak için Dokümanlar API'si ile entegre edilebilir. Docs API ile şunları yapabilirsiniz:
- Süreçleri otomatikleştirme
- Toplu olarak doküman oluşturma
- Dokümanları biçimlendirme
- Fatura veya sözleşme oluşturma
- Nesnelerin belirli özelliklerini alma
Aşağıda, Dokümanlar API'sinde kullanılan yaygın terimlerin listesi verilmiştir:
- Belge kimliği
Belgenin benzersiz tanımlayıcısı. Bir dokümana referans veren harfler, sayılar ve bazı özel karakterler içeren belirli bir dizedir ve dokümanın URL'sinden elde edilebilir. Doküman adı değişse bile doküman kimlikleri sabit kalır. Kimliğin nasıl bulunacağı hakkında daha fazla bilgi için Belge Kimliği başlıklı makaleyi inceleyin.
https://docs.google.com/document/d/DOCUMENT_ID/edit
- Öğe
Bir dokümanı oluşturan yapı. Bir dokümanın üst düzey öğeleri arasında Body, DocumentStyle ve List yer alır.
- Google Workspace dokümanı
Google Dokümanlar gibi bir Google Workspace uygulaması tarafından oluşturulan dosya.
Dokümanlar için MIME türü biçimi application/vnd.google-apps.document şeklindedir. MIME türlerinin listesi için
Google Workspace ve Google Drive'da desteklenen MIME türleri başlıklı makaleyi inceleyin.
- Dizin
İçerik gövdesindeki çoğu öğe, startIndex ve endIndex özelliklerine sahiptir. Bunlar, bir öğenin başlangıç ve bitişinin, kapsayan segmentinin başlangıcına göre olan uzaklığını gösterir.
- Satır içi resim
Bir dokümandaki metin akışında görünen resim. Ek değildir.
- Adlandırılmış aralık
Bitişik bir metin aralığı. NamedRange, aynı namedRangeId'ye sahip aralıklar topluluğudur. Adlandırılmış aralıklar, geliştiricilerin bir dokümanın bölümlerini rastgele kullanıcı tanımlı bir etiketle ilişkilendirmesine olanak tanır. Böylece içerikleri daha sonra programatik olarak okunabilir veya düzenlenebilir. Bir dokümanda aynı ada sahip birden fazla adlandırılmış aralık olabilir ancak her adlandırılmış aralığın benzersiz bir kimliği vardır.
- Segment
Yapısal veya içerik öğeleri içeren Body, Header,
Footer veya
Footnote. Bir segmentteki öğelerin dizinleri, söz konusu segmentin başlangıcına göre belirlenir.
- Öneri
Orijinal metni değiştirmeden dokümanda değişiklik yapabilirsiniz. Sahibi önerilerinizi onaylarsa önerileriniz orijinal metnin yerini alır.
Kimlik doğrulama ve yetkilendirme işlemlerini de içeren Google Workspace API'leriyle geliştirme hakkında bilgi edinmek için Google Workspace'te geliştirme başlıklı makaleyi inceleyin.
Bir belgeye ilişkin kavramsal genel bakış için Belge başlıklı makaleyi inceleyin.
Docs API uygulamasını nasıl yapılandıracağınızı ve çalıştıracağınızı öğrenmek için JavaScript hızlı başlangıç kılavuzunu deneyin.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 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)."]]
