Blame docs/reference/html/GDataQuery.html

Packit 4b6dd7
Packit 4b6dd7
<html>
Packit 4b6dd7
<head>
Packit 4b6dd7
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit 4b6dd7
<title>GDataQuery: GData Reference Manual</title>
Packit 4b6dd7
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
Packit 4b6dd7
<link rel="home" href="index.html" title="GData Reference Manual">
Packit 4b6dd7
<link rel="up" href="ch02.html" title="Core API">
Packit 4b6dd7
<link rel="prev" href="GDataService.html" title="GDataService">
Packit 4b6dd7
<link rel="next" href="GDataFeed.html" title="GDataFeed">
Packit 4b6dd7
<meta name="generator" content="GTK-Doc V1.26.1 (XML mode)">
Packit 4b6dd7
<link rel="stylesheet" href="style.css" type="text/css">
Packit 4b6dd7
</head>
Packit 4b6dd7
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Top  | 
Packit 4b6dd7
                  Description  | 
Packit 4b6dd7
                  Object Hierarchy  | 
Packit 4b6dd7
                  Properties
Packit 4b6dd7
Packit 4b6dd7
Home
Packit 4b6dd7
Up
Packit 4b6dd7
Prev
Packit 4b6dd7
Next
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

GDataQuery

Packit 4b6dd7

GDataQuery — GData query object

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Stability Level

Packit 4b6dd7
Packit 4b6dd7
develop applications to these interfaces, release them, and have confidence that
Packit 4b6dd7
they will run on all minor releases of the product (after the one in which the
Packit 4b6dd7
interface was introduced, and within the same major release). Even at a major
Packit 4b6dd7
release, incompatible changes are expected to be rare, and to have strong
Packit 4b6dd7
justifications.
Packit 4b6dd7
">Stable, unless otherwise indicated
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Functions

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GDataQuery *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_new ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
GDataQuery *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_new_with_limits ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gchar *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_get_query_uri ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_next_page ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gboolean
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_previous_page ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
const gchar *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_get_q ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_set_q ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
const gchar *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_get_etag ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_set_etag ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
const gchar *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_get_author ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_set_author ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
const gchar *
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_get_categories ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_set_categories ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gint64
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_get_published_min ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_set_published_min ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gint64
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_get_published_max ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_set_published_max ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gint64
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_get_updated_min ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_set_updated_min ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gint64
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_get_updated_max ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_set_updated_max ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
guint
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_get_start_index ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_set_start_index ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
guint
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_get_max_results ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_set_max_results ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gboolean
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_is_strict ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
void
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gdata_query_set_is_strict ()
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Properties

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gchar *
Packit 4b6dd7
author
Packit 4b6dd7
Read / Write
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gchar *
Packit 4b6dd7
categories
Packit 4b6dd7
Read / Write
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gchar *
Packit 4b6dd7
etag
Packit 4b6dd7
Read / Write
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gboolean
Packit 4b6dd7
is-strict
Packit 4b6dd7
Read / Write
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
guint
Packit 4b6dd7
max-results
Packit 4b6dd7
Read / Write
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gint64
Packit 4b6dd7
published-max
Packit 4b6dd7
Read / Write
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gint64
Packit 4b6dd7
published-min
Packit 4b6dd7
Read / Write
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gchar *
Packit 4b6dd7
q
Packit 4b6dd7
Read / Write
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
guint
Packit 4b6dd7
start-index
Packit 4b6dd7
Read / Write
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gint64
Packit 4b6dd7
updated-max
Packit 4b6dd7
Read / Write
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
gint64
Packit 4b6dd7
updated-min
Packit 4b6dd7
Read / Write
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Types and Values

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
GDataQuery
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
 
Packit 4b6dd7
GDataQueryClass
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Object Hierarchy

Packit 4b6dd7
    GObject
Packit 4b6dd7
    ╰── GDataQuery
Packit 4b6dd7
        ├── GDataCalendarQuery
Packit 4b6dd7
        ├── GDataContactsQuery
