gdata_youtube_query_new ()

GDataYouTubeQuery *
gdata_youtube_query_new (const gchar *q);

Creates a new GDataYouTubeQuery with its “q” property set to q .

Since: 0.3.0

gdata_youtube_query_get_age ()

GDataYouTubeAge
gdata_youtube_query_get_age (GDataYouTubeQuery *self);

Gets the “age” property.

Since: 0.3.0

gdata_youtube_query_set_age ()

void
gdata_youtube_query_set_age (GDataYouTubeQuery *self,
                             GDataYouTubeAge age);

Sets the “age” property of the GDataYouTubeQuery to age .

Since: 0.3.0

gdata_youtube_query_get_format ()

GDataYouTubeFormat
gdata_youtube_query_get_format (GDataYouTubeQuery *self);

Gets the “format” property.

Since: 0.3.0

gdata_youtube_query_set_format ()

void
gdata_youtube_query_set_format (GDataYouTubeQuery *self,
                                GDataYouTubeFormat format);

Sets the “format” property of the GDataYouTubeQuery to format .

Since: 0.3.0

gdata_youtube_query_get_language ()

const gchar *
gdata_youtube_query_get_language (GDataYouTubeQuery *self);

Gets the “language” property.

Since: 0.3.0

gdata_youtube_query_set_language ()

void
gdata_youtube_query_set_language (GDataYouTubeQuery *self,
                                  const gchar *language);

Sets the “language” property of the GDataYouTubeQuery to the new language, language .

Set language to NULL to unset the property in the query URI.

Since: 0.3.0

gdata_youtube_query_get_license ()

const gchar *
gdata_youtube_query_get_license (GDataYouTubeQuery *self);

Gets the “license” property.

Since: 0.11.0

gdata_youtube_query_set_license ()

void
gdata_youtube_query_set_license (GDataYouTubeQuery *self,
                                 const gchar *license);

Sets the “license” property of the GDataYouTubeQuery to the new license value, license .

Set license to NULL to unset the property in the query URI.

Since: 0.11.0

gdata_youtube_query_get_location ()

void
gdata_youtube_query_get_location (GDataYouTubeQuery *self,
                                  gdouble *latitude,
                                  gdouble *longitude,
                                  gdouble *radius,
                                  gboolean *has_location);

Gets the location-based properties of the GDataYouTubeQuery: “latitude”, “longitude”, “location-radius” and “has-location”.

Since: 0.3.0

gdata_youtube_query_set_location ()

void
gdata_youtube_query_set_location (GDataYouTubeQuery *self,
                                  gdouble latitude,
                                  gdouble longitude,
                                  gdouble radius,
                                  gboolean has_location);

Sets the location-based properties of the GDataYouTubeQuery: “latitude”, “longitude”, “location-radius” and “has-location”.

Since: 0.3.0

gdata_youtube_query_get_order_by ()

const gchar *
gdata_youtube_query_get_order_by (GDataYouTubeQuery *self);

Gets the “order-by” property.

Since: 0.3.0

gdata_youtube_query_set_order_by ()

void
gdata_youtube_query_set_order_by (GDataYouTubeQuery *self,
                                  const gchar *order_by);

Sets the “order-by” property of the GDataYouTubeQuery to the new order by string, order_by .

Set order_by to NULL to unset the property in the query URI.

Since: 0.3.0

gdata_youtube_query_get_restriction ()

const gchar *
gdata_youtube_query_get_restriction (GDataYouTubeQuery *self);

Gets the “restriction” property.

Since: 0.3.0

gdata_youtube_query_set_restriction ()

void
gdata_youtube_query_set_restriction (GDataYouTubeQuery *self,
                                     const gchar *restriction);

Sets the “restriction” property of the GDataYouTubeQuery to the new restriction string, restriction .

Set restriction to NULL to unset the property in the query URI.

Since: 0.3.0

gdata_youtube_query_get_safe_search ()

GDataYouTubeSafeSearch
gdata_youtube_query_get_safe_search (GDataYouTubeQuery *self);

Gets the “safe-search” property.

Since: 0.3.0

gdata_youtube_query_set_safe_search ()

void
gdata_youtube_query_set_safe_search (GDataYouTubeQuery *self,
                                     GDataYouTubeSafeSearch safe_search);

Sets the “safe-search” property of the GDataYouTubeQuery to safe_search .

Since: 0.3.0

gdata_youtube_query_get_sort_order ()

GDataYouTubeSortOrder
gdata_youtube_query_get_sort_order (GDataYouTubeQuery *self);

Gets the “sort-order” property.

Since: 0.3.0

gdata_youtube_query_set_sort_order ()

void
gdata_youtube_query_set_sort_order (GDataYouTubeQuery *self,
                                    GDataYouTubeSortOrder sort_order);

Sets the “sort-order” property of the GDataYouTubeQuery to sort_order .

Set sort_order to GDATA_YOUTUBE_SORT_NONE to unset the property in the query URI.

Since: 0.3.0

gdata_youtube_query_get_uploader ()

GDataYouTubeUploader
gdata_youtube_query_get_uploader (GDataYouTubeQuery *self);

Gets the “uploader” property.

Since: 0.3.0

gdata_youtube_query_set_uploader ()

void
gdata_youtube_query_set_uploader (GDataYouTubeQuery *self,
                                  GDataYouTubeUploader uploader);

Sets the “uploader” property of the GDataYouTubeQuery to uploader .

Since: 0.3.0

GDataYouTubeQuery

typedef struct _GDataYouTubeQuery GDataYouTubeQuery;

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

Since: 0.3.0

