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:
Upper bound for a task's completion date (as a RFC 3339 timestamp) to filter by. Optional. The default is not to filter by completion date.
Lower bound for a task's completion date (as a RFC 3339 timestamp) to filter by. Optional. The default is not to filter by completion date.
Upper bound for a task's due date (as a RFC 3339 timestamp) to filter by. Optional. The default is not to filter by completion date.
Lower bound for a task's due date (as a RFC 3339 timestamp) to filter by. Optional. The default is not to filter by completion date.
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.
Strict query parameter checking. If this is enabled, an error will be returned by the online service if a parameter is not recognised.
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.
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:
Flag indicating whether completed tasks are returned in the result. Optional. The default is %FALSE.
Flag indicating whether deleted tasks are returned in the result. Optional. The default is %FALSE.
Flag indicating whether hidden tasks are returned in the result. Optional. The default is %FALSE.
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.
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.