השירות המתקדם של יומן Google מאפשר לך להשתמש בממשק ה-API הציבורי של יומן Google ב-Apps Script. בדומה לשירות היומן המובנה של Apps Script, ה-API הזה מאפשר לסקריפטים לגשת ליומן Google של המשתמש ולשנות אותו, כולל יומנים נוספים שהמשתמש רשום אליהם. ברוב המקרים קל יותר להשתמש בשירות המובנה, אבל השירות המתקדם הזה מספק כמה תכונות נוספות, כולל הגדרת צבע הרקע של אירועים ספציפיים.
חומר עזר
למידע מפורט על השירות הזה, עיינו במסמכי התיעוד של ממשק ה-API הציבורי של יומן Google. בדומה לכל השירותים המתקדמים ב-Apps Script, גם השירות המתקדם של יומן Google משתמש באותם אובייקטים, שיטות ופרמטרים כמו ה-API הציבורי. מידע נוסף זמין במאמר איך נקבעות חתימות של שיטות.
במדריך התמיכה של יומן Google מוסבר איך לדווח על בעיות ולקבל אפשרויות תמיכה אחרות.
כותרות של בקשות HTTP
השירות המתקדם של יומן Google יכול לקבל את הכותרות של בקשות ה-HTTP If-Match
ו-If-None-Match
. מידע נוסף מופיע במסמכי התיעוד.
קוד לדוגמה
בקוד לדוגמה שבהמשך משתמשים בגרסה 3 של ה-API.
יצירת אירועים
הדוגמה הבאה מראה איך ליצור אירוע ביומן ברירת המחדל של המשתמש.
הצגת רשימה של יומנים
הדוגמה הבאה ממחישה איך מאחזרים פרטים על היומנים שמוצגים ברשימת היומנים של המשתמש.
אירועים בדף האפליקציה
הדוגמה הבאה ממחישה איך להציג את רשימת 10 האירועים הקרובים ביומן ברירת המחדל של המשתמש.
שינוי מותנה של אירוע
בדוגמה הבאה אפשר לראות איך מעדכנים אירועים ביומן לפי תנאים באמצעות הכותרת If-Match
. הסקריפט יוצר אירוע חדש, ממתין 30 שניות ואז
מעדכן את האירוע רק אם לא השתנו פרטי אירוע מאז שהאירוע נוצר.
אחזור אירוע באופן מותנה
בדוגמה הבאה מוסבר איך לאחזר אירועים ביומן באופן מותנה באמצעות הכותרת If-None-Match
. הסקריפט יוצר אירוע חדש ולאחר מכן בודק את האירוע בהתאם לשינויים למשך 30 שניות. בכל פעם שהאירוע משתנה, הגרסה החדשה מאוחזרת.
סנכרון אירועים
הדוגמה הבאה ממחישה איך מאחזרים אירועים באמצעות אסימוני סנכרון. כשכוללים אסימון סנכרון בבקשת שירות מתקדם של יומן Google, התגובה שמתקבלת כוללת רק פריטים שהשתנו מאז שהאסימון הזה נוצר, וכך עיבוד יעיל יותר. לפרטים נוספים על תהליך הסנכרון, ראו סנכרון יעיל של משאבים.
בדוגמה הבאה נשתמש באותה method getRelativeDate(daysOffset, hour)
שהוגדרה בדוגמאות שלמעלה.