Top |
Functions
GDataFreebaseTopicQuery * | gdata_freebase_topic_query_new () |
void | gdata_freebase_topic_query_set_filter () |
const gchar * const * | gdata_freebase_topic_query_get_filter () |
void | gdata_freebase_topic_query_set_language () |
const gchar * | gdata_freebase_topic_query_get_language () |
Description
GDataFreebaseTopicQuery represents a Freebase topic query. The topic query happens on a single Freebase ID,
given in gdata_freebase_topic_query_new()
, the reply returns all known information in Freebase for that given ID.
For more documentation and examples, see the
Topic response API documentation
This implementation of GDataQuery respects the gdata_query_set_max_results()
and gdata_query_set_updated_max()
calls.
For more details of Google Freebase API, see the online documentation.
Functions
gdata_freebase_topic_query_new ()
GDataFreebaseTopicQuery *
gdata_freebase_topic_query_new (const gchar *id
);
Creates a new GDataFreebaseTopicQuery for the given Freebase ID. Those can be
obtained programmatically through gdata_freebase_search_result_item_get_id()
or
embedded in the result of a gdata_freebase_service_query()
call.
Since 0.15.1
gdata_freebase_topic_query_set_filter ()
void gdata_freebase_topic_query_set_filter (GDataFreebaseTopicQuery *self
,const gchar * const *filter
);
Sets a filter on the properties to be returned by the GDataFreebaseTopicQuery, a filter string usually contains either a specific property (eg. "/common/topic/description", or "/computer/software/first_released"), or a property domain (eg. "/common/topic", or "/computer"), all properties pertaining to the domain will be returned through the GDataFreebaseTopicResult in the latter case. Other special strings can be passed as filter strings, those are documented in the Topic API overview
If multiple filter strings are set, the result will contain all information necessary to satisfy each of those individually. If no filter is set, the "commons" special value will be implicitly assumed, which returns a reasonably complete data set.
Since 0.15.1
gdata_freebase_topic_query_get_filter ()
const gchar * const *
gdata_freebase_topic_query_get_filter (GDataFreebaseTopicQuery *self
);
Gets the filter set on the topic query, or NULL
if unset.
Since 0.15.1
gdata_freebase_topic_query_set_language ()
void gdata_freebase_topic_query_set_language (GDataFreebaseTopicQuery *self
,const gchar *lang
);
Sets the language used in the topic query. If unset, the locale preferences will be respected.
Parameters
self |
||
lang |
language used on the topic query, in ISO-639-1 format, or |
[allow-none] |
Since 0.15.1
gdata_freebase_topic_query_get_language ()
const gchar *
gdata_freebase_topic_query_get_language
(GDataFreebaseTopicQuery *self
);
Gets the language set on the topic query, or NULL
if unset.
Since 0.15.1
Types and Values
GDataFreebaseTopicQuery
typedef struct _GDataFreebaseTopicQuery GDataFreebaseTopicQuery;
All the fields in the GDataFreebaseTopicQuery structure are private and should never be accessed directly.
Since 0.15.1
GDataFreebaseTopicQueryClass
typedef struct { } GDataFreebaseTopicQueryClass;
All the fields in the GDataFreebaseTopicQueryClass structure are private and should never be accessed directly.
Since 0.15.1
Property Details
The “filter”
property
“filter” GStrv
Array of properties (eg. "/common/topic/description", or "/computer/software/first_released"), or property domains (eg. "/common/topic", or "/computer") to be used as filter.
Flags: Read / Write
Since 0.15.1
The “language”
property
“language” gchar *
Language used for topic values in the result, in ISO-639-1 format.
Flags: Read / Write
Default value: NULL
Since 0.15.1