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