Packit 4b6dd7
        ├── GDataDocumentsQuery
Packit 4b6dd7
        ├── GDataFreebaseQuery
Packit 4b6dd7
        ├── GDataFreebaseSearchQuery
Packit 4b6dd7
        ├── GDataFreebaseTopicQuery
Packit 4b6dd7
        ├── GDataPicasaWebQuery
Packit 4b6dd7
        ├── GDataTasksQuery
Packit 4b6dd7
        ╰── GDataYouTubeQuery
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Includes

Packit 4b6dd7
#include <gdata/gdata-query.h>
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Description

Packit 4b6dd7

GDataQuery represents a collection of query parameters used in a series of queries on a GDataService. It allows the query parameters to be

Packit 4b6dd7
set, with the aim of building a query URI using gdata_query_get_query_uri(). Pagination is supported using gdata_query_next_page() and
Packit 4b6dd7
gdata_query_previous_page().

Packit 4b6dd7

Each query can have an ETag associated with it, which is a unique identifier for the set of query results produced by the query.

Packit 4b6dd7
Each time a query is made, gdata_service_query() will set the “etag” property of the accompanying query to a value returned by the
Packit 4b6dd7
server. If the same query is made again (using the same GDataQuery instance), the server can skip returning the resulting GDataFeed if its
Packit 4b6dd7
contents haven't changed (in this case, gdata_service_query() will return NULL with an empty error).

Packit 4b6dd7

For this reason, code using GDataQuery should be careful when reusing GDataQuery instances: the code should either unset “etag” after

Packit 4b6dd7
every query or (preferably) gracefully handle the case where gdata_service_query() returns NULL to signify unchanged results.

Packit 4b6dd7

Every time a property of a GDataQuery instance is changed, the instance's ETag will be unset.

Packit 4b6dd7

For more information on the standard GData query parameters supported by GDataQuery, see the online documentation.

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Functions

Packit 4b6dd7
Packit 4b6dd7

gdata_query_new ()

Packit 4b6dd7
GDataQuery *
Packit 4b6dd7
gdata_query_new (const gchar *q);
Packit 4b6dd7

Creates a new GDataQuery with its “q” property set to q

Packit 4b6dd7
.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

q

Packit 4b6dd7

a query string, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

a new GDataQuery

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_new_with_limits ()

Packit 4b6dd7
GDataQuery *
Packit 4b6dd7
gdata_query_new_with_limits (const gchar *q,
Packit 4b6dd7
                             guint start_index,
Packit 4b6dd7
                             guint max_results);
Packit 4b6dd7

Creates a new GDataQuery with its “q” property set to q

Packit 4b6dd7
, and the limits start_index
Packit 4b6dd7
 and max_results
Packit 4b6dd7
Packit 4b6dd7
applied.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

q

Packit 4b6dd7

a query string, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

start_index

Packit 4b6dd7

a one-based start index for the results, or 0

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

max_results

Packit 4b6dd7

the maximum number of results to return, or 0

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

a new GDataQuery

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_get_query_uri ()

Packit 4b6dd7
gchar *
Packit 4b6dd7
gdata_query_get_query_uri (GDataQuery *self,
Packit 4b6dd7
                           const gchar *feed_uri);
Packit 4b6dd7

Builds a query URI from the given base feed URI, using the properties of the GDataQuery. This function will take care

Packit 4b6dd7
of all necessary URI escaping, so it should not be done beforehand.

Packit 4b6dd7

The query URI is what functions like gdata_service_query() use to query the online service.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

feed_uri

Packit 4b6dd7

the feed URI on which to build the query URI

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

a query URI; free with g_free()

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_next_page ()

Packit 4b6dd7
void
Packit 4b6dd7
gdata_query_next_page (GDataQuery *self);
Packit 4b6dd7

Changes the state of the GDataQuery such that when gdata_query_get_query_uri() is next called, it will build the

Packit 4b6dd7
query URI for the next page in the result set.

Packit 4b6dd7

Ideally, the URI of the next page is retrieved from a feed automatically when gdata_service_query() is called, but

