Bu kılavuzda, posta birleştirme işlemi yapmak için Google Dokümanlar API'nin nasıl kullanılacağı açıklanmaktadır.
Giriş
Posta birleştirme, bir e-tablonun veya başka bir veri kaynağının satırlarındaki değerleri alıp bir şablon belgesine ekler. Bu sayede, her biri birleştirilen verilerle özelleştirilmiş birçok benzer doküman oluşturabileceğiniz tek bir birincil doküman (şablon) oluşturabilirsiniz. Sonuç, posta veya form mektupları için kullanılmak zorunda değildir. Müşteri faturaları oluşturmak gibi herhangi bir amaç için de kullanılabilir.
Posta birleştirme, e-tablolar ve kelime işlemciler olduğu sürece kullanılmıştır ve günümüzde birçok iş iş akışında yer almaktadır. Veriler, aşağıdaki tabloda gösterildiği gibi sütunlar verilerdeki alanları temsil edecek şekilde satır başına bir kayıt olacak şekilde düzenlenir:
Ad | Adres | Alt Bölge | |
---|---|---|---|
1 | UrbanPq | 123 1. Cad. | Batı |
2 | Pawxana | 456 2nd St. | Güney |
Bu sayfadaki örnek uygulamada, posta birleştirme işlemlerinin nasıl gerçekleştirildiğiyle ilgili ayrıntıları soyutlamak ve kullanıcıları uygulamayla ilgili endişelerden korumak için Google Dokümanlar, E-Tablolar ve Drive API'lerini nasıl kullanabileceğiniz gösterilmektedir. Bu Python örneğiyle ilgili daha fazla bilgiyi örneğin GitHub reposunda bulabilirsiniz.
Örnek uygulama
Bu örnek uygulama, birincil şablonunuzu kopyalar ve ardından, belirtilen veri kaynağınızdaki değişkenleri kopyaların her birine birleştirir. Bu örnek uygulamayı denemek için önce şablonunuzu oluşturun:
- Dokümanlar dosyası oluşturun. Kullanmak istediğiniz şablonu seçin.
- Yeni dosyanın belge kimliğini not edin. Daha fazla bilgi için Belge Kimliği başlıklı makaleyi inceleyin.
DOCS_FILE_ID
değişkenini doküman kimliğine ayarlayın.- İletişim bilgilerini, uygulamanın seçili verilerle birleştireceği şablon yer tutucu değişkenleriyle değiştirin.
Aşağıda, düz metin veya E-Tablolar gibi bir kaynaktan alınan gerçek verilerle birleştirilebilecek yer tutucular içeren bir örnek mektup şablonu verilmiştir. Bu şablon aşağıdaki gibi görünür:
Ardından, SOURCE
değişkenini kullanarak veri kaynağınız olarak düz metin veya E-Tablolar'ı seçin. Örnek varsayılan olarak düz metindir. Yani örnek verilerde TEXT_SOURCE_DATA
değişkeni kullanılır. E-Tablolar'dan veri almak için SOURCE
değişkenini 'sheets'
olarak güncelleyin ve SHEETS_FILE_ID
değişkenini ayarlayarak örnek e-tablomuza (veya kendi e-tablonuza) yönlendirin.
Sayfanın biçimini görebilmeniz için aşağıdaki gibi görünür:
Uygulamayı örnek verilerimizle deneyin, ardından verilerinize ve kullanım alanınıza uyarlayın. Komut satırı uygulaması şu şekilde çalışır:
- Kurulum
- Verileri veri kaynağından getirme
- Her veri satırını döngü içinde gezinme
- Şablonun bir kopyasını oluşturun
- Kopyayı verilerle birleştirme
- Yeni birleştirilen dokümanın çıkış bağlantısı
Yeni birleştirilen tüm e-postalar kullanıcının Drive'ım bölümünde de gösterilir. Birleştirilmiş bir mektuba örnek:
Kaynak kodu
Python
Daha fazla bilgi için örnek uygulamanın GitHub reposunda README
dosyasını ve uygulamanın tam kaynak kodunu inceleyin.
İlgili konular
- Posta birleştirme ile kişiselleştirilmiş e-postalar gönderme
- Gmail ve Google E-Tablolar ile posta birleştirme oluşturma