返回 Google Calendar
將 Knoon AI 與 Google Calendar (Google) 連接以自動化 AI 工作流程。
Search events in a specific calendar by extended properties, optionally constrained by time window and free-text query.
googleCalendarSearchEvents
測試版
權限
可選權限
沒有項目可顯示。
參數
| 名稱 | 類型 | 說明 | 必填 |
|---|---|---|---|
| calendarId | file | ID of the calendar to search in (e.g. "primary" or a specific calendar ID). | 是的 |
| start | mustache | Lower bound (inclusive) for event start time in RFC 3339/ISO 8601 format. | 是的 |
| end | mustache | Upper bound (exclusive) for event end time in RFC 3339/ISO 8601 format. | 是的 |
| maxResults | mustache | Maximum number of events to return (e.g. "10", "50"). | 否 |
| query | mustache | Optional free-text search query applied to title, description, location, and participant names/emails. | 否 |
| privateExtendedProperty | map (mustache) | Optional map of private extended properties to filter by. Only events whose event.extendedProperties.private contain all key=value pairs will be returned (e.g. {"knoonContactExternalId": "{{data.contact.externalId}}"}). | 否 |
| sharedExtendedProperty | map (mustache) | Optional map of shared extended properties to filter by. Only events whose event.extendedProperties.shared contain all key=value pairs will be returned. | 否 |
退貨
| 名稱 | 類型 | 說明 |
|---|---|---|
| status | string | DONE when events are returned. |
| events.start | string | Start date/time (RFC 3339/ISO 8601). |
| events.end | string | End date/time (RFC 3339/ISO 8601). |
| events.dayOfWeekLocal | string | Day of week in local time (e.g. Monday). |
| events.dayOfWeekUTC | string | Day of week in UTC (e.g. Monday). |
| events.sensitive.eventId | string | Unique identifier of the event. |
| events.sensitive.summary | string | Title of the event. |
| events.sensitive.description | string | Detailed description or notes for the event. |
| events.sensitive.location | string | Location of the event, if any. |
| events.sensitive.status | string | Event status (e.g. confirmed, tentative, cancelled). |
| events.confidential.htmlLink | string | Link to view the event in Google Calendar. |