manpagez: man pages & more
html files: gdata
Home | html | info | man

GDataFreebaseTopicQuery

GDataFreebaseTopicQuery — GData Freebase topic query object

Stability Level

Stable, unless otherwise indicated

Properties

GStrv filter Read / Write
gchar * language Read / Write

Object Hierarchy

    GObject
    ╰── GDataQuery
        ╰── GDataFreebaseTopicQuery

Includes

#include <gdata/services/freebase/gdata-freebase-topic-query.h>

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);

gdata_freebase_topic_query_new has been deprecated since version 0.17.7 and should not be used in newly-written code.

Google Freebase has been permanently shut down.

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.

Parameters

id

a Freebase ID or MID

 

Returns

a new GDataFreebaseTopicQuery.

[transfer full]

Since: 0.15.1


gdata_freebase_topic_query_set_filter ()

void
gdata_freebase_topic_query_set_filter (GDataFreebaseTopicQuery *self,
                                       const gchar * const *filter);

gdata_freebase_topic_query_set_filter has been deprecated since version 0.17.7 and should not be used in newly-written code.

Google Freebase has been permanently shut down.

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.

Parameters

self

a GDataFreebaseTopicQuery

 

filter

NULL-terminated array of filter strings, or NULL to unset.

[array zero-terminated=1][allow-none]

Since: 0.15.1


gdata_freebase_topic_query_get_filter ()

const gchar * const *
gdata_freebase_topic_query_get_filter (GDataFreebaseTopicQuery *self);

gdata_freebase_topic_query_get_filter has been deprecated since version 0.17.7 and should not be used in newly-written code.

Google Freebase has been permanently shut down.

Gets the filter set on the topic query, or NULL if unset.

Parameters

Returns

The filter used on the query.

[array zero-terminated=1][transfer none][allow-none]

Since: 0.15.1


gdata_freebase_topic_query_set_language ()

void
gdata_freebase_topic_query_set_language
                               (GDataFreebaseTopicQuery *self,
                                const gchar *lang);

gdata_freebase_topic_query_set_language has been deprecated since version 0.17.7 and should not be used in newly-written code.

Google Freebase has been permanently shut down.

Sets the language used in the topic query. If unset, the locale preferences will be respected.

Parameters

self

a GDataFreebaseTopicQuery

 

lang

language used on the topic query, in ISO-639-1 format, or NULL to unset the language.

[allow-none]

Since: 0.15.1


gdata_freebase_topic_query_get_language ()

const gchar *
gdata_freebase_topic_query_get_language
                               (GDataFreebaseTopicQuery *self);

gdata_freebase_topic_query_get_language has been deprecated since version 0.17.7 and should not be used in newly-written code.

Google Freebase has been permanently shut down.

Gets the language set on the topic query, or NULL if unset.

Parameters

Returns

The language used on the query.

[allow-none]

Since: 0.15.1

Types and Values

GDataFreebaseTopicQuery

typedef struct _GDataFreebaseTopicQuery GDataFreebaseTopicQuery;

GDataFreebaseTopicQuery is deprecated and should not be used in newly-written code.

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

Since: 0.15.1


GDataFreebaseTopicQueryClass

typedef struct {
} GDataFreebaseTopicQueryClass;

GDataFreebaseTopicQueryClass is deprecated and should not be used in newly-written code.

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.

GDataFreebaseTopicQuery:filter has been deprecated since version 0.17.7 and should not be used in newly-written code.

Google Freebase has been permanently shut down.

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.

GDataFreebaseTopicQuery:language has been deprecated since version 0.17.7 and should not be used in newly-written code.

Google Freebase has been permanently shut down.

Flags: Read / Write

Default value: NULL

Since: 0.15.1

© manpagez.com 2000-2024
Individual documents may contain additional copyright information.