Packit 4b6dd7
gdata_query_next_page() will fall back to using “start-index” to emulate true pagination if this fails.

Packit 4b6dd7

You should not implement pagination manually using “start-index”.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_previous_page ()

Packit 4b6dd7
gboolean
Packit 4b6dd7
gdata_query_previous_page (GDataQuery *self);
Packit 4b6dd7

Changes the state of the GDataQuery such that when gdata_query_get_query_uri() is next called, it will build the

Packit 4b6dd7
query URI for the previous page in the result set.

Packit 4b6dd7

See the documentation for gdata_query_next_page() for an explanation of how query URIs from the feeds are used to this end.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

TRUE if there is a previous page and it has been switched to, FALSE otherwise

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_get_q ()

Packit 4b6dd7
const gchar *
Packit 4b6dd7
gdata_query_get_q (GDataQuery *self);
Packit 4b6dd7

Gets the “q” property.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the q property, or NULL if it is unset

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_set_q ()

Packit 4b6dd7
void
Packit 4b6dd7
gdata_query_set_q (GDataQuery *self,
Packit 4b6dd7
                   const gchar *q);
Packit 4b6dd7

Sets the “q” property of the GDataQuery to the new query string, q

Packit 4b6dd7
.

Packit 4b6dd7

Set q

Packit 4b6dd7
 to NULL to unset the property in the query URI.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

q

Packit 4b6dd7

a new query string, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_get_etag ()

Packit 4b6dd7
const gchar *
Packit 4b6dd7
gdata_query_get_etag (GDataQuery *self);
Packit 4b6dd7

Gets the “etag” property.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the ETag property, or NULL if it is unset

Packit 4b6dd7
Packit 4b6dd7

Since: 0.2.0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_set_etag ()

Packit 4b6dd7
void
Packit 4b6dd7
gdata_query_set_etag (GDataQuery *self,
Packit 4b6dd7
                      const gchar *etag);
Packit 4b6dd7

Sets the “etag” property of the GDataQuery to the new ETag, etag

Packit 4b6dd7
.

Packit 4b6dd7

Set etag

Packit 4b6dd7
 to NULL to not check against the server-side ETag.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

etag

Packit 4b6dd7

the new ETag, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Since: 0.2.0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_get_author ()

Packit 4b6dd7
const gchar *
Packit 4b6dd7
gdata_query_get_author (GDataQuery *self);
Packit 4b6dd7

Gets the “author” property.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the author property, or NULL if it is unset

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_set_author ()

Packit 4b6dd7
void
Packit 4b6dd7
gdata_query_set_author (GDataQuery *self,
Packit 4b6dd7
                        const gchar *author);
Packit 4b6dd7

Sets the “author” property of the GDataQuery to the new author string, author

Packit 4b6dd7
.

Packit 4b6dd7

Set author

Packit 4b6dd7
 to NULL to unset the property in the query URI.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

author

Packit 4b6dd7

the new author string, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_get_categories ()

Packit 4b6dd7
const gchar *
Packit 4b6dd7
gdata_query_get_categories (GDataQuery *self);
Packit 4b6dd7

Gets the “categories” property.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the categories property, or NULL if it is unset

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_set_categories ()

Packit 4b6dd7
void
Packit 4b6dd7
gdata_query_set_categories (GDataQuery *self,
Packit 4b6dd7
                            const gchar *categories);
Packit 4b6dd7

Sets the “categories” property of the GDataQuery to the new category string, categories

Packit 4b6dd7
.

Packit 4b6dd7

Set categories

Packit 4b6dd7
 to NULL to unset the property in the query URI.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

categories

Packit 4b6dd7

the new category string, or NULL.

Packit 4b6dd7
[allow-none]
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_get_published_min ()

Packit 4b6dd7
gint64
Packit 4b6dd7
gdata_query_get_published_min (GDataQuery *self);
Packit 4b6dd7

Gets the “published-min” property. If the property is unset, -1 will be returned.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the published-min property, or -1

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_set_published_min ()

