Google Dokümanlar API'sına genel bakış

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 ve List 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 ve endIndex ö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 da Footnote. 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.

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