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

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.