Packit 4b6dd7
void
Packit 4b6dd7
gdata_query_set_published_min (GDataQuery *self,
Packit 4b6dd7
                               gint64 published_min);
Packit 4b6dd7

Sets the “published-min” property of the GDataQuery to the new minimum publish time, published_min

Packit 4b6dd7
.

Packit 4b6dd7

Set published_min

Packit 4b6dd7
 to -1 to unset the property in the query URI.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

published_min

Packit 4b6dd7

the new minimum publish time, or -1

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_get_published_max ()

Packit 4b6dd7
gint64
Packit 4b6dd7
gdata_query_get_published_max (GDataQuery *self);
Packit 4b6dd7

Gets the “published-max” property. If the property is unset, -1 will be returned.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the published-max property, or -1

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_set_published_max ()

Packit 4b6dd7
void
Packit 4b6dd7
gdata_query_set_published_max (GDataQuery *self,
Packit 4b6dd7
                               gint64 published_max);
Packit 4b6dd7

Sets the “published-max” property of the GDataQuery to the new maximum publish time, published_max

Packit 4b6dd7
.

Packit 4b6dd7

Set published_max

Packit 4b6dd7
 to -1 to unset the property in the query URI.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

published_max

Packit 4b6dd7

the new maximum publish time, or -1

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_get_updated_min ()

Packit 4b6dd7
gint64
Packit 4b6dd7
gdata_query_get_updated_min (GDataQuery *self);
Packit 4b6dd7

Gets the “updated-min” property. If the property is unset, -1 will be returned.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the updated-min property, or -1

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_set_updated_min ()

Packit 4b6dd7
void
Packit 4b6dd7
gdata_query_set_updated_min (GDataQuery *self,
Packit 4b6dd7
                             gint64 updated_min);
Packit 4b6dd7

Sets the “updated-min” property of the GDataQuery to the new minimum update time, updated_min

Packit 4b6dd7
.

Packit 4b6dd7

Set updated_min

Packit 4b6dd7
 to -1 to unset the property in the query URI.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

updated_min

Packit 4b6dd7

the new minimum update time, or -1

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_get_updated_max ()

Packit 4b6dd7
gint64
Packit 4b6dd7
gdata_query_get_updated_max (GDataQuery *self);
Packit 4b6dd7

Gets the “updated-max” property. If the property is unset, -1 will be returned.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the updated-max property, or -1

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_set_updated_max ()

Packit 4b6dd7
void
Packit 4b6dd7
gdata_query_set_updated_max (GDataQuery *self,
Packit 4b6dd7
                             gint64 updated_max);
Packit 4b6dd7

Sets the “updated-max” property of the GDataQuery to the new maximum update time, updated_max

Packit 4b6dd7
.

Packit 4b6dd7

Set updated_max

Packit 4b6dd7
 to -1 to unset the property in the query URI.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

updated_max

Packit 4b6dd7

the new maximum update time, or -1

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_get_start_index ()

Packit 4b6dd7
guint
Packit 4b6dd7
gdata_query_get_start_index (GDataQuery *self);
Packit 4b6dd7

Gets the “start-index” property.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the start index property, or 0 if it is unset

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_set_start_index ()

Packit 4b6dd7
void
Packit 4b6dd7
gdata_query_set_start_index (GDataQuery *self,
Packit 4b6dd7
                             guint start_index);
Packit 4b6dd7

Sets the “start-index” property of the GDataQuery to the new one-based start index, start_index

Packit 4b6dd7
.

Packit 4b6dd7

Set start_index

Packit 4b6dd7
 to 0 to unset the property in the query URI.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

start_index

Packit 4b6dd7

the new start index, or 0

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_get_max_results ()

Packit 4b6dd7
guint
Packit 4b6dd7
gdata_query_get_max_results (GDataQuery *self);
Packit 4b6dd7

Gets the “max-results” property.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the maximum results property, or 0 if it is unset

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_set_max_results ()

Packit 4b6dd7
void
Packit 4b6dd7
gdata_query_set_max_results (GDataQuery *self,
Packit 4b6dd7
                             guint max_results);
