→ חזרה לדף הראשי
📅

Calendar Skill

בדקו והוסיפו אירועים ליומן גוגל באמצעות Apps Script

⏱️ זמן התקנה: 10-15 דקות

מה הסקיל הזה עושה?

הסקיל מאפשר לקלוד לקרוא ולנהל את יומן גוגל שלכם. תוכלו לשאול "מה יש לי היום?" או "הוסף פגישה מחר ב-10" וקלוד יטפל בזה!

📆
אירועי היום
צפייה בכל האירועים של היום
📋
תצוגה שבועית
כל האירועים של השבוע
אירועים קרובים
מה יש בשעות הקרובות
הוספת אירועים
יצירת אירועים חדשים

1 מה צריך לפני שמתחילים?

חשבון גוגל

צריך חשבון גוגל עם יומן פעיל. זה בחינם!

Node.js מותקן

בדקו שיש לכם Node.js:

node --version
💡

טיפ: הסקיל משתמש ב-clasp - הכלי הרשמי של גוגל לניהול Apps Script מהטרמינל.

2 התקנת Clasp

Clasp הוא CLI של גוגל לניהול פרויקטי Apps Script:

# התקנה גלובלית npm install -g @google/clasp

התחברות לגוגל

clasp login

ייפתח דפדפן להתחברות עם חשבון גוגל שלכם.

⚠️

הפעלת API: אם מקבלים שגיאה, היכנסו ל-הגדרות Apps Script והפעילו את "Google Apps Script API".

3 יצירת פרויקט Apps Script

  1. צרו תיקייה חדשה
    mkdir calendar-api && cd calendar-api
  2. צרו פרויקט Apps Script
    clasp create --title "Calendar API" --type webapp

    זה יצור קבצי .clasp.json ו-appsscript.json

  3. העתיקו את קוד ה-API

    צרו קובץ Code.gs עם התוכן הבא:

    /** * Google Calendar API * Deploy as Web App */ const AUTH_TOKEN = 'YOUR_SECRET_TOKEN_HERE'; function doGet(e) { const token = e.parameter.token; if (token !== AUTH_TOKEN) { return jsonResponse({ error: 'Unauthorized' }); } const action = e.parameter.action || 'today'; let events; switch (action) { case 'today': events = getTodayEvents(); break; case 'week': events = getWeekEvents(); break; case 'upcoming': const hours = parseInt(e.parameter.hours) || 4; events = getUpcomingEvents(hours); break; } return jsonResponse({ count: events.length, events }); } // ... (ראו קוד מלא ב-GitHub)

    הקוד המלא נמצא בקובץ references/calendar-api.gs בסקיל.

  4. הגדירו טוקן סודי

    החליפו את YOUR_SECRET_TOKEN_HERE בסיסמה שתבחרו.

4 העלאה ופריסה

  1. העלו את הקוד לגוגל
    clasp push
  2. פרסו כ-Web App
    clasp deploy --description "Calendar API v1"
  3. קבלו את ה-URL
    clasp deployments

    העתיקו את ה-URL שמסתיים ב-/exec

🔧

אפשרות נוספת: הריצו clasp open לפתיחה בדפדפן ופרסו משם דרך Deploy → New deployment.

5 הגדרת הסקיל

אחרי שיש לכם URL וטוקן, בקשו מקלוד:

עדכן את הסקיל calendar עם: URL: https://script.google.com/macros/s/YOUR_DEPLOYMENT_ID/exec TOKEN: הטוקן_שבחרתם

או עדכנו ידנית את קובץ ה-SKILL.md בתיקיית הסקיל.

דוגמאות לשימוש

אחרי ההגדרה, פשוט תשאלו את קלוד:

# בדיקת אירועים "מה יש לי היום ביומן?" "מה יש לי השבוע?" "יש לי פגישות ב-4 שעות הקרובות?" # הוספת אירועים "הוסף פגישה עם דני מחר ב-10:00 עד 11:00" "קבע לי תזכורת לשיחה ביום רביעי ב-14:00"

פעולות זמינות

פעולה תיאור פרמטרים
today אירועי היום -
week אירועי השבוע -
upcoming שעות קרובות hours (ברירת מחדל: 4)
range טווח תאריכים start, end
add הוספת אירוע title, startTime, endTime

🔧 פקודות Clasp שימושיות

# התחברות והתנתקות clasp login clasp logout # ניהול פרויקט clasp push # העלאה לגוגל clasp pull # הורדה מגוגל clasp open # פתיחה בדפדפן # פריסה clasp deploy # פריסה חדשה clasp deployments # רשימת פריסות clasp undeploy ID # הסרת פריסה # דיבאג clasp logs # צפייה בלוגים

🔧 פתרון בעיות

"Script API not enabled"

היכנסו ל-הגדרות Apps Script והפעילו את ה-API.

"Unauthorized"

"Not found"

אין הרשאות ליומן

וודאו שבפריסה בחרתם:

← חזרה לדף הראשי 📂 קוד מלא ב-GitHub