บริการเอกสารขั้นสูงช่วยให้คุณสามารถใช้ Google เอกสาร API ใน Apps Script ได้ API นี้ช่วยให้สคริปต์อ่าน แก้ไข และจัดรูปแบบเนื้อหาใน Google เอกสารได้เช่นเดียวกับบริการเอกสารในตัวของ Apps Script ในกรณีส่วนใหญ่ บริการในตัวจะใช้งานง่ายกว่า แต่บริการขั้นสูงนี้มีฟีเจอร์เพิ่มเติมเล็กน้อย
ข้อมูลอ้างอิง
ดูข้อมูลอย่างละเอียดเกี่ยวกับบริการนี้ได้ในเอกสารประกอบอ้างอิงสำหรับ Docs API บริการเอกสารขั้นสูงจะใช้ออบเจ็กต์ เมธอด และพารามิเตอร์เดียวกันกับ API สาธารณะ เช่นเดียวกับบริการขั้นสูงทั้งหมดใน Apps Script โปรดดูข้อมูลเพิ่มเติมที่หัวข้อวิธีกำหนดลายเซ็นของเมธอด
หากต้องการรายงานปัญหาและค้นหาการสนับสนุนอื่นๆ โปรดดูคู่มือการสนับสนุนสำหรับ Docs API
รหัสตัวอย่าง
โค้ดตัวอย่างด้านล่างใช้ API เวอร์ชัน 1
สร้างเอกสาร
ตัวอย่างนี้สร้างเอกสารใหม่
ค้นหาและแทนที่ข้อความ
ตัวอย่างนี้จะค้นหาและแทนที่ข้อความคู่ในเอกสาร ซึ่งจะเป็นประโยชน์เมื่อแทนที่ตัวยึดตำแหน่งในสำเนาเอกสารเทมเพลตด้วยค่าจากฐานข้อมูล
แทรกและจัดรูปแบบข้อความ
ตัวอย่างนี้จะแทรกข้อความใหม่ไว้ที่ตอนต้นของเอกสารและรูปแบบหากมีแบบอักษรและขนาดที่เฉพาะเจาะจง โปรดทราบว่าหากเป็นไปได้ คุณควรจัดกลุ่มการดำเนินการหลายรายการเข้าด้วยกันเป็นการเรียก batchUpdate
รายการเดียวเพื่อประสิทธิภาพ
อ่านย่อหน้าแรก
ตัวอย่างนี้จะบันทึกข้อความในย่อหน้าแรกของเอกสาร เนื่องจากลักษณะของย่อหน้าใน Docs API เป็นโครงสร้างของย่อหน้า จึงเกี่ยวข้องกับการรวมข้อความขององค์ประกอบย่อยหลายองค์ประกอบเข้าด้วยกัน
แนวทางปฏิบัติแนะนำ
การอัปเดตเป็นกลุ่ม
เมื่อใช้บริการเอกสารขั้นสูง ให้รวมคำขอหลายรายการไว้ในอาร์เรย์แทนการเรียก batchUpdate
แบบวนซ้ำ
ไม่ต้อง — เรียก batchUpdate
แบบวนซ้ำ
var textToReplace = ['foo', 'bar'];
for (var i = 0; i < textToReplace.length; i++) {
Docs.Documents.batchUpdate({
requests: [{
replaceAllText: ...
}]
}, docId);
}
สิ่งที่ควรทำ — เรียก batchUpdate
เพื่อแจ้งข้อมูลอัปเดตต่างๆ
var requests = [];
var textToReplace = ['foo', 'bar'];
for (var i = 0; i < textToReplace.length; i++) {
requests.push({ replaceAllText: ... });
}
Docs.Documents.batchUpdate({
requests: requests
}, docId);