השירות המתקדם של Docs מאפשר להשתמש ב-Google Docs API ב-Apps Script. בדומה לשירות Docs המובנה של Apps Script, ה-API הזה מאפשר לסקריפטים לקרוא, לערוך ולעצב תוכן ב-Google Docs. ברוב המקרים קל יותר להשתמש בשירות המובנה, אבל השירות המתקדם הזה כולל כמה תכונות נוספות.
חומר עזר
מידע מפורט על השירות הזה זמין במסמכי התיעוד של Docs API. בדומה לכל השירותים המתקדמים ב-Apps Script, גם השירות המתקדם של Docs משתמש באותם אובייקטים, שיטות ופרמטרים כמו ה-API הציבורי. מידע נוסף זמין במאמר איך נקבעות חתימות של שיטות.
כדי לדווח על בעיות ולמצוא תמיכה אחרת, קראו את מדריך התמיכה ב-Docs API.
קוד לדוגמה
הקוד לדוגמה שבהמשך משתמש בגרסה 1 של ה-API.
יצירת מסמך
הדוגמה הזו יוצרת מסמך חדש.
חיפוש והחלפה של טקסט
הדוגמה הזו מוצאת ומחליפה זוגות של טקסט במסמך. האפשרות הזו יכולה להיות שימושית כשמחליפים placeholders בעותק של מסמך תבנית בערכים ממסד נתונים.
הוספה ועיצוב של טקסט
בדוגמה הזו מתווסף טקסט חדש בתחילת המסמך ובסגנונות שונים, אם נעשה בו שימוש בגופן ובגודל ספציפיים. שימו לב: כשהדבר אפשרי, כדאי לקבץ יחד מספר פעולות בקריאה אחת ל-batchUpdate
כדי לשפר את היעילות.
קריאת הפסקה הראשונה
הדוגמה הזו מתעדת את הטקסט של הפסקה הראשונה במסמך. בגלל האופי המובנה של הפסקאות ב-Docs API, נדרש שילוב של הטקסט שמופיע במספר רכיבי משנה.
שיטות מומלצות
עדכונים בכמות גדולה
כשמשתמשים בשירות המתקדם Docs, אפשר לשלב כמה בקשות במערך במקום להפעיל את batchUpdate
בלולאה.
מה לא לעשות — מתקשרים אל batchUpdate
בלולאה.
var textToReplace = ['foo', 'bar'];
for (var i = 0; i < textToReplace.length; i++) {
Docs.Documents.batchUpdate({
requests: [{
replaceAllText: ...
}]
}, docId);
}
Do — Call batchUpdate
עם מגוון עדכונים.
var requests = [];
var textToReplace = ['foo', 'bar'];
for (var i = 0; i < textToReplace.length; i++) {
requests.push({ replaceAllText: ... });
}
Docs.Documents.batchUpdate({
requests: requests
}, docId);