Dengan layanan Dokumen lanjutan, Anda dapat menggunakan Google Docs API di Apps Script. Mirip dengan layanan Dokumen bawaan Apps Script, API ini memungkinkan skrip membaca, mengedit, dan memformat konten di Google Dokumen. Dalam sebagian besar kasus, layanan bawaan lebih mudah digunakan, tetapi layanan lanjutan ini menyediakan beberapa fitur tambahan.
Referensi
Untuk informasi mendetail tentang layanan ini, lihat dokumentasi referensi untuk Docs API. Seperti semua layanan lanjutan di Apps Script, layanan Dokumen lanjutan menggunakan objek, metode, dan parameter yang sama dengan API publik. Untuk informasi selengkapnya, lihat Cara tanda tangan metode ditentukan.
Untuk melaporkan masalah dan menemukan dukungan lainnya, lihat panduan dukungan API Dokumen.
Kode contoh
Kode contoh di bawah menggunakan API versi 1.
Buat dokumen
Contoh ini membuat dokumen baru.
Mencari dan mengganti teks
Contoh ini menemukan dan mengganti pasangan teks dalam dokumen. Hal ini berguna saat mengganti placeholder dalam salinan dokumen template dengan nilai dari database.
Menyisipkan dan memberi gaya teks
Contoh ini menyisipkan teks baru di awal dokumen dan gaya jika dengan font dan ukuran tertentu. Perhatikan bahwa, jika memungkinkan, Anda harus mengelompokkan
beberapa operasi ke dalam satu panggilan batchUpdate
untuk efisiensi.
Baca paragraf pertama
Contoh ini mencatat teks paragraf pertama dalam dokumen. Karena sifat paragraf yang terstruktur dalam Docs API, ini melibatkan penggabungan teks dari beberapa sub-elemen.
Praktik Terbaik
Update Massal
Saat menggunakan layanan Dokumen lanjutan, gabungkan beberapa permintaan dalam array, bukan memanggil batchUpdate
dalam satu loop.
Jangan — Panggil batchUpdate
dalam satu loop.
var textToReplace = ['foo', 'bar'];
for (var i = 0; i < textToReplace.length; i++) {
Docs.Documents.batchUpdate({
requests: [{
replaceAllText: ...
}]
}, docId);
}
Lakukan — Panggil batchUpdate
dengan array update.
var requests = [];
var textToReplace = ['foo', 'bar'];
for (var i = 0; i < textToReplace.length; i++) {
requests.push({ replaceAllText: ... });
}
Docs.Documents.batchUpdate({
requests: requests
}, docId);