使用 Maton API 密钥认证,创建、更新、列出和删除 Google Calendar 事件,支持参与者、时区及 Google Meet。
QQ技能. md – Google Calendar –通过 Maton Gateway (Full Spec) + 认证是一项面向实际任务的技能,主要用于所有请求都需要 Maton API 密钥 :. 选择环境变量:QQ Base URL + 时区(IMPORANT). 永远使用 IANA 时间 z。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;
涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
所有请求均需提供 Maton API 密钥:
-H "Authorization: Bearer $MATON_API_KEY"
设置环境变量:
export MATON_API_KEY="YOUR_API_KEY"
https://gateway.maton.ai/google-calendar/calendar/v3
请始终使用 IANA 时区标识符。
Australia/Melbourne
curl "https://gateway.maton.ai/google-calendar/calendar/v3/calendars/primary/events?maxResults=20&singleEvents=true&orderBy=startTime" -H "Authorization: Bearer $MATON_API_KEY"
curl -X POST "https://gateway.maton.ai/google-calendar/calendar/v3/calendars/primary/events"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"summary": "Team Meeting",
"description": "Weekly sync",
"start": {
"dateTime": "2026-05-22T10:00:00",
"timeZone": "Australia/Melbourne"
},
"end": {
"dateTime": "2026-05-22T11:00:00",
"timeZone": "Australia/Melbourne"
}
}'
curl -X POST "https://gateway.maton.ai/google-calendar/calendar/v3/calendars/primary/events"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"summary": "Project Kickoff",
"start": {
"dateTime": "2026-05-22T14:00:00",
"timeZone": "Australia/Melbourne"
},
"end": {
"dateTime": "2026-05-22T15:00:00",
"timeZone": "Australia/Melbourne"
},
"attendees": [
{ "email": "user1@example.com" },
{ "email": "user2@example.com" }
],
"sendUpdates": "all"
}'
curl -X POST "https://gateway.maton.ai/google-calendar/calendar/v3/calendars/primary/events?conferenceDataVersion=1"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"summary": "Client Meeting (Google Meet)",
"start": {
"dateTime": "2026-05-23T09:00:00",
"timeZone": "Australia/Melbourne"
},
"end": {
"dateTime": "2026-05-23T10:00:00",
"timeZone": "Australia/Melbourne"
},
"attendees": [
{ "email": "client@example.com" }
],
"conferenceData": {
"createRequest": {
"requestId": "meet-123456",
"conferenceSolutionKey": {
"type": "hangoutsMeet"
}
}
}
}'
curl -X PATCH "https://gateway.maton.ai/google-calendar/calendar/v3/calendars/primary/events/{EVENT_ID}"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"summary": "Updated Meeting Title",
"description": "Updated agenda"
}'
curl -X PATCH "https://gateway.maton.ai/google-calendar/calendar/v3/calendars/primary/events/{EVENT_ID}"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"start": {
"dateTime": "2026-05-24T12:00:00",
"timeZone": "Australia/Melbourne"
},
"end": {
"dateTime": "2026-05-24T13:00:00",
"timeZone": "Australia/Melbourne"
}
}'
curl -X PATCH "https://gateway.maton.ai/google-calendar/calendar/v3/calendars/primary/events/{EVENT_ID}"
-H "Authorization: Bearer $MATON_API_KEY"
-H "Content-Type: application/json"
-d '{
"attendees": [
{ "email": "newuser@example.com" },
{ "email": "existing@example.com" }
],
"sendUpdates": "all"
}'
curl -X DELETE "https://gateway.maton.ai/google-calendar/calendar/v3/calendars/primary/events/{EVENT_ID}"
-H "Authorization: Bearer $MATON_API_KEY"
{
"summary": "Event Title",
"description": "Optional details",
"start": {
"dateTime": "2026-05-22T10:00:00",
"timeZone": "Australia/Melbourne"
},
"end": {
"dateTime": "2026-05-22T11:00:00",
"timeZone": "Australia/Melbourne"
}
}
PATCH 方法sendUpdates: "all"conferenceDataVersion=1