العودة إلى Google Calendar
اتصل بـ Knoon AI مع Google Calendar (Google) لأتمتة تدفقات عمل الذكاء الاصطناعي.
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. |