GDataYouTubeQueryClass

typedef struct {
} GDataYouTubeQueryClass;

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

Since: 0.3.0

enum GDataYouTubeAge

Video ages, allowing queries to be limited to videos uploaded in a recent time period.

Since: 0.3.0

enum GDataYouTubeFormat

Video formats available on YouTube. For more information, see the

Since: 0.3.0

enum GDataYouTubeSafeSearch

Safe search levels for removing restricted entries from query results. For more information, see the

Since: 0.3.0

enum GDataYouTubeSortOrder

Sort orders for the search results from queries. They specify the order of the designated order field.

Since: 0.3.0

enum GDataYouTubeUploader

Video uploaders, allowing queries to be limited to returning videos uploaded by YouTube partners.

Since: 0.3.0

The “age” property

  “age”                      GDataYouTubeAge

Restricts the search to videos uploaded within the specified time period. To retrieve videos irrespective of their age, set the property to GDATA_YOUTUBE_AGE_ALL_TIME.

Flags: Read / Write

Default value: GDATA_YOUTUBE_AGE_ALL_TIME

Since: 0.3.0

The “format” property

  “format”                   GDataYouTubeFormat

Specifies that videos must be available in a particular video format. Use GDATA_YOUTUBE_FORMAT_UNKNOWN to retrieve videos irrespective of their format availability.

Flags: Read / Write

Default value: GDATA_YOUTUBE_FORMAT_UNKNOWN

Since: 0.3.0

The “has-location” property

  “has-location”             gboolean

Whether to restrict search results to videos with specific coordinates associated with them. If used with a given “latitude” and “longitude”, only videos with specific coordinates (not those with merely a descriptive address) will be returned. If used without a latitude and longitude set, only videos with specific coordinates (regardless of those coordinates) will be returned.

For more information, see the documentation for “latitude”.

Flags: Read / Write

Default value: FALSE

Since: 0.3.0

The “language” property

  “language”                 gchar *

Restricts the search to videos that have a title, description or keywords in a specified language. The language code should be a two-letter ISO 639-1 code; or you can use zh-Hans for simplified Chinese and zh-Hant for traditional Chinese.

For more information, see the online documentation.

Flags: Read / Write

Default value: NULL

Since: 0.3.0

The “latitude” property

  “latitude”                 gdouble

The latitude of a particular location of which videos should be found. This should be used in conjunction with “longitude”; if either property is outside the valid range, neither will be used. Valid latitudes are between -90 and 900 degrees; any values of this property outside that range will unset the property in the query URI.

If “location-radius” is a non-0 value, this will define a circle from which videos should be found.

As it is deprecated, the value of “has-location” is ignored.

For more information, see the online documentation.

Flags: Read / Write

Default value: 1.79769e+308

Since: 0.3.0

The “license” property

  “license”                  gchar *

The content license which should be used to filter search results. If set to, for example, GDATA_YOUTUBE_LICENSE_CC, only videos which are Creative Commons licensed will be returned in search results. Set this to NULL to return videos under any license.

For more information, see the online documentation.

Flags: Read / Write

Default value: NULL

Since: 0.11.0

The “location-radius” property

  “location-radius”          gdouble

The radius, in metres, of a circle from within which videos should be returned. The circle is centred on the latitude and longitude given in “latitude” and “longitude”.

Set this property to 0 to search for specific coordinates, rather than within a given radius.

For more information, see the documentation for “latitude”.

Flags: Read / Write

Allowed values: >= 0

Default value: 0

Since: 0.3.0

The “longitude” property

  “longitude”                gdouble

The longitude of a particular location of which videos should be found. This should be used in conjunction with “latitude”; if either property is outside the valid range, neither will be used. Valid longitudes are between -180 and 180 degrees; any values of this property outside that range will unset the property in the query URI.

For more information, see the documentation for “latitude”.

Flags: Read / Write

Default value: 1.79769e+308

Since: 0.3.0

The “order-by” property

  “order-by”                 gchar *

Specifies the order of entries in a feed. Supported values are relevance, published, viewCount and rating.

Additionally, results most relevant to a specific language can be returned by setting the property to relevance_lang_languageCode, where languageCode is an ISO 639-1 language code, as used in “language”.

For more information, see the online documentation.

Flags: Read / Write

Default value: NULL

Since: 0.3.0

The “restriction” property

  “restriction”              gchar *

An ISO 3166 two-letter country code that should be used to filter videos playable only in specific countries.

Previously, this property could also accept the client’s IP address for country lookup. This feature is no longer supported by Google, and will result in an error from the server if used. Use a country code instead.

For more information, see the online documentation.

Flags: Read / Write

Default value: NULL

Since: 0.3.0

The “safe-search” property

  “safe-search”              GDataYouTubeSafeSearch

Whether the search results should include restricted content as well as standard content.

For more information, see the online documentation.

Flags: Read / Write

Default value: GDATA_YOUTUBE_SAFE_SEARCH_MODERATE

Since: 0.3.0

The “sort-order” property

  “sort-order”               GDataYouTubeSortOrder

Specifies the direction of sorting. To use the default sort order, set the property to GDATA_YOUTUBE_SORT_NONE.

Flags: Read / Write

Default value: GDATA_YOUTUBE_SORT_NONE

Since: 0.3.0

The “uploader” property

  “uploader”                 GDataYouTubeUploader

Restricts the search to videos from the specified type of uploader. Currently, this can only be used to restrict searches to videos from YouTube partners.

Flags: Read / Write

Default value: GDATA_YOUTUBE_UPLOADER_ALL

Since: 0.3.0