บริการขั้นสูงของเอกสารช่วยให้คุณใช้ Google เอกสาร API ใน Apps Script ได้ API นี้ช่วยให้สคริปต์อ่าน แก้ไข และจัดรูปแบบเนื้อหาใน Google เอกสารได้เช่นเดียวกับบริการเอกสารในตัวของ Apps Script ใน กรณีส่วนใหญ่ บริการในตัวจะใช้งานง่ายกว่า แต่บริการขั้นสูงนี้ มีฟีเจอร์เพิ่มเติมอีก 2-3 อย่าง
ข้อมูลอ้างอิง
ดูข้อมูลโดยละเอียดเกี่ยวกับบริการนี้ได้ที่เอกสารอ้างอิงสำหรับ Docs API เช่นเดียวกับบริการขั้นสูงทั้งหมดใน Apps Script บริการเอกสารขั้นสูงจะใช้วัตถุ เมธอด และพารามิเตอร์เดียวกันกับ API สาธารณะ ดูข้อมูลเพิ่มเติมได้ที่����ธีก��ห����ลายเซ็นของเมธอด
หากต้องการรายงานปัญหาและรับการสนับสนุนอื่นๆ โปรดดูคู่มือการสนับสนุน 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);