必须完成api授权、服务端配置与工作流对接三步闭环:1. 创建google cloud项目并启用calendar api;2. 配置oauth 2.0凭据并下载命名为credentials.json的文件;3. 在dify中设置环境变量、编写python工具函数并构建智能排程工作流。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Dify中让AI助手自动读取和写入Google Calendar日程,必须先完成API授权、服务端配置与工作流对接三步闭环,缺一不可。
创建Google Cloud项目并启用Calendar API
进入 Google Cloud Console → 新建项目 → 命名后等待初始化完成 → 左侧导航栏选择“API和服务”→“库”→ 搜索“Google Calendar API”→ 点击启用。
这一步跳过会导致后续所有请求返回403错误,且无法通过Dify侧补救。
配置OAuth 2.0凭据并下载credentials.json
在同一个Cloud项目中,进入“API和服务”→“凭据”→ 创建凭据 → 选择“OAuth客户端ID”→ 应用类型选“桌面应用”(Dify暂不支持Web应用重定向校验)→ 名称随意填写 → 创建。
点击新生成的凭据右侧“下载JSON”按钮,保存为 【credentials.json】。文件名不能改,Dify SDK默认只认这个名字。
注意:如果误选“Web应用”,会要求填写授权重定向URI,而Dify当前不提供可配置的回调地址,会导致授权流程卡死。
在Dify中配置环境变量与工具函数
登录Dify控制台 → 进入对应应用 → “设置”→“环境变量”→ 添加三项:
GOOGLE_CREDENTIALS_JSON:将 credentials.json 文件内容完整粘贴为字符串值(含所有换行和引号,建议用代码编辑器确认格式无缺失);
GOOGLE_CALENDAR_ID:填入目标日历ID(如 primary 或 xxx@group.calendar.google.com);
GOOGLE_TOKEN_CACHE_PATH:设为 /tmp/google_token.pickle(Dify沙箱环境仅允许写入/tmp目录)。
编写Python工具函数接入日历操作
方法一:使用官方google-api-python-client封装基础能力
Veo 3.1增强了音频生成能力、提示词理解能力和角色一致性控制。支持多参考图生成、场景扩展(Scene Extension)、更长视频制作以及更精准的镜头控制,同时提升了画面真实感和叙事能力。是当前 Google 主推的旗舰视频生成模型。
在Dify“工具”模块中新建自定义工具 → 语言选Python → 粘贴以下代码:
```python
from google.auth.transport.requests import Request
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
import os
import pickle
SCOPES = ['https://www.googleapis.com/auth/calendar.events']
def get_calendar_service():
creds = None
if os.path.exists('/tmp/google_token.pickle'):
with open('/tmp/google_token.pickle', 'rb') as token:
creds = pickle.load(token)
if not creds or not creds.valid:
if creds and creds.expired and creds.refresh_token:
creds.refresh(Request())
else:
flow = InstalledAppFlow.from_client_config(
os.environ.get('GOOGLE_CREDENTIALS_JSON'), SCOPES)
creds = flow.run_local_server(port=0)
with open('/tmp/google_token.pickle', 'wb') as token:
pickle.dump(creds, token)
return build('calendar', 'v3', credentials=creds)
def list_upcoming_events(max_results=10):
service = get_calendar_service()
now = datetime.datetime.utcnow().isoformat() + 'Z'
events_result = service.events().list(calendarId=os.environ.get('GOOGLE_CALENDAR_ID'),
timeMin=now,
maxResults=max_results,
singleEvents=True,
orderBy='startTime').execute()
return events_result.get('items', [])
def create_event(summary, start_time, end_time, attendees=None):
service = get_calendar_service()
event = {
'summary': summary,
'start': {'dateTime': start_time, 'timeZone': 'Asia/Shanghai'},
'end': {'dateTime': end_time, 'timeZone': 'Asia/Shanghai'},
'attendees': [{'email': e} for e in (attendees or [])]
}
return service.events().insert(calendarId=os.environ.get('GOOGLE_CALENDAR_ID'), body=event).execute()
```
方法二:直接调用REST API(绕过OAuth本地服务器流程,适合已预授权场景)
若已在其他系统完成首次授权并获取了refresh_token,可改用 requests 直接调用:用 refresh_token 换取 access_token → 调用 /calendar/v3/calendars/{calendarId}/events POST接口。
该方式需自行维护token刷新逻辑,但能规避Dify沙箱中 run_local_server() 启动失败的问题。
构建智能排程工作流
第一步:添加“获取空闲时段”工具节点,输入参数设为 today_start 和 duration_minutes;
第二步:添加“查询日历冲突”工具节点,传入待排时间区间,输出事件列表;
第三步:接入LLM判断逻辑——提示词中明确要求:“仅当无冲突时返回ISO8601时间字符串,否则返回空字符串”;
第四步:连接“创建会议事件”工具节点,仅当上一步输出非空才触发执行;
第五步:将最终生成的event ID和链接注入回复模板,例如:“✅ 已为您预定:{summary},点击查看详情”。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










