A category filter.
You can query on multiple categories by listing multiple categories separated by slashes. The service returns all entries that match all
of the categories (like using AND between terms). For example:
To do an OR between terms, use a pipe character (
An entry matches a specified category if the entry is in a category that has a matching term or label, as defined in the Atom specification. (Roughly, the "term" is the internal string used by the software to identify the category, while the "label" is the human-readable string presented to a user in a user interface.)
To exclude entries that match a given category, use the form
To query for a category that has a scheme – such as
The above features can be combined. For example:
The ETag against which to check for updates. If the server-side ETag matches this one, the requested feed hasn't changed, and is not returned unnecessarily.
Setting any of the other query properties will unset the ETag, as ETags match against entire queries. If the ETag should be used in a query, it must be set again using gdata_query_set_etag() after setting any other properties.
A shortcut to request all events scheduled for the future. Overrides the #GDataCalendarQuery:start-min and #GDataCalendarQuery:start-max properties.
Strict query parameter checking. If this is enabled, an error will be returned by the online service if a parameter is not recognised.
Specifies the maximum number of attendees to list for an event. If the actual number of attendees for an event is greater than this value, only the current user and the event organiser are listed.
Maximum number of results to be retrieved. Most services have a default #GDataQuery:max-results size imposed by the server; if you wish to receive the entire feed, specify a large number such as %G_MAXUINT for this property.
Use 0 to not specify a maximum number of results.
Specifies order of entries in a feed. Supported values are
Upper bound on the entry publish date, exclusive.
Lower bound on the entry publish date, inclusive.
A full-text query string.
When creating a query, list search terms separated by spaces, in the form
To search for an exact phrase, enclose the phrase in quotation marks:
To exclude entries that match a given term, use the form
The search is case-insensitive.
Example: to search for all entries that contain the exact phrase "Elizabeth Bennet" and the word "Darcy" but don't contain the
word "Austen", use the following query:
Whether to include deleted/cancelled events in the query feed. Deleted events have their #GDataCalendarEvent:status property set to %GDATA_GD_EVENT_STATUS_CANCELED. They do not normally appear in query results.
Indicates whether recurring events should be expanded or represented as a single event.
The one-based index of the first result to be retrieved. Use gdata_query_next_page() and gdata_query_previous_page() to implement pagination, rather than manually changing #GDataQuery:start-index.
Use 0 to not specify a start index.
Together with #GDataCalendarQuery:start-min, creates a timespan such that only events within the timespan are returned
#GDataCalendarQuery:start-min is inclusive, while #GDataCalendarQuery:start-max is exclusive. Events that overlap the range are included. Both are specified in seconds since the UNIX epoch.
If not specified, the default #GDataCalendarQuery:start-max is
Together with #GDataCalendarQuery:start-max, creates a timespan such that only events within the timespan are returned.
#GDataCalendarQuery:start-min is inclusive, while #GDataCalendarQuery:start-max is exclusive. Events that overlap the range are included. Both are specified in seconds since the UNIX epoch.
If not specified, the default #GDataCalendarQuery:start-min is
The current timezone. If this is not specified, all times are returned in UTC.
Upper bound on the entry update date, exclusive.
Lower bound on the entry update date, inclusive.
An entry author. The service returns entries where the author name and/or e-mail address match your query string.