A custom event that a site owner adds to their marketing content calendar, such as a sale, holiday, product launch, or business milestone. These events give the AI additional context when generating a marketing plan: plan activities can be scheduled around them. The events themselves do not directly create marketing activities.
An event can be one-time (set date) or recurring (set recurringRule). If both are sent,
recurringRule takes precedence.
ID of the marketing calendar this event belongs to.
Date and time of the event. Set this field for a one-time event. For a recurring event, set
recurringRule instead. If both are sent, recurringRule takes precedence and date is
ignored. If neither is sent, the request fails with INVALID_ARGUMENT.
Optional description providing additional context about the event.
Unique event ID. Assigned on creation.
Display name of the event (for example, "Summer Sale" or "Independence Day").
Computed individual occurrences of a recurring event. Read-only; populated only in
QueryEvents responses, and only for occurrences within the requested date range.
Recurrence rule for the event. Set this field for a recurring event (weekly, monthly, or
yearly). If both recurringRule and date are sent, recurringRule takes precedence and
date is ignored. frequency is required and must not be UNKNOWN; omitting it returns a
FAILED_PRECONDITION error.