Packit 4b6dd7

Sets the “max-results” property of the GDataQuery to the new maximum results value, max_results

Packit 4b6dd7
.

Packit 4b6dd7

Set max_results

Packit 4b6dd7
 to 0 to unset the property in the query URI.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

max_results

Packit 4b6dd7

the new maximum results value, or 0

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_is_strict ()

Packit 4b6dd7
gboolean
Packit 4b6dd7
gdata_query_is_strict (GDataQuery *self);
Packit 4b6dd7

Gets the “is-strict” property.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Returns

Packit 4b6dd7

the strict property

Packit 4b6dd7
Packit 4b6dd7

Since: 0.2.0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

gdata_query_set_is_strict ()

Packit 4b6dd7
void
Packit 4b6dd7
gdata_query_set_is_strict (GDataQuery *self,
Packit 4b6dd7
                           gboolean is_strict);
Packit 4b6dd7

Sets the “is-strict” property of the GDataQuery to the new strict value, is_strict

Packit 4b6dd7
.

Packit 4b6dd7
Packit 4b6dd7

Parameters

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

self

Packit 4b6dd7

a GDataQuery

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

is_strict

Packit 4b6dd7

the new strict value

Packit 4b6dd7
 
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Since: 0.2.0

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Types and Values

Packit 4b6dd7
Packit 4b6dd7

GDataQuery

Packit 4b6dd7
typedef struct _GDataQuery GDataQuery;
Packit 4b6dd7

All the fields in the GDataQuery structure are private and should never be accessed directly.

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

GDataQueryClass

Packit 4b6dd7
typedef struct {
Packit 4b6dd7
} GDataQueryClass;
Packit 4b6dd7
Packit 4b6dd7

All the fields in the GDataQueryClass structure are private and should never be accessed directly.

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Property Details

Packit 4b6dd7
Packit 4b6dd7

The “author” property

Packit 4b6dd7
  “author”                   gchar *
Packit 4b6dd7

An entry author. The service returns entries where the author name and/or e-mail address match your query string.

Packit 4b6dd7

Flags: Read / Write

Packit 4b6dd7

Default value: NULL

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

The “categories” property

Packit 4b6dd7
  “categories”               gchar *
Packit 4b6dd7

A category filter.

Packit 4b6dd7

You can query on multiple categories by listing multiple categories separated by slashes. The service returns all entries that match all

Packit 4b6dd7
of the categories (like using AND between terms). For example: Fritz/Laurie returns
Packit 4b6dd7
entries that match both categories ("Fritz" and "Laurie").

Packit 4b6dd7

To do an OR between terms, use a pipe character (|). For example: Fritz%7CLaurie returns

Packit 4b6dd7
entries that match either category.

Packit 4b6dd7

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

Packit 4b6dd7
specification. (Roughly, the "term" is the internal string used by the software to identify the category, while the "label" is the
Packit 4b6dd7
human-readable string presented to a user in a user interface.)

Packit 4b6dd7

To exclude entries that match a given category, use the form -categoryname.

Packit 4b6dd7

To query for a category that has a scheme – such as <category scheme="urn:google.com" term="public"/> – you must

Packit 4b6dd7
place the scheme in curly braces before the category name. For example: {urn:google.com}public. To match a category
Packit 4b6dd7
that has no scheme, use an empty pair of curly braces. If you don't specify curly braces, then categories in any scheme will match.

Packit 4b6dd7

The above features can be combined. For example: A|-{urn:google.com}B/-C means (A OR (NOT B)) AND (NOT C).

Packit 4b6dd7

Flags: Read / Write

Packit 4b6dd7

Default value: NULL

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

The “etag” property

Packit 4b6dd7
  “etag”                     gchar *
Packit 4b6dd7

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

Packit 4b6dd7
returned unnecessarily.

Packit 4b6dd7

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

Packit 4b6dd7
query, it must be set again using gdata_query_set_etag() after setting any other properties.

Packit 4b6dd7

Flags: Read / Write

