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 comma-separated list of image sizes (width in pixels) to return. Only certain sizes are allowed, and whether the image should be
cropped or scaled can be specified; for more information, see the
Strict query parameter checking. If this is enabled, an error will be returned by the online service if a parameter is not recognised.
A location to search for photos, e.g. "London".
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:
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.
A tag which returned results must contain.
A comma-separated list of thumbnail widths (in pixels) to return. Only certain sizes are allowed, and whether the thumbnail should be
cropped or scaled can be specified; for more information, see the
Upper bound on the entry update date, exclusive.
Lower bound on the entry update date, inclusive.
Specifies which albums should be listed, in terms of their visibility (#GDataPicasaWebAlbum:visibility).
Set the property to 0 to list all albums, regardless of their visibility. Otherwise, use values
from #GDataPicasaWebVisibility.
For more information, see the
An entry author. The service returns entries where the author name and/or e-mail address match your query string.