Google Dokümanlar API'sı, Google Dokümanlar'da doküman oluşturmanıza ve mevcut dokümanlarda değişiklik yapmanıza olanak tanır.
Uygulamalar, Docs API ile entegre edilebilir ve hem kullanıcı hem de sistem tarafından sağlanan verilerden gösterişli belgeler oluşturabilir. Docs API şunları yapmanıza olanak tanır:
- Süreçleri otomatikleştirin
- Toplu doküman oluşturma
- Dokümanları biçimlendirme
- Fatura veya sözleşme oluşturma
- Nesnelerin belirli özelliklerini alma
Dokümanlar API'sında yaygın olarak kullanılan terimlerin listesi aşağıda verilmiştir:
- Doküman Kimliği
Bir dokümanın benzersiz tanımlayıcısıdır. Bir dokümana referans veren harf, sayı ve bazı özel karakterler içeren belirli bir dizedir ve dokümanın URL'sinden türetilebilir. Belge adları, belge adı değişse bile sabit kalır. Kimliği nasıl bulacağınız hakkında daha fazla bilgi için Doküman Kimliği bölümüne bakın.
https://docs.google.com/document/d/DOCUMENT_ID/edit
- Öğe
Dokümanı oluşturan yapı. Bir dokümanın üst düzey öğeleri arasında
Body
,DocumentStyle
veList
bulunur.- Google Workspace dokümanı
Google Dokümanlar gibi Google Workspace uygulamalarının oluşturduğu dosyadır. 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ı makaleye bakın.- Dizin
İçerik gövdesindeki çoğu öğe,
startIndex
veendIndex
özelliklerine sahiptir. Bunlar, bir öğeyi çevreleyen segmentin başlangıcına göre, bir öğenin başlangıç ve bitişinin uzaklığını gösterir.- Satır içi resim
Bir doküman içindeki metin akışında görünen resim. Bu bir ek değil.
- Adlandırılan aralık
Bitişik bir metin aralığı.
NamedRange
, aynınamedRangeId
değerine sahip aralık koleksiyonudur. Adlandırılmış aralıklar, geliştiricilerin bir dokümanın bölümlerini rastgele bir kullanıcı tanımlı etiketle ilişkilendirmesine olanak tanır. Böylece bu içerikler daha sonra programlı bir şekilde okunabilir veya düzenlenebilir. Bir belge, aynı ada sahip birden fazla adlandırılmış aralık içerebilir ancak adlandırılmış her aralığın benzersiz bir kimliği vardır.- Segment
Yapısal veya içerik öğeleri içeren
Body
,Header
,Footer
ya daFootnote
. Bir segment içindeki öğelerin dizinleri, söz konusu segmentin başlangıcına göre belirlenir.- Öneri
Orijinal metni değiştirmeden dokümanda yapılan değişiklikler. Doküman sahibi önerilerinizi onaylarsa orijinal metnin yerine geçer.
İlgili konular
Kimlik doğrulama ve yetkilendirmeyi yönetme de dahil olmak üzere Google Workspace API'leriyle geliştirme hakkında bilgi edinmek için Google Workspace'te geliştirme bölümüne bakın.
Bir dokümana dair kavramsal genel bakış için Belge bölümüne göz atın.
Dokümanlar API'si 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.