Packit 4b6dd7

Default value: NULL

Packit 4b6dd7

Since: 0.2.0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

The “is-strict” property

Packit 4b6dd7
  “is-strict”                gboolean
Packit 4b6dd7

Strict query parameter checking. If this is enabled, an error will be returned by the online service if a parameter is

Packit 4b6dd7
not recognised.

Packit 4b6dd7

Flags: Read / Write

Packit 4b6dd7

Default value: FALSE

Packit 4b6dd7

Since: 0.2.0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

The “max-results” property

Packit 4b6dd7
  “max-results”              guint
Packit 4b6dd7

Maximum number of results to be retrieved. Most services have a default “max-results” size imposed by the server; if you wish

Packit 4b6dd7
to receive the entire feed, specify a large number such as G_MAXUINT for this property.

Packit 4b6dd7

Use 0 to not specify a maximum number of results.

Packit 4b6dd7

Flags: Read / Write

Packit 4b6dd7

Default value: 0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

The “published-max” property

Packit 4b6dd7
  “published-max”            gint64
Packit 4b6dd7

Upper bound on the entry publish date, exclusive.

Packit 4b6dd7

Flags: Read / Write

Packit 4b6dd7

Allowed values: >= -1

Packit 4b6dd7

Default value: -1

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

The “published-min” property

Packit 4b6dd7
  “published-min”            gint64
Packit 4b6dd7

Lower bound on the entry publish date, inclusive.

Packit 4b6dd7

Flags: Read / Write

Packit 4b6dd7

Allowed values: >= -1

Packit 4b6dd7

Default value: -1

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

The “q” property

Packit 4b6dd7
  “q”                        gchar *
Packit 4b6dd7

A full-text query string.

Packit 4b6dd7

When creating a query, list search terms separated by spaces, in the form term1 term2 term3.

Packit 4b6dd7
(As with all of the query parameter values, the spaces must be URL encoded.) The service returns all entries that match all of the
Packit 4b6dd7
search terms (like using AND between terms). Like Google's web search, a service searches on complete words (and related words with
Packit 4b6dd7
the same stem), not substrings.

Packit 4b6dd7

To search for an exact phrase, enclose the phrase in quotation marks: "exact phrase".

Packit 4b6dd7

To exclude entries that match a given term, use the form -term.

Packit 4b6dd7

The search is case-insensitive.

Packit 4b6dd7

Example: to search for all entries that contain the exact phrase "Elizabeth Bennet" and the word "Darcy" but don't contain the

Packit 4b6dd7
word "Austen", use the following query: "Elizabeth Bennet" Darcy -Austen.

Packit 4b6dd7

Flags: Read / Write

Packit 4b6dd7

Default value: NULL

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

The “start-index” property

Packit 4b6dd7
  “start-index”              guint
Packit 4b6dd7

The one-based index of the first result to be retrieved. Use gdata_query_next_page() and gdata_query_previous_page() to

Packit 4b6dd7
implement pagination, rather than manually changing “start-index”.

Packit 4b6dd7

Use 0 to not specify a start index.

Packit 4b6dd7

Flags: Read / Write

Packit 4b6dd7

Default value: 0

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

The “updated-max” property

Packit 4b6dd7
  “updated-max”              gint64
Packit 4b6dd7

Upper bound on the entry update date, exclusive.

Packit 4b6dd7

Flags: Read / Write

Packit 4b6dd7

Allowed values: >= -1

Packit 4b6dd7

Default value: -1

Packit 4b6dd7
Packit 4b6dd7

Packit 4b6dd7
Packit 4b6dd7

The “updated-min” property

Packit 4b6dd7
  “updated-min”              gint64
Packit 4b6dd7

Lower bound on the entry update date, inclusive.

Packit 4b6dd7

Flags: Read / Write

Packit 4b6dd7

Allowed values: >= -1

Packit 4b6dd7

Default value: -1

Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7
Packit 4b6dd7

Generated by GTK-Doc V1.26.1
Packit 4b6dd7
</body>
Packit 4b6dd7
</html>