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

Google Docs 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 Docs API ile entegre olabilir. Dokümanlar API'si sayesinde şunları yapabilirsiniz:

  • İşlemleri otomatikleştirme
  • Dokümanları toplu olarak oluşturma
  • Dokümanları biçimlendirme
  • Fatura veya sözleşme oluşturma
  • Nesnelerin belirli özelliklerini alma

Dokümanlar API'de kullanılan yaygın terimlerin listesi aşağıda verilmiştir:

Belge kimliği

Belgenin benzersiz tanımlayıcısı. Harf, sayı ve bir dokümana atıfta bulunan bazı özel karakterler içeren belirli bir dizedir ve dokümanın URL'sinden türetilebilir. Belge adı değişse bile doküman kimlikleri sabit kalır. Kimliği bulma 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 Body, DocumentStyle ve List'tır.

Google Workspace dokümanı

Google Dokümanlar gibi bir Google Workspace uygulamasının oluşturduğu dosya. Dokümanlar için MIME türü biçimi application/vnd.google-apps.document'tür. MIME türlerinin listesi için Google Workspace ve Google Drive'ın desteklediği 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 sonunun, kapsayıcı segmentinin başlangıcına göre ofsetini belirtir.

Satır içi resim

Bir doküman metninde görünen resim. Ek değildir.

Adlandırılmış aralık

Bitişik bir metin aralığı. NamedRange, aynı namedRangeId değerine sahip bir aralık koleksiyonudur. Adlandırılmış aralıklar, geliştiricilerin bir dokümanın bölümlerini 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üman aynı ada sahip birden fazla adlandırılmış aralık içerebilir 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öredir.

Öneri

Orijinal metni değiştirmeden dokümanda yapılan değişiklikler. Sahibi önerilerinizi onaylarsa önerileriniz orijinal metnin yerini alır.

  • Kimlik doğrulama ve yetkilendirme işlemleri de dahil olmak üzere Google Workspace API'leriyle geliştirme yapma hakkında bilgi edinmek için Google Workspace'te geliştirme yapma başlıklı makaleyi inceleyin.

  • Bir dokümana kavramsal bir 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.