libgdata-dev 0.17.4-1 / usr / share / gir-1.0 / GData-0.0.gir

<?xml version="1.0"?>
<!-- This file was automatically generated from C sources - DO NOT EDIT!
To affect the contents of this file, edit the original C definitions,
and/or use gtk-doc annotations.  -->
<repository version="1.2"
            xmlns="http://www.gtk.org/introspection/core/1.0"
            xmlns:c="http://www.gtk.org/introspection/c/1.0"
            xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
  <include name="GObject" version="2.0"/>
  <include name="Goa" version="1.0"/>
  <include name="Json" version="1.0"/>
  <include name="Soup" version="2.4"/>
  <include name="libxml2" version="2.0"/>
  <package name="libgdata"/>
  <c:include name="gdata/gdata.h"/>
  <namespace name="GData"
             version="0.0"
             shared-library="libgdata.so.22"
             c:identifier-prefixes="GData"
             c:symbol-prefixes="gdata">
    <constant name="ACCESS_ROLE_NONE"
              value="none"
              c:type="GDATA_ACCESS_ROLE_NONE"
              version="0.7.0">
      <doc xml:space="preserve">The users specified by the #GDataAccessRule have no rights.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="ACCESS_SCOPE_DEFAULT"
              value="default"
              c:type="GDATA_ACCESS_SCOPE_DEFAULT"
              version="0.7.0">
      <doc xml:space="preserve">The #GDataAccessRule applies to all users.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="ACCESS_SCOPE_DOMAIN"
              value="domain"
              c:type="GDATA_ACCESS_SCOPE_DOMAIN"
              version="0.7.0">
      <doc xml:space="preserve">The #GDataAccessRule applies to all users in a Google Apps For Your Domain domain, given in #GDataAccessRule:scope-value.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="ACCESS_SCOPE_USER"
              value="user"
              c:type="GDATA_ACCESS_SCOPE_USER"
              version="0.7.0">
      <doc xml:space="preserve">The #GDataAccessRule applies to a single individual, whose e-mail address is given in #GDataAccessRule:scope-value.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <class name="APPCategories"
           c:symbol-prefix="app_categories"
           c:type="GDataAPPCategories"
           version="0.7.0"
           parent="Parsable"
           glib:type-name="GDataAPPCategories"
           glib:get-type="gdata_app_categories_get_type"
           glib:type-struct="APPCategoriesClass">
      <doc xml:space="preserve">All the fields in the #GDataAPPCategories structure are private and should never be accessed directly.</doc>
      <method name="get_categories"
              c:identifier="gdata_app_categories_get_categories"
              version="0.7.0">
        <doc xml:space="preserve">Returns a list of the categories in this category list.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataCategory&lt;!-- --&gt;s</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="Category"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAPPCategories</doc>
            <type name="APPCategories" c:type="GDataAPPCategories*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_fixed"
              c:identifier="gdata_app_categories_is_fixed"
              version="0.7.0">
        <doc xml:space="preserve">Returns #GDataAPPCategories:is-fixed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">whether entries may use categories not in this category list</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAPPCategories</doc>
            <type name="APPCategories" c:type="GDataAPPCategories*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="is-fixed" version="0.7.0" transfer-ownership="none">
        <doc xml:space="preserve">Whether entries may use categories not in this category list.

API reference: &lt;ulink type="http" url="http://www.atomenabled.org/developers/protocol/#appCategories2"&gt;app:categories&lt;/ulink&gt;</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <field name="parent" readable="0" private="1">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="APPCategoriesPrivate" c:type="GDataAPPCategoriesPrivate*"/>
      </field>
    </class>
    <record name="APPCategoriesClass"
            c:type="GDataAPPCategoriesClass"
            glib:is-gtype-struct-for="APPCategories"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataAPPCategoriesClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="APPCategoriesPrivate"
            c:type="GDataAPPCategoriesPrivate"
            disguised="1">
    </record>
    <interface name="AccessHandler"
               c:symbol-prefix="access_handler"
               c:type="GDataAccessHandler"
               version="0.3.0"
               glib:type-name="GDataAccessHandler"
               glib:get-type="gdata_access_handler_get_type"
               glib:type-struct="AccessHandlerIface">
      <doc xml:space="preserve">All the fields in the #GDataAccessHandler structure are private and should never be accessed directly.</doc>
      <prerequisite name="Entry"/>
      <virtual-method name="get_authorization_domain" introspectable="0">
        <return-value>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <type name="AccessHandler" c:type="GDataAccessHandler*"/>
          </instance-parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="get_rules"
                      invoker="get_rules"
                      version="0.3.0"
                      throws="1">
        <doc xml:space="preserve">Retrieves a #GDataFeed containing all the access rules which apply to the given #GDataAccessHandler. Only the owner of a #GDataAccessHandler may
view its rule feed.

If @cancellable is not %NULL, then the operation can be cancelled by triggering the @cancellable object from another thread.
If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.

A %GDATA_SERVICE_ERROR_PROTOCOL_ERROR will be returned if the server indicates there is a problem with the query.

For each rule in the response feed, @progress_callback will be called in the main thread. If there was an error parsing the XML response,
a #GDataParserError will be returned.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of access control rules, or %NULL; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAccessHandler</doc>
            <type name="AccessHandler" c:type="GDataAccessHandler*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when a rule is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </virtual-method>
      <method name="get_rules"
              c:identifier="gdata_access_handler_get_rules"
              version="0.3.0"
              throws="1">
        <doc xml:space="preserve">Retrieves a #GDataFeed containing all the access rules which apply to the given #GDataAccessHandler. Only the owner of a #GDataAccessHandler may
view its rule feed.

If @cancellable is not %NULL, then the operation can be cancelled by triggering the @cancellable object from another thread.
If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.

A %GDATA_SERVICE_ERROR_PROTOCOL_ERROR will be returned if the server indicates there is a problem with the query.

For each rule in the response feed, @progress_callback will be called in the main thread. If there was an error parsing the XML response,
a #GDataParserError will be returned.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of access control rules, or %NULL; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAccessHandler</doc>
            <type name="AccessHandler" c:type="GDataAccessHandler*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when a rule is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_rules_async"
              c:identifier="gdata_access_handler_get_rules_async"
              version="0.9.1">
        <doc xml:space="preserve">Retrieves a #GDataFeed containing all the access rules which apply to the given #GDataAccessHandler. Only the owner of a #GDataAccessHandler may
view its rule feed. @self and @service are both reffed when this function is called, so can safely be unreffed after this function returns.

For more details, see gdata_access_handler_get_rules(), which is the synchronous version of this function, and gdata_service_query_async(), which
is the base asynchronous query function.

When the operation is finished, @callback will be called. You can then call gdata_service_query_finish()
to get the results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAccessHandler</doc>
            <type name="AccessHandler" c:type="GDataAccessHandler*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="3"
                     destroy="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when a rule is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="6">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the query is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
    </interface>
    <record name="AccessHandlerIface"
            c:type="GDataAccessHandlerIface"
            glib:is-gtype-struct-for="AccessHandler"
            version="0.9.0">
      <doc xml:space="preserve">The class structure for the #GDataAccessHandler interface.</doc>
      <field name="parent">
        <doc xml:space="preserve">the parent type</doc>
        <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
      </field>
      <field name="is_owner_rule">
        <callback name="is_owner_rule">
          <return-value transfer-ownership="none">
            <type name="gboolean" c:type="gboolean"/>
          </return-value>
          <parameters>
            <parameter name="rule" transfer-ownership="none">
              <type name="AccessRule" c:type="GDataAccessRule*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="get_authorization_domain" introspectable="0">
        <callback name="get_authorization_domain" introspectable="0">
          <return-value>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <type name="AccessHandler" c:type="GDataAccessHandler*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="get_rules">
        <callback name="get_rules" throws="1">
          <return-value transfer-ownership="full">
            <doc xml:space="preserve">a #GDataFeed of access control rules, or %NULL; unref with g_object_unref()</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <doc xml:space="preserve">a #GDataAccessHandler</doc>
              <type name="AccessHandler" c:type="GDataAccessHandler*"/>
            </parameter>
            <parameter name="service" transfer-ownership="none">
              <doc xml:space="preserve">a #GDataService</doc>
              <type name="Service" c:type="GDataService*"/>
            </parameter>
            <parameter name="cancellable"
                       transfer-ownership="none"
                       nullable="1"
                       allow-none="1">
              <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
              <type name="Gio.Cancellable" c:type="GCancellable*"/>
            </parameter>
            <parameter name="progress_callback"
                       transfer-ownership="none"
                       nullable="1"
                       allow-none="1"
                       scope="call"
                       closure="4">
              <doc xml:space="preserve">a #GDataQueryProgressCallback to call when a rule is loaded, or %NULL</doc>
              <type name="QueryProgressCallback"
                    c:type="GDataQueryProgressCallback"/>
            </parameter>
            <parameter name="progress_user_data" transfer-ownership="none">
              <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
              <type name="gpointer" c:type="gpointer"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <class name="AccessRule"
           c:symbol-prefix="access_rule"
           c:type="GDataAccessRule"
           version="0.3.0"
           parent="Entry"
           glib:type-name="GDataAccessRule"
           glib:get-type="gdata_access_rule_get_type"
           glib:type-struct="AccessRuleClass">
      <doc xml:space="preserve">All the fields in the #GDataAccessRule structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_access_rule_new"
                   version="0.3.0">
        <doc xml:space="preserve">Creates a new #GDataAccessRule with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataAccessRule; unref with g_object_unref()</doc>
          <type name="AccessRule" c:type="GDataAccessRule*"/>
        </return-value>
        <parameters>
          <parameter name="id" transfer-ownership="none">
            <doc xml:space="preserve">the access rule's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_edited"
              c:identifier="gdata_access_rule_get_edited"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataAccessRule:edited property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the time the access rule was last edited, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAccessRule</doc>
            <type name="AccessRule" c:type="GDataAccessRule*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_key"
              c:identifier="gdata_access_rule_get_key"
              version="0.16.0">
        <doc xml:space="preserve">Gets the #GDataAccessRule:key property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the access rule's authorisation key, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAccessRule</doc>
            <type name="AccessRule" c:type="GDataAccessRule*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_role"
              c:identifier="gdata_access_rule_get_role"
              version="0.3.0">
        <doc xml:space="preserve">Gets the #GDataAccessRule:role property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the access rule's role, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAccessRule</doc>
            <type name="AccessRule" c:type="GDataAccessRule*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_scope"
              c:identifier="gdata_access_rule_get_scope"
              version="0.3.0">
        <doc xml:space="preserve">Gets the #GDataAccessRule:scope-type and #GDataAccessRule:scope-value properties.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAccessRule</doc>
            <type name="AccessRule" c:type="GDataAccessRule*"/>
          </instance-parameter>
          <parameter name="type"
                     direction="out"
                     caller-allocates="0"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the scope type, or %NULL</doc>
            <type name="utf8" c:type="const gchar**"/>
          </parameter>
          <parameter name="value"
                     direction="out"
                     caller-allocates="0"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the scope value, or %NULL</doc>
            <type name="utf8" c:type="const gchar**"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_role"
              c:identifier="gdata_access_rule_set_role"
              version="0.3.0">
        <doc xml:space="preserve">Sets the #GDataAccessRule:role property to @role.

Set @role to %NULL to unset the property in the access rule.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAccessRule</doc>
            <type name="AccessRule" c:type="GDataAccessRule*"/>
          </instance-parameter>
          <parameter name="role" transfer-ownership="none">
            <doc xml:space="preserve">a new role, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_scope"
              c:identifier="gdata_access_rule_set_scope"
              version="0.3.0">
        <doc xml:space="preserve">Sets the #GDataAccessRule:scope-type property to @type and the #GDataAccessRule:scope-value property to @value.

Set @scope_value to %NULL to unset the #GDataAccessRule:scope-value property in the access rule. @type cannot
be %NULL. @scope_value must be %NULL if @type is &lt;literal&gt;default&lt;/literal&gt;, and non-%NULL otherwise.

See the
&lt;ulink type="http" url="https://developers.google.com/google-apps/calendar/v3/reference/acl"&gt;online
documentation&lt;/ulink&gt; for more information.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAccessRule</doc>
            <type name="AccessRule" c:type="GDataAccessRule*"/>
          </instance-parameter>
          <parameter name="type" transfer-ownership="none">
            <doc xml:space="preserve">a new scope type</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="value"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new scope value, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="edited" version="0.7.0" transfer-ownership="none">
        <doc xml:space="preserve">The last time the access rule was edited. If the rule has not been edited yet, the content indicates the time it was created.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/protocol/#appEdited"&gt;
Atom Publishing Protocol specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="key" version="0.16.0" transfer-ownership="none">
        <doc xml:space="preserve">An optional authorisation key required to access this item with the given scope. If set, this restricts
access to those principals who have a copy of the key. The key is generated server-side and cannot be
modified by the client. If no authorisation key is set (and hence none is needed for access to the item),
this will be %NULL.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="role"
                version="0.3.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The role of the person concerned by this ACL. By default, this can only be %GDATA_ACCESS_ROLE_NONE. Services may extend it with
their own namespaced roles.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="scope-type"
                version="0.3.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies to whom this access rule applies. For example, %GDATA_ACCESS_SCOPE_USER or %GDATA_ACCESS_SCOPE_DEFAULT.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="scope-value"
                version="0.3.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A value representing the user who is represented by the access rule, such as an
e-mail address for users, or a domain name for domains.

This must be %NULL if and only if #GDataAccessRule:scope-type is %GDATA_ACCESS_SCOPE_DEFAULT.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="AccessRulePrivate" c:type="GDataAccessRulePrivate*"/>
      </field>
    </class>
    <record name="AccessRuleClass"
            c:type="GDataAccessRuleClass"
            glib:is-gtype-struct-for="AccessRule"
            version="0.3.0">
      <doc xml:space="preserve">All the fields in the #GDataAccessRuleClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="AccessRulePrivate"
            c:type="GDataAccessRulePrivate"
            disguised="1">
    </record>
    <class name="Author"
           c:symbol-prefix="author"
           c:type="GDataAuthor"
           parent="Parsable"
           glib:type-name="GDataAuthor"
           glib:get-type="gdata_author_get_type"
           glib:type-struct="AuthorClass">
      <doc xml:space="preserve">All the fields in the #GDataAuthor structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new" c:identifier="gdata_author_new">
        <doc xml:space="preserve">Creates a new #GDataAuthor. More information is available in the &lt;ulink type="http"
url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.author"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataAuthor, or %NULL; unref with g_object_unref()</doc>
          <type name="Author" c:type="GDataAuthor*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">the author's name</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="uri"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">an IRI describing the author, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="email_address"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the author's e-mail address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_email_address"
              c:identifier="gdata_author_get_email_address"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataAuthor:email-address property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the author's e-mail address, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthor</doc>
            <type name="Author" c:type="GDataAuthor*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_name"
              c:identifier="gdata_author_get_name"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataAuthor:name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the author's name</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthor</doc>
            <type name="Author" c:type="GDataAuthor*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_uri"
              c:identifier="gdata_author_get_uri"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataAuthor:uri property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the author's URI, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthor</doc>
            <type name="Author" c:type="GDataAuthor*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_email_address"
              c:identifier="gdata_author_set_email_address"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataAuthor:email-address property to @email_address.

Set @email_address to %NULL to unset the property in the author.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthor</doc>
            <type name="Author" c:type="GDataAuthor*"/>
          </instance-parameter>
          <parameter name="email_address"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new e-mail address for the author, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_name"
              c:identifier="gdata_author_set_name"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataAuthor:name property to @name.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthor</doc>
            <type name="Author" c:type="GDataAuthor*"/>
          </instance-parameter>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">the new name for the author</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_uri"
              c:identifier="gdata_author_set_uri"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataAuthor:uri property to @uri.

Set @uri to %NULL to unset the property in the author.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthor</doc>
            <type name="Author" c:type="GDataAuthor*"/>
          </instance-parameter>
          <parameter name="uri"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new URI for the author, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="email-address"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An e-mail address associated with the person.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.author"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="name"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A human-readable name for the person.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.author"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="uri"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An IRI associated with the person.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.author"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="AuthorPrivate" c:type="GDataAuthorPrivate*"/>
      </field>
    </class>
    <record name="AuthorClass"
            c:type="GDataAuthorClass"
            glib:is-gtype-struct-for="Author"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataAuthorClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="AuthorPrivate" c:type="GDataAuthorPrivate" disguised="1">
    </record>
    <class name="AuthorizationDomain"
           c:symbol-prefix="authorization_domain"
           c:type="GDataAuthorizationDomain"
           version="0.9.0"
           parent="GObject.Object"
           glib:type-name="GDataAuthorizationDomain"
           glib:get-type="gdata_authorization_domain_get_type"
           glib:type-struct="AuthorizationDomainClass">
      <doc xml:space="preserve">All the fields in the #GDataAuthorizationDomain structure are private and should never be accessed directly.</doc>
      <method name="get_scope"
              c:identifier="gdata_authorization_domain_get_scope"
              version="0.9.0">
        <doc xml:space="preserve">Returns a URI detailing the scope of the authorization domain. See #GDataAuthorizationDomain:scope for more details.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">URI detailing the scope of the authorization domain</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthorizationDomain</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_service_name"
              c:identifier="gdata_authorization_domain_get_service_name"
              version="0.9.0">
        <doc xml:space="preserve">Returns the name of the service containing the authorization domain. See #GDataAuthorizationDomain:service-name for more details.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">name of the service containing the authorization domain</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthorizationDomain</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="scope"
                version="0.9.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A URI detailing the scope of the authorization domain, as enumerated in the
&lt;ulink type="http" url="http://code.google.com/apis/documents/faq_gdata.html#AuthScopes"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="service-name"
                version="0.9.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The name of the service which contains the authorization domain, as enumerated in the
&lt;ulink type="http" url="http://code.google.com/apis/documents/faq_gdata.html#clientlogin"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent" readable="0" private="1">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="AuthorizationDomainPrivate"
              c:type="GDataAuthorizationDomainPrivate*"/>
      </field>
    </class>
    <record name="AuthorizationDomainClass"
            c:type="GDataAuthorizationDomainClass"
            glib:is-gtype-struct-for="AuthorizationDomain"
            version="0.9.0">
      <doc xml:space="preserve">All the fields in the #GDataAuthorizationDomainClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="AuthorizationDomainPrivate"
            c:type="GDataAuthorizationDomainPrivate"
            disguised="1">
    </record>
    <interface name="Authorizer"
               c:symbol-prefix="authorizer"
               c:type="GDataAuthorizer"
               version="0.9.0"
               glib:type-name="GDataAuthorizer"
               glib:get-type="gdata_authorizer_get_type"
               glib:type-struct="AuthorizerInterface">
      <doc xml:space="preserve">All the fields in the #GDataAuthorizer structure are private and should never be accessed directly.</doc>
      <virtual-method name="is_authorized_for_domain"
                      invoker="is_authorized_for_domain"
                      version="0.9.0">
        <doc xml:space="preserve">Returns whether the #GDataAuthorizer instance believes it's currently authorized to access the given @domain. Note that this will not perform any
network requests, and will just look up the result in the #GDataAuthorizer's local cache of authorizations. This means that the result may be out
of date, as the server may have since invalidated the authorization. If the #GDataAuthorizer class supports timeouts and TTLs on authorizations,
they will not be taken into account; this method effectively returns whether the last successful authorization operation performed on the
#GDataAuthorizer included @domain in the list of requested authorization domains.

Note that %NULL may be passed as the #GDataAuthorizer, in which case %FALSE will always be returned, regardless of the @domain. This is for
convenience of checking whether a domain is authorized by the #GDataAuthorizer returned by gdata_service_get_authorizer(), which may be %NULL.
For example:
|[
if (gdata_authorizer_is_authorized_for_domain (gdata_service_get_authorizer (my_service), my_domain) == TRUE) {
	/&lt;!-- --&gt;* Code to execute only if we're authorized for the given domain *&lt;!-- --&gt;/
}
]|

This method is thread safe.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the #GDataAuthorizer has been authorized to access @domain, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self"
                              transfer-ownership="none"
                              nullable="1"
                              allow-none="1">
            <doc xml:space="preserve">a #GDataAuthorizer, or %NULL</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </instance-parameter>
          <parameter name="domain" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataAuthorizationDomain to check against</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="process_request"
                      invoker="process_request"
                      version="0.9.0">
        <doc xml:space="preserve">Processes @message, adding all the necessary extra headers and parameters to ensure that it's correctly authenticated and authorized under the
given @domain for the online service. Basically, if a query is not processed by calling this method on it, it will be sent to the online service as
if it's a query from a non-logged-in user. Similarly, if the #GDataAuthorizer isn't authenticated or authorized (for @domain), no changes will
be made to the @message.

@domain may be %NULL if the request doesn't require authorization.

This modifies @message in place.

This method is thread safe.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthorizer</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain the query falls under, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="message" transfer-ownership="none">
            <doc xml:space="preserve">the query to process</doc>
            <type name="Soup.Message" c:type="SoupMessage*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="refresh_authorization"
                      invoker="refresh_authorization"
                      version="0.9.0"
                      throws="1">
        <doc xml:space="preserve">Forces the #GDataAuthorizer to refresh any authorization tokens it holds with the online service. This should typically be called when a
#GDataService query returns %GDATA_SERVICE_ERROR_AUTHENTICATION_REQUIRED, and is already called transparently by methods such as
gdata_service_query() and gdata_service_insert_entry() (see their documentation for more details).

If re-authorization is successful, it's guaranteed that by the time this method returns, the properties containing the relevant authorization
tokens on the #GDataAuthorizer instance will have been updated.

If %FALSE is returned, @error will be set if (and only if) it's due to a refresh being attempted and failing. If a refresh is not attempted, %FALSE
will be returned but @error will not be set.

If the #GDataAuthorizer has not been previously authenticated or authorized (using the class' specific methods), no authorization will be
attempted, %FALSE will be returned immediately and @error will not be set.

Some #GDataAuthorizer implementations may not support refreshing authorization tokens at all; for example if doing so requires user interaction.
%FALSE will be returned immediately in that case and @error will not be set.

This method is thread safe.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if an authorization refresh was attempted and was successful, %FALSE if a refresh wasn't attempted or was unsuccessful</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthorizer</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </instance-parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="refresh_authorization_async"
                      invoker="refresh_authorization_async"
                      version="0.9.0">
        <doc xml:space="preserve">Forces the #GDataAuthorizer to refresh any authorization tokens it holds with the online service. @self and @cancellable are reffed when this
method is called, so can safely be freed after this method returns.

For more details, see gdata_authorizer_refresh_authorization(), which is the synchronous version of this method. If the #GDataAuthorizer class
doesn't implement #GDataAuthorizerInterface.refresh_authorization_async but does implement #GDataAuthorizerInterface.refresh_authorization, the
latter will be called from a new thread to make it asynchronous.

When the authorization refresh operation is finished, @callback will be called. You can then call gdata_authorizer_refresh_authorization_finish()
to get the results of the operation.

This method is thread safe.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthorizer</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </instance-parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="2">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the authorization refresh operation is finished, or %NULL</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none" closure="2">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="refresh_authorization_finish"
                      invoker="refresh_authorization_finish"
                      version="0.9.0"
                      throws="1">
        <doc xml:space="preserve">Finishes an asynchronous authorization refresh operation for the #GDataAuthorizer, as started with gdata_authorizer_refresh_authorization_async().

This method is thread safe.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if an authorization refresh was attempted and was successful, %FALSE if a refresh wasn't attempted or was unsuccessful</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthorizer</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <method name="is_authorized_for_domain"
              c:identifier="gdata_authorizer_is_authorized_for_domain"
              version="0.9.0">
        <doc xml:space="preserve">Returns whether the #GDataAuthorizer instance believes it's currently authorized to access the given @domain. Note that this will not perform any
network requests, and will just look up the result in the #GDataAuthorizer's local cache of authorizations. This means that the result may be out
of date, as the server may have since invalidated the authorization. If the #GDataAuthorizer class supports timeouts and TTLs on authorizations,
they will not be taken into account; this method effectively returns whether the last successful authorization operation performed on the
#GDataAuthorizer included @domain in the list of requested authorization domains.

Note that %NULL may be passed as the #GDataAuthorizer, in which case %FALSE will always be returned, regardless of the @domain. This is for
convenience of checking whether a domain is authorized by the #GDataAuthorizer returned by gdata_service_get_authorizer(), which may be %NULL.
For example:
|[
if (gdata_authorizer_is_authorized_for_domain (gdata_service_get_authorizer (my_service), my_domain) == TRUE) {
	/&lt;!-- --&gt;* Code to execute only if we're authorized for the given domain *&lt;!-- --&gt;/
}
]|

This method is thread safe.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the #GDataAuthorizer has been authorized to access @domain, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self"
                              transfer-ownership="none"
                              nullable="1"
                              allow-none="1">
            <doc xml:space="preserve">a #GDataAuthorizer, or %NULL</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </instance-parameter>
          <parameter name="domain" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataAuthorizationDomain to check against</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
        </parameters>
      </method>
      <method name="process_request"
              c:identifier="gdata_authorizer_process_request"
              version="0.9.0">
        <doc xml:space="preserve">Processes @message, adding all the necessary extra headers and parameters to ensure that it's correctly authenticated and authorized under the
given @domain for the online service. Basically, if a query is not processed by calling this method on it, it will be sent to the online service as
if it's a query from a non-logged-in user. Similarly, if the #GDataAuthorizer isn't authenticated or authorized (for @domain), no changes will
be made to the @message.

@domain may be %NULL if the request doesn't require authorization.

This modifies @message in place.

This method is thread safe.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthorizer</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain the query falls under, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="message" transfer-ownership="none">
            <doc xml:space="preserve">the query to process</doc>
            <type name="Soup.Message" c:type="SoupMessage*"/>
          </parameter>
        </parameters>
      </method>
      <method name="refresh_authorization"
              c:identifier="gdata_authorizer_refresh_authorization"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Forces the #GDataAuthorizer to refresh any authorization tokens it holds with the online service. This should typically be called when a
#GDataService query returns %GDATA_SERVICE_ERROR_AUTHENTICATION_REQUIRED, and is already called transparently by methods such as
gdata_service_query() and gdata_service_insert_entry() (see their documentation for more details).

If re-authorization is successful, it's guaranteed that by the time this method returns, the properties containing the relevant authorization
tokens on the #GDataAuthorizer instance will have been updated.

If %FALSE is returned, @error will be set if (and only if) it's due to a refresh being attempted and failing. If a refresh is not attempted, %FALSE
will be returned but @error will not be set.

If the #GDataAuthorizer has not been previously authenticated or authorized (using the class' specific methods), no authorization will be
attempted, %FALSE will be returned immediately and @error will not be set.

Some #GDataAuthorizer implementations may not support refreshing authorization tokens at all; for example if doing so requires user interaction.
%FALSE will be returned immediately in that case and @error will not be set.

This method is thread safe.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if an authorization refresh was attempted and was successful, %FALSE if a refresh wasn't attempted or was unsuccessful</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthorizer</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </instance-parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="refresh_authorization_async"
              c:identifier="gdata_authorizer_refresh_authorization_async"
              version="0.9.0">
        <doc xml:space="preserve">Forces the #GDataAuthorizer to refresh any authorization tokens it holds with the online service. @self and @cancellable are reffed when this
method is called, so can safely be freed after this method returns.

For more details, see gdata_authorizer_refresh_authorization(), which is the synchronous version of this method. If the #GDataAuthorizer class
doesn't implement #GDataAuthorizerInterface.refresh_authorization_async but does implement #GDataAuthorizerInterface.refresh_authorization, the
latter will be called from a new thread to make it asynchronous.

When the authorization refresh operation is finished, @callback will be called. You can then call gdata_authorizer_refresh_authorization_finish()
to get the results of the operation.

This method is thread safe.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthorizer</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </instance-parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="2">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the authorization refresh operation is finished, or %NULL</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="refresh_authorization_finish"
              c:identifier="gdata_authorizer_refresh_authorization_finish"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous authorization refresh operation for the #GDataAuthorizer, as started with gdata_authorizer_refresh_authorization_async().

This method is thread safe.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if an authorization refresh was attempted and was successful, %FALSE if a refresh wasn't attempted or was unsuccessful</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthorizer</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
    </interface>
    <record name="AuthorizerInterface"
            c:type="GDataAuthorizerInterface"
            glib:is-gtype-struct-for="Authorizer"
            version="0.9.0">
      <doc xml:space="preserve">The class structure for the #GDataAuthorizer interface.</doc>
      <field name="parent">
        <doc xml:space="preserve">the parent type</doc>
        <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
      </field>
      <field name="process_request">
        <callback name="process_request">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <doc xml:space="preserve">a #GDataAuthorizer</doc>
              <type name="Authorizer" c:type="GDataAuthorizer*"/>
            </parameter>
            <parameter name="domain"
                       transfer-ownership="none"
                       nullable="1"
                       allow-none="1">
              <doc xml:space="preserve">the #GDataAuthorizationDomain the query falls under, or %NULL</doc>
              <type name="AuthorizationDomain"
                    c:type="GDataAuthorizationDomain*"/>
            </parameter>
            <parameter name="message" transfer-ownership="none">
              <doc xml:space="preserve">the query to process</doc>
              <type name="Soup.Message" c:type="SoupMessage*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="is_authorized_for_domain">
        <callback name="is_authorized_for_domain">
          <return-value transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if the #GDataAuthorizer has been authorized to access @domain, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </return-value>
          <parameters>
            <parameter name="self"
                       transfer-ownership="none"
                       nullable="1"
                       allow-none="1">
              <doc xml:space="preserve">a #GDataAuthorizer, or %NULL</doc>
              <type name="Authorizer" c:type="GDataAuthorizer*"/>
            </parameter>
            <parameter name="domain" transfer-ownership="none">
              <doc xml:space="preserve">the #GDataAuthorizationDomain to check against</doc>
              <type name="AuthorizationDomain"
                    c:type="GDataAuthorizationDomain*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="refresh_authorization">
        <callback name="refresh_authorization" throws="1">
          <return-value transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if an authorization refresh was attempted and was successful, %FALSE if a refresh wasn't attempted or was unsuccessful</doc>
            <type name="gboolean" c:type="gboolean"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <doc xml:space="preserve">a #GDataAuthorizer</doc>
              <type name="Authorizer" c:type="GDataAuthorizer*"/>
            </parameter>
            <parameter name="cancellable"
                       transfer-ownership="none"
                       nullable="1"
                       allow-none="1">
              <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
              <type name="Gio.Cancellable" c:type="GCancellable*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="refresh_authorization_async">
        <callback name="refresh_authorization_async">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <doc xml:space="preserve">a #GDataAuthorizer</doc>
              <type name="Authorizer" c:type="GDataAuthorizer*"/>
            </parameter>
            <parameter name="cancellable"
                       transfer-ownership="none"
                       nullable="1"
                       allow-none="1">
              <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
              <type name="Gio.Cancellable" c:type="GCancellable*"/>
            </parameter>
            <parameter name="callback"
                       transfer-ownership="none"
                       nullable="1"
                       allow-none="1"
                       scope="async"
                       closure="3">
              <doc xml:space="preserve">a #GAsyncReadyCallback to call when the authorization refresh operation is finished, or %NULL</doc>
              <type name="Gio.AsyncReadyCallback"
                    c:type="GAsyncReadyCallback"/>
            </parameter>
            <parameter name="user_data" transfer-ownership="none" closure="3">
              <doc xml:space="preserve">data to pass to the @callback function</doc>
              <type name="gpointer" c:type="gpointer"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="refresh_authorization_finish">
        <callback name="refresh_authorization_finish" throws="1">
          <return-value transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if an authorization refresh was attempted and was successful, %FALSE if a refresh wasn't attempted or was unsuccessful</doc>
            <type name="gboolean" c:type="gboolean"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <doc xml:space="preserve">a #GDataAuthorizer</doc>
              <type name="Authorizer" c:type="GDataAuthorizer*"/>
            </parameter>
            <parameter name="async_result" transfer-ownership="none">
              <doc xml:space="preserve">a #GAsyncResult</doc>
              <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
    </record>
    <class name="BatchOperation"
           c:symbol-prefix="batch_operation"
           c:type="GDataBatchOperation"
           version="0.7.0"
           parent="GObject.Object"
           glib:type-name="GDataBatchOperation"
           glib:get-type="gdata_batch_operation_get_type"
           glib:type-struct="BatchOperationClass">
      <doc xml:space="preserve">All the fields in the #GDataBatchOperation structure are private and should never be accessed directly.</doc>
      <method name="add_deletion"
              c:identifier="gdata_batch_operation_add_deletion"
              version="0.7.0">
        <doc xml:space="preserve">Add an entry to the #GDataBatchOperation, to be deleted on the server when the operation is run. @entry is reffed by the function, so may be freed
after it returns.

Note that a single batch operation should not operate on a given #GDataEntry more than once, as there's no guarantee about the order in which the
batch operation's operations will be performed.

@callback will be called as specified in the documentation for gdata_batch_operation_add_query(), with an @operation_type of
%GDATA_BATCH_OPERATION_DELETION.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">operation ID for the added deletion, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataBatchOperation</doc>
            <type name="BatchOperation" c:type="GDataBatchOperation*"/>
          </instance-parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataEntry to delete</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     scope="async"
                     closure="2">
            <doc xml:space="preserve">a #GDataBatchOperationCallback to call when the deletion is finished, or %NULL</doc>
            <type name="BatchOperationCallback"
                  c:type="GDataBatchOperationCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_insertion"
              c:identifier="gdata_batch_operation_add_insertion"
              version="0.7.0">
        <doc xml:space="preserve">Add an entry to the #GDataBatchOperation, to be inserted on the server when the operation is run. The insertion will return the inserted version
of @entry. @entry is reffed by the function, so may be freed after it returns.

@callback will be called as specified in the documentation for gdata_batch_operation_add_query(), with an @operation_type of
%GDATA_BATCH_OPERATION_INSERTION.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">operation ID for the added insertion, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataBatchOperation</doc>
            <type name="BatchOperation" c:type="GDataBatchOperation*"/>
          </instance-parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataEntry to insert</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     scope="async"
                     closure="2">
            <doc xml:space="preserve">a #GDataBatchOperationCallback to call when the insertion is finished, or %NULL</doc>
            <type name="BatchOperationCallback"
                  c:type="GDataBatchOperationCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_query"
              c:identifier="gdata_batch_operation_add_query"
              version="0.7.0">
        <doc xml:space="preserve">Add a query to the #GDataBatchOperation, to be executed when the operation is run. The query will return a #GDataEntry (of subclass type
@entry_type) representing the given entry @id. The ID is of the same format as that returned by gdata_entry_get_id().

Note that a single batch operation should not operate on a given #GDataEntry more than once, as there's no guarantee about the order in which the
batch operation's operations will be performed.

@callback will be called when the #GDataBatchOperation is run with gdata_batch_operation_run() (in which case it will be called in the thread which
ran the batch operation), or with gdata_batch_operation_run_async() (in which case it will be called in an idle handler in the main thread). The
@operation_id passed to the callback will match the return value of gdata_batch_operation_add_query(), and the @operation_type will be
%GDATA_BATCH_OPERATION_QUERY. If the query was successful, the resulting entry will be passed to the callback function as @entry, and @error will
be %NULL. If, however, the query was unsuccessful, @entry will be %NULL and @error will contain a #GError detailing what went wrong.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">operation ID for the added query, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataBatchOperation</doc>
            <type name="BatchOperation" c:type="GDataBatchOperation*"/>
          </instance-parameter>
          <parameter name="id" transfer-ownership="none">
            <doc xml:space="preserve">the ID of the entry being queried for</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="entry_type" transfer-ownership="none">
            <doc xml:space="preserve">the type of the entry which will be returned</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GDataBatchOperationCallback to call when the query is finished, or %NULL</doc>
            <type name="BatchOperationCallback"
                  c:type="GDataBatchOperationCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_update"
              c:identifier="gdata_batch_operation_add_update"
              version="0.7.0">
        <doc xml:space="preserve">Add an entry to the #GDataBatchOperation, to be updated on the server when the operation is run. The update will return the updated version of
@entry. @entry is reffed by the function, so may be freed after it returns.

Note that a single batch operation should not operate on a given #GDataEntry more than once, as there's no guarantee about the order in which the
batch operation's operations will be performed.

@callback will be called as specified in the documentation for gdata_batch_operation_add_query(), with an @operation_type of
%GDATA_BATCH_OPERATION_UPDATE.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">operation ID for the added update, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataBatchOperation</doc>
            <type name="BatchOperation" c:type="GDataBatchOperation*"/>
          </instance-parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataEntry to update</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     scope="async"
                     closure="2">
            <doc xml:space="preserve">a #GDataBatchOperationCallback to call when the update is finished, or %NULL</doc>
            <type name="BatchOperationCallback"
                  c:type="GDataBatchOperationCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_authorization_domain"
              c:identifier="gdata_batch_operation_get_authorization_domain"
              version="0.9.0">
        <doc xml:space="preserve">Gets the #GDataBatchOperation:authorization-domain property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #GDataAuthorizationDomain used to authorize the batch operation, or %NULL</doc>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataBatchOperation</doc>
            <type name="BatchOperation" c:type="GDataBatchOperation*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_feed_uri"
              c:identifier="gdata_batch_operation_get_feed_uri"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataBatchOperation:feed-uri property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the batch operation's feed URI</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataBatchOperation</doc>
            <type name="BatchOperation" c:type="GDataBatchOperation*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_service"
              c:identifier="gdata_batch_operation_get_service"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataBatchOperation:service property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the batch operation's attached service</doc>
          <type name="Service" c:type="GDataService*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataBatchOperation</doc>
            <type name="BatchOperation" c:type="GDataBatchOperation*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="run"
              c:identifier="gdata_batch_operation_run"
              version="0.7.0"
              throws="1">
        <doc xml:space="preserve">Run the #GDataBatchOperation synchronously. This will send all the operations in the batch operation to the server, and call their respective
callbacks synchronously (i.e. before gdata_batch_operation_run() returns, and in the same thread that called gdata_batch_operation_run()) as the
server returns results for each operation.

The callbacks for all of the operations in the batch operation are always guaranteed to be called, even if the batch operation as a whole fails.
Each callback will be called exactly once for each time gdata_batch_operation_run() is called.

The return value of the function indicates whether the overall batch operation was successful, and doesn't indicate the status of any of the
operations it comprises. gdata_batch_operation_run() could return %TRUE even if all of its operations failed.

@cancellable can be used to cancel the entire batch operation any time before or during the network activity. If @cancellable is cancelled
after network activity has finished, gdata_batch_operation_run() will continue and finish as normal.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataBatchOperation</doc>
            <type name="BatchOperation" c:type="GDataBatchOperation*"/>
          </instance-parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="run_async"
              c:identifier="gdata_batch_operation_run_async"
              version="0.7.0">
        <doc xml:space="preserve">Run the #GDataBatchOperation asynchronously. This will send all the operations in the batch operation to the server, and call their respective
callbacks asynchronously (i.e. in idle functions in the main thread, usually after gdata_batch_operation_run_async() has returned) as the
server returns results for each operation. @self is reffed when this function is called, so can safely be unreffed after this function returns.

For more details, see gdata_batch_operation_run(), which is the synchronous version of this function.

When the entire batch operation is finished, @callback will be called. You can then call gdata_batch_operation_run_finish() to get the results of
the batch operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataBatchOperation</doc>
            <type name="BatchOperation" c:type="GDataBatchOperation*"/>
          </instance-parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="2">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the batch operation is finished, or %NULL</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="run_finish"
              c:identifier="gdata_batch_operation_run_finish"
              version="0.7.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous batch operation run with gdata_batch_operation_run_async().

Return values are as for gdata_batch_operation_run().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataBatchOperation</doc>
            <type name="BatchOperation" c:type="GDataBatchOperation*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <property name="authorization-domain"
                version="0.9.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The authorization domain for the batch operation, against which the #GDataService:authorizer for the #GDataBatchOperation:service should be
authorized. This may be %NULL if authorization is not needed for any of the requests in the batch operation.

All requests in the batch operation must be authorizable under this single authorization domain. If requests need different authorization
domains, they must be performed in different batch operations.</doc>
        <type name="AuthorizationDomain"/>
      </property>
      <property name="feed-uri"
                version="0.7.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The feed URI that this batch operation will be sent to.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="service"
                version="0.7.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The service this batch operation is attached to.</doc>
        <type name="Service"/>
      </property>
      <field name="parent">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="priv">
        <type name="BatchOperationPrivate"
              c:type="GDataBatchOperationPrivate*"/>
      </field>
    </class>
    <callback name="BatchOperationCallback"
              c:type="GDataBatchOperationCallback"
              version="0.7.0">
      <doc xml:space="preserve">Callback function called once for each operation in a batch operation run. The operation is identified by @operation_id and @operation_type (where
@operation_id is the ID returned by the relevant call to gdata_batch_operation_add_query(), gdata_batch_operation_add_insertion(),
gdata_batch_operation_add_update() or gdata_batch_operation_add_deletion(), and @operation_type shows which one of the above was called).

If the operation was successful, the resulting #GDataEntry will be passed in as @entry, and @error will be %NULL. Otherwise, @entry will be %NULL
and a descriptive error will be in @error. If @operation_type is %GDATA_BATCH_OPERATION_DELETION, @entry will always be %NULL, and @error will be
%NULL or non-%NULL as appropriate.

If the callback code needs to retain a copy of @entry, it must be referenced (with g_object_ref()). Similarly, @error is owned by the calling code,
and must not be freed.

The callback is called in the main thread, and there is no guarantee on the order in which the callbacks for the operations in a run are executed,
or whether they will be called in a timely manner. It is, however, guaranteed that they will all be called before the #GAsyncReadyCallback which
signals the completion of the run (if initiated with gdata_batch_operation_run_async()) is called; or gdata_batch_operation_run() returns (if
initiated synchronously).</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="operation_id" transfer-ownership="none">
          <doc xml:space="preserve">the operation ID returned from gdata_batch_operation_add_*()</doc>
          <type name="guint" c:type="guint"/>
        </parameter>
        <parameter name="operation_type" transfer-ownership="none">
          <doc xml:space="preserve">the type of operation which was requested</doc>
          <type name="BatchOperationType" c:type="GDataBatchOperationType"/>
        </parameter>
        <parameter name="entry" transfer-ownership="none">
          <doc xml:space="preserve">the result of the operation, or %NULL</doc>
          <type name="Entry" c:type="GDataEntry*"/>
        </parameter>
        <parameter name="error" transfer-ownership="none">
          <doc xml:space="preserve">a #GError describing any error which occurred, or %NULL</doc>
          <type name="GLib.Error" c:type="GError*"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" closure="4">
          <doc xml:space="preserve">user data passed to the callback</doc>
          <type name="gpointer" c:type="gpointer"/>
        </parameter>
      </parameters>
    </callback>
    <record name="BatchOperationClass"
            c:type="GDataBatchOperationClass"
            glib:is-gtype-struct-for="BatchOperation"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataBatchOperationClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="BatchOperationPrivate"
            c:type="GDataBatchOperationPrivate"
            disguised="1">
    </record>
    <enumeration name="BatchOperationType"
                 version="0.7.0"
                 glib:type-name="GDataBatchOperationType"
                 glib:get-type="gdata_batch_operation_type_get_type"
                 c:type="GDataBatchOperationType">
      <doc xml:space="preserve">Indicates which type of batch operation caused the current #GDataBatchOperationCallback to be called.</doc>
      <member name="query"
              value="0"
              c:identifier="GDATA_BATCH_OPERATION_QUERY"
              glib:nick="query">
        <doc xml:space="preserve">a query operation</doc>
      </member>
      <member name="insertion"
              value="1"
              c:identifier="GDATA_BATCH_OPERATION_INSERTION"
              glib:nick="insertion">
        <doc xml:space="preserve">an insertion operation</doc>
      </member>
      <member name="update"
              value="2"
              c:identifier="GDATA_BATCH_OPERATION_UPDATE"
              glib:nick="update">
        <doc xml:space="preserve">an update operation</doc>
      </member>
      <member name="deletion"
              value="3"
              c:identifier="GDATA_BATCH_OPERATION_DELETION"
              glib:nick="deletion">
        <doc xml:space="preserve">a deletion operation</doc>
      </member>
    </enumeration>
    <interface name="Batchable"
               c:symbol-prefix="batchable"
               c:type="GDataBatchable"
               version="0.7.0"
               glib:type-name="GDataBatchable"
               glib:get-type="gdata_batchable_get_type"
               glib:type-struct="BatchableIface">
      <doc xml:space="preserve">All the fields in the #GDataBatchable structure are private and should never be accessed directly.</doc>
      <prerequisite name="Service"/>
      <method name="create_operation"
              c:identifier="gdata_batchable_create_operation"
              version="0.9.0">
        <doc xml:space="preserve">Creates a new #GDataBatchOperation for the given #GDataBatchable service, and with the given @feed_uri. @feed_uri is normally the %GDATA_LINK_BATCH
link URI in the appropriate #GDataFeed from the service. If authorization will be required to perform any of the requests in the batch operation,
@domain must be non-%NULL, and must be an authorization domain which covers all of the requests. Otherwise, @domain may be %NULL if authorization
is not required.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataBatchOperation; unref with g_object_unref()</doc>
          <type name="BatchOperation" c:type="GDataBatchOperation*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataBatchable</doc>
            <type name="Batchable" c:type="GDataBatchable*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain to authorize the operation, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="feed_uri" transfer-ownership="none">
            <doc xml:space="preserve">the URI to send the batch operation request to</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
    </interface>
    <record name="BatchableIface"
            c:type="GDataBatchableIface"
            glib:is-gtype-struct-for="Batchable"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataBatchableIface structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
      </field>
      <field name="is_supported">
        <callback name="is_supported">
          <return-value transfer-ownership="none">
            <type name="gboolean" c:type="gboolean"/>
          </return-value>
          <parameters>
            <parameter name="operation_type" transfer-ownership="none">
              <type name="BatchOperationType"
                    c:type="GDataBatchOperationType"/>
            </parameter>
          </parameters>
        </callback>
      </field>
    </record>
    <constant name="CALENDAR_ACCESS_ROLE_EDITOR"
              value="http://schemas.google.com/gCal/2005#editor"
              c:type="GDATA_CALENDAR_ACCESS_ROLE_EDITOR"
              version="0.7.0">
      <doc xml:space="preserve">The users specified by the #GDataCalendarAccessRule have full edit access to
the calendar, except they can’t change the calendar’s access rules.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CALENDAR_ACCESS_ROLE_FREE_BUSY"
              value="http://schemas.google.com/gCal/2005#freebusy"
              c:type="GDATA_CALENDAR_ACCESS_ROLE_FREE_BUSY"
              version="0.7.0">
      <doc xml:space="preserve">The users specified by the #GDataCalendarAccessRule can only see the
free/busy information on the calendar; not event details.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CALENDAR_ACCESS_ROLE_OWNER"
              value="http://schemas.google.com/gCal/2005#owner"
              c:type="GDATA_CALENDAR_ACCESS_ROLE_OWNER"
              version="0.7.0">
      <doc xml:space="preserve">The users specified by the #GDataCalendarAccessRule have full owner access
to the calendar.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CALENDAR_ACCESS_ROLE_READ"
              value="http://schemas.google.com/gCal/2005#read"
              c:type="GDATA_CALENDAR_ACCESS_ROLE_READ"
              version="0.7.0">
      <doc xml:space="preserve">The users specified by the #GDataCalendarAccessRule have read-only access to
the calendar.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CALENDAR_ACCESS_ROLE_ROOT"
              value="http://schemas.google.com/gCal/2005#root"
              c:type="GDATA_CALENDAR_ACCESS_ROLE_ROOT"
              version="0.7.0">
      <doc xml:space="preserve">The users specified by the #GDataCalendarAccessRule have full administrator
access to the calendar server. This is only available in Google Apps For
Your Domain.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CATEGORY_SCHEMA_LABELS"
              value="http://schemas.google.com/g/2005/labels"
              c:type="GDATA_CATEGORY_SCHEMA_LABELS"
              version="0.11.0">
      <doc xml:space="preserve">A schema for categories which label the entry they're applied to in some way, such as starring it. The semantics of the various labels
(such as %GDATA_CATEGORY_SCHEMA_LABELS_STARRED) are service-specific.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_GENDER_FEMALE"
              value="female"
              c:type="GDATA_CONTACTS_GENDER_FEMALE"
              version="0.7.0">
      <doc xml:space="preserve">The contact is female.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_GENDER_MALE"
              value="male"
              c:type="GDATA_CONTACTS_GENDER_MALE"
              version="0.7.0">
      <doc xml:space="preserve">The contact is male.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_GROUP_CONTACTS"
              value="Contacts"
              c:type="GDATA_CONTACTS_GROUP_CONTACTS"
              version="0.7.0">
      <doc xml:space="preserve">The system group ID for the "My Contacts" system group.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_GROUP_COWORKERS"
              value="Coworkers"
              c:type="GDATA_CONTACTS_GROUP_COWORKERS"
              version="0.7.0">
      <doc xml:space="preserve">The system group ID for the "Coworkers" system group.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_GROUP_FAMILY"
              value="Family"
              c:type="GDATA_CONTACTS_GROUP_FAMILY"
              version="0.7.0">
      <doc xml:space="preserve">The system group ID for the "Family" system group.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_GROUP_FRIENDS"
              value="Friends"
              c:type="GDATA_CONTACTS_GROUP_FRIENDS"
              version="0.7.0">
      <doc xml:space="preserve">The system group ID for the "Friends" system group.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_PRIORITY_HIGH"
              value="high"
              c:type="GDATA_CONTACTS_PRIORITY_HIGH"
              version="0.7.0">
      <doc xml:space="preserve">The contact is of high importance.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_PRIORITY_LOW"
              value="low"
              c:type="GDATA_CONTACTS_PRIORITY_LOW"
              version="0.7.0">
      <doc xml:space="preserve">The contact is of low importance.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_PRIORITY_NORMAL"
              value="normal"
              c:type="GDATA_CONTACTS_PRIORITY_NORMAL"
              version="0.7.0">
      <doc xml:space="preserve">The contact is of normal importance.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_SENSITIVITY_CONFIDENTIAL"
              value="confidential"
              c:type="GDATA_CONTACTS_SENSITIVITY_CONFIDENTIAL"
              version="0.7.0">
      <doc xml:space="preserve">The contact's data is confidential.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_SENSITIVITY_NORMAL"
              value="normal"
              c:type="GDATA_CONTACTS_SENSITIVITY_NORMAL"
              version="0.7.0">
      <doc xml:space="preserve">The contact's data is of normal sensitivity.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_SENSITIVITY_PERSONAL"
              value="personal"
              c:type="GDATA_CONTACTS_SENSITIVITY_PERSONAL"
              version="0.7.0">
      <doc xml:space="preserve">The contact's data is personal.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="CONTACTS_SENSITIVITY_PRIVATE"
              value="private"
              c:type="GDATA_CONTACTS_SENSITIVITY_PRIVATE"
              version="0.7.0">
      <doc xml:space="preserve">The contact's data is private.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <class name="CalendarAccessRule"
           c:symbol-prefix="calendar_access_rule"
           c:type="GDataCalendarAccessRule"
           version="0.17.2"
           parent="AccessRule"
           glib:type-name="GDataCalendarAccessRule"
           glib:get-type="gdata_calendar_access_rule_get_type"
           glib:type-struct="CalendarAccessRuleClass">
      <doc xml:space="preserve">All the fields in the #GDataCalendarAccessRule structure are private and
should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_calendar_access_rule_new"
                   version="0.17.2">
        <doc xml:space="preserve">Creates a new #GDataCalendarAccessRule with the given ID and default
properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataCalendarAccessRule; unref with
  g_object_unref()</doc>
          <type name="CalendarAccessRule" c:type="GDataCalendarAccessRule*"/>
        </return-value>
        <parameters>
          <parameter name="id" transfer-ownership="none">
            <doc xml:space="preserve">the access rule's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <field name="parent">
        <type name="AccessRule" c:type="GDataAccessRule"/>
      </field>
    </class>
    <record name="CalendarAccessRuleClass"
            c:type="GDataCalendarAccessRuleClass"
            glib:is-gtype-struct-for="CalendarAccessRule"
            version="0.17.2">
      <doc xml:space="preserve">All the fields in the #GDataCalendarAccessRuleClass structure are private
and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="AccessRuleClass" c:type="GDataAccessRuleClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <class name="CalendarCalendar"
           c:symbol-prefix="calendar_calendar"
           c:type="GDataCalendarCalendar"
           parent="Entry"
           glib:type-name="GDataCalendarCalendar"
           glib:get-type="gdata_calendar_calendar_get_type"
           glib:type-struct="CalendarCalendarClass">
      <doc xml:space="preserve">All the fields in the #GDataCalendarCalendar structure are private and should never be accessed directly.</doc>
      <implements name="AccessHandler"/>
      <constructor name="new" c:identifier="gdata_calendar_calendar_new">
        <doc xml:space="preserve">Creates a new #GDataCalendarCalendar with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataCalendarCalendar; unref with g_object_unref()</doc>
          <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the calendar's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_access_level"
              c:identifier="gdata_calendar_calendar_get_access_level">
        <doc xml:space="preserve">Gets the #GDataCalendarCalendar:access-level property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the authenticated user's access level to the calendar, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_color"
              c:identifier="gdata_calendar_calendar_get_color">
        <doc xml:space="preserve">Gets the #GDataCalendarCalendar:color property and puts it in @color.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </instance-parameter>
          <parameter name="color"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:space="preserve">a #GDataColor</doc>
            <type name="Color" c:type="GDataColor*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_edited"
              c:identifier="gdata_calendar_calendar_get_edited"
              deprecated="1"
              deprecated-version="0.17.2">
        <doc xml:space="preserve">Gets the #GDataCalendarCalendar:edited property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <doc-deprecated xml:space="preserve">Unsupported by the online API any more. There is no
  replacement; this will always return &lt;code class="literal"&gt;-1&lt;/code&gt;.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the time the calendar was last edited, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_times_cleaned"
              c:identifier="gdata_calendar_calendar_get_times_cleaned"
              deprecated="1"
              deprecated-version="0.17.2">
        <doc xml:space="preserve">Gets the #GDataCalendarCalendar:times-cleaned property.</doc>
        <doc-deprecated xml:space="preserve">Unsupported by the online API any more. There is no
  replacement; this will always return &lt;code class="literal"&gt;0&lt;/code&gt;.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the number of times the calendar has been totally emptied</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_timezone"
              c:identifier="gdata_calendar_calendar_get_timezone">
        <doc xml:space="preserve">Gets the #GDataCalendarCalendar:timezone property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the calendar's timezone, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_hidden"
              c:identifier="gdata_calendar_calendar_is_hidden"
              version="0.2.0">
        <doc xml:space="preserve">Gets the #GDataCalendarCalendar:is-hidden property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the calendar is hidden, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_selected"
              c:identifier="gdata_calendar_calendar_is_selected"
              version="0.2.0">
        <doc xml:space="preserve">Gets the #GDataCalendarCalendar:is-selected property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the calendar is selected, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_color"
              c:identifier="gdata_calendar_calendar_set_color">
        <doc xml:space="preserve">Sets the #GDataCalendarCalendar:color property to @color.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </instance-parameter>
          <parameter name="color" transfer-ownership="none">
            <doc xml:space="preserve">a new #GDataColor</doc>
            <type name="Color" c:type="const GDataColor*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_hidden"
              c:identifier="gdata_calendar_calendar_set_is_hidden"
              version="0.2.0">
        <doc xml:space="preserve">Sets the #GDataCalendarCalendar:is-hidden property to @is_hidden.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </instance-parameter>
          <parameter name="is_hidden" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE to hide the calendar, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_selected"
              c:identifier="gdata_calendar_calendar_set_is_selected"
              version="0.2.0">
        <doc xml:space="preserve">Sets the #GDataCalendarCalendar:is-selected property to @is_selected.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </instance-parameter>
          <parameter name="is_selected" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE to select the calendar, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_timezone"
              c:identifier="gdata_calendar_calendar_set_timezone">
        <doc xml:space="preserve">Sets the #GDataCalendarCalendar:timezone property to the new timezone, @_timezone.

Set @_timezone to %NULL to unset the property in the calendar.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </instance-parameter>
          <parameter name="_timezone"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new timezone, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="access-level" transfer-ownership="none">
        <doc xml:space="preserve">Indicates the access level the current user has to the calendar. For example: %GDATA_CALENDAR_ACCESS_ROLE_READ or
%GDATA_CALENDAR_ACCESS_ROLE_FREE_BUSY. The "current user" is the one authenticated against the service's #GDataService:authorizer,
or the guest user.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="color" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">The background color used to highlight the calendar in the user’s
browser. This used to be restricted to a limited set of colours, but
since 0.17.2 may be any RGB colour.</doc>
        <type name="Color"/>
      </property>
      <property name="edited"
                deprecated="1"
                deprecated-version="0.17.2"
                transfer-ownership="none">
        <doc xml:space="preserve">The last time the calendar was edited. If the calendar has not been edited yet, the content indicates the time it was created.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/protocol/#appEdited"&gt;
Atom Publishing Protocol specification&lt;/ulink&gt;.</doc>
        <doc-deprecated xml:space="preserve">Unsupported by the online API any more. There
is no replacement; this will always return -1.</doc-deprecated>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="is-hidden"
                version="0.2.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates whether the calendar is visible.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="is-selected"
                version="0.2.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates whether the calendar is selected.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="times-cleaned"
                deprecated="1"
                deprecated-version="0.17.2"
                transfer-ownership="none">
        <doc xml:space="preserve">The number of times the calendar has been cleared of events.</doc>
        <doc-deprecated xml:space="preserve">Unsupported by the online API any more. There
  is no replacement; this will always return
  &lt;code class="literal"&gt;0&lt;/code&gt;.</doc-deprecated>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="timezone" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">The timezone in which the calendar's times are given. This is a timezone name in tz database notation: &lt;ulink type="http"
url="http://en.wikipedia.org/wiki/Tz_database#Names_of_time_zones"&gt;reference&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="CalendarCalendarPrivate"
              c:type="GDataCalendarCalendarPrivate*"/>
      </field>
    </class>
    <record name="CalendarCalendarClass"
            c:type="GDataCalendarCalendarClass"
            glib:is-gtype-struct-for="CalendarCalendar">
      <doc xml:space="preserve">All the fields in the #GDataCalendarCalendarClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="CalendarCalendarPrivate"
            c:type="GDataCalendarCalendarPrivate"
            disguised="1">
    </record>
    <class name="CalendarEvent"
           c:symbol-prefix="calendar_event"
           c:type="GDataCalendarEvent"
           parent="Entry"
           glib:type-name="GDataCalendarEvent"
           glib:get-type="gdata_calendar_event_get_type"
           glib:type-struct="CalendarEventClass">
      <doc xml:space="preserve">All the fields in the #GDataCalendarEvent structure are private and should never be accessed directly.</doc>
      <constructor name="new" c:identifier="gdata_calendar_event_new">
        <doc xml:space="preserve">Creates a new #GDataCalendarEvent with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataCalendarEvent; unref with g_object_unref()</doc>
          <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the event's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="add_person" c:identifier="gdata_calendar_event_add_person">
        <doc xml:space="preserve">Adds the person @who to the event as a guest (attendee, organiser, performer, etc.), and increments its reference count.

Duplicate people will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="who" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWho to add</doc>
            <type name="GDWho" c:type="GDataGDWho*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_place" c:identifier="gdata_calendar_event_add_place">
        <doc xml:space="preserve">Adds the place @where to the event as a location and increments its reference count.

Duplicate places will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="where" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhere to add</doc>
            <type name="GDWhere" c:type="GDataGDWhere*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_time"
              c:identifier="gdata_calendar_event_add_time"
              version="0.2.0">
        <doc xml:space="preserve">Adds @when to the event as a time period when the event happens, and increments its reference count.

Duplicate times will not be added to the list.

Note: gdata_calendar_event_add_time() and gdata_calendar_event_set_recurrence() are mutually
exclusive, as the server doesn't support positive exceptions to recurrence rules. If recurrences
are required, use gdata_calendar_event_set_recurrence(). Note that this means reminders cannot
be set for the event, as they are only supported by #GDataGDWhen. No checks are performed for
these forbidden conditions, as to do so would break libgdata's API; if both a recurrence is set
and a specific time is added, the server will return an error when the #GDataCalendarEvent is
inserted using gdata_service_insert_entry().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="when" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhen to add</doc>
            <type name="GDWhen" c:type="GDataGDWhen*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_anyone_can_add_self"
              c:identifier="gdata_calendar_event_get_anyone_can_add_self">
        <doc xml:space="preserve">Gets the #GDataCalendarEvent:anyone-can-add-self property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if anyone can add themselves as an attendee to the event, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_edited" c:identifier="gdata_calendar_event_get_edited">
        <doc xml:space="preserve">Gets the #GDataCalendarEvent:edited property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the time the event was last edited, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_guests_can_invite_others"
              c:identifier="gdata_calendar_event_get_guests_can_invite_others">
        <doc xml:space="preserve">Gets the #GDataCalendarEvent:guests-can-invite-others property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if attendees can invite others to the event, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_guests_can_modify"
              c:identifier="gdata_calendar_event_get_guests_can_modify">
        <doc xml:space="preserve">Gets the #GDataCalendarEvent:guests-can-modify property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if attendees can modify the original event, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_guests_can_see_guests"
              c:identifier="gdata_calendar_event_get_guests_can_see_guests">
        <doc xml:space="preserve">Gets the #GDataCalendarEvent:guests-can-see-guests property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if attendees can see who's attending the event, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_original_event_details"
              c:identifier="gdata_calendar_event_get_original_event_details"
              version="0.3.0">
        <doc xml:space="preserve">Gets details of the original event, if this event is an exception to a recurring event. The original
event's ID and the URI of the event's XML are returned in @event_id and @event_uri, respectively.

If this event is not an exception to a recurring event, @event_id and @event_uri will be set to %NULL.
See gdata_calendar_event_is_exception() to determine more simply whether an event is an exception to a
recurring event.

If both @event_id and @event_uri are %NULL, this function is a no-op. Otherwise, they should both be
freed with g_free().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="event_id"
                     direction="out"
                     caller-allocates="0"
                     transfer-ownership="full">
            <doc xml:space="preserve">return location for the original event's ID, or %NULL</doc>
            <type name="utf8" c:type="gchar**"/>
          </parameter>
          <parameter name="event_uri"
                     direction="out"
                     caller-allocates="0"
                     transfer-ownership="full">
            <doc xml:space="preserve">return location for the original event's URI, or %NULL</doc>
            <type name="utf8" c:type="gchar**"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_people"
              c:identifier="gdata_calendar_event_get_people"
              version="0.2.0">
        <doc xml:space="preserve">Gets a list of the people attending the event.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGDWho&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GDWho"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_places"
              c:identifier="gdata_calendar_event_get_places"
              version="0.2.0">
        <doc xml:space="preserve">Gets a list of the locations associated with the event.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGDWhere&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GDWhere"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_primary_time"
              c:identifier="gdata_calendar_event_get_primary_time"
              version="0.2.0">
        <doc xml:space="preserve">Gets the first time period associated with the event, conveniently returning just its start and
end times if required.

If there are no time periods, or more than one time period, associated with the event, %FALSE will
be returned, and the parameters will remain unmodified.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if there is only one time period associated with the event, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="start_time"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:space="preserve">a #gint64 for the start time, or %NULL</doc>
            <type name="gint64" c:type="gint64*"/>
          </parameter>
          <parameter name="end_time"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:space="preserve">a #gint64 for the end time, or %NULL</doc>
            <type name="gint64" c:type="gint64*"/>
          </parameter>
          <parameter name="when"
                     direction="out"
                     caller-allocates="0"
                     transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhen for the primary time structure, or %NULL</doc>
            <type name="GDWhen" c:type="GDataGDWhen**"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_recurrence"
              c:identifier="gdata_calendar_event_get_recurrence"
              version="0.3.0">
        <doc xml:space="preserve">Gets the #GDataCalendarEvent:recurrence property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the event recurrence patterns, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_sequence"
              c:identifier="gdata_calendar_event_get_sequence">
        <doc xml:space="preserve">Gets the #GDataCalendarEvent:sequence property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the event's sequence number</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_status"
              c:identifier="gdata_calendar_event_get_status"
              version="0.2.0">
        <doc xml:space="preserve">Gets the #GDataCalendarEvent:status property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the event status, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_times"
              c:identifier="gdata_calendar_event_get_times"
              version="0.2.0">
        <doc xml:space="preserve">Gets a list of the time periods associated with the event.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGDWhen&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GDWhen"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_transparency"
              c:identifier="gdata_calendar_event_get_transparency">
        <doc xml:space="preserve">Gets the #GDataCalendarEvent:transparency property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the event transparency, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_uid" c:identifier="gdata_calendar_event_get_uid">
        <doc xml:space="preserve">Gets the #GDataCalendarEvent:uid property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the event's UID, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_visibility"
              c:identifier="gdata_calendar_event_get_visibility">
        <doc xml:space="preserve">Gets the #GDataCalendarEvent:visibility property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the event visibility, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_exception"
              c:identifier="gdata_calendar_event_is_exception"
              version="0.3.0">
        <doc xml:space="preserve">Determines whether the event is an exception to a recurring event. If it is, details of the original event
can be retrieved using gdata_calendar_event_get_original_event_details().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the event is an exception, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_anyone_can_add_self"
              c:identifier="gdata_calendar_event_set_anyone_can_add_self">
        <doc xml:space="preserve">Sets the #GDataCalendarEvent:anyone-can-add-self property to @anyone_can_add_self.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="anyone_can_add_self" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if anyone can add themselves as an attendee to the event, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_guests_can_invite_others"
              c:identifier="gdata_calendar_event_set_guests_can_invite_others">
        <doc xml:space="preserve">Sets the #GDataCalendarEvent:guests-can-invite-others property to @guests_can_invite_others.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="guests_can_invite_others" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if attendees can invite others to the event, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_guests_can_modify"
              c:identifier="gdata_calendar_event_set_guests_can_modify">
        <doc xml:space="preserve">Sets the #GDataCalendarEvent:guests-can-modify property to @guests_can_modify.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="guests_can_modify" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if attendees can modify the original event, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_guests_can_see_guests"
              c:identifier="gdata_calendar_event_set_guests_can_see_guests">
        <doc xml:space="preserve">Sets the #GDataCalendarEvent:guests-can-see-guests property to @guests_can_see_guests.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="guests_can_see_guests" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if attendees can see who's attending the event, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_recurrence"
              c:identifier="gdata_calendar_event_set_recurrence"
              version="0.3.0">
        <doc xml:space="preserve">Sets the #GDataCalendarEvent:recurrence property to the new recurrence, @recurrence.

Set @recurrence to %NULL to unset the property in the event.

Note: gdata_calendar_event_add_time() and gdata_calendar_event_set_recurrence() are mutually
exclusive. See the documentation for gdata_calendar_event_add_time() for details.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="recurrence"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new event recurrence, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_sequence"
              c:identifier="gdata_calendar_event_set_sequence">
        <doc xml:space="preserve">Sets the #GDataCalendarEvent:sequence property to the new sequence number, @sequence.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="sequence" transfer-ownership="none">
            <doc xml:space="preserve">a new sequence number, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_status"
              c:identifier="gdata_calendar_event_set_status"
              version="0.2.0">
        <doc xml:space="preserve">Sets the #GDataCalendarEvent:status property to the new status, @status.

Set @status to %NULL to unset the property in the event.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="status"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new event status, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_transparency"
              c:identifier="gdata_calendar_event_set_transparency">
        <doc xml:space="preserve">Sets the #GDataCalendarEvent:transparency property to the new transparency, @transparency.

Set @transparency to %NULL to unset the property in the event.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="transparency"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new event transparency, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_uid" c:identifier="gdata_calendar_event_set_uid">
        <doc xml:space="preserve">Sets the #GDataCalendarEvent:uid property to the new UID, @uid.

Set @uid to %NULL to unset the property in the event.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="uid"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new event UID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_visibility"
              c:identifier="gdata_calendar_event_set_visibility">
        <doc xml:space="preserve">Sets the #GDataCalendarEvent:visibility property to the new visibility, @visibility.

Set @visibility to %NULL to unset the property in the event.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarEvent</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </instance-parameter>
          <parameter name="visibility"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new event visibility, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="anyone-can-add-self"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates whether anyone can invite themselves to the event, by adding themselves to the attendee list.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="edited" transfer-ownership="none">
        <doc xml:space="preserve">The last time the event was edited. If the event has not been edited yet, the content indicates the time it was created.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/protocol/#appEdited"&gt;
Atom Publishing Protocol specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="guests-can-invite-others"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates whether attendees may invite others to the event.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/google-apps/calendar/v3/reference/events#guestsCanInviteOthers"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="guests-can-modify"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates whether attendees may modify the original event, so that changes are visible to organizers and other attendees.
Otherwise, any changes made by attendees will be restricted to that attendee's calendar.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/calendar/v3/reference/events#guestsCanInviteOthers"&gt;
GData specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="guests-can-see-guests"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates whether attendees can see other people invited to the event.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/calendar/v3/reference/events#guestsCanSeeOtherGuests"&gt;
GData specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="original-event-id"
                version="0.3.0"
                transfer-ownership="none">
        <doc xml:space="preserve">The event ID for the original event, if this event is an exception to a recurring event.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="original-event-uri"
                version="0.3.0"
                transfer-ownership="none">
        <doc xml:space="preserve">The event URI for the original event, if this event is an exception to a recurring event.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="recurrence"
                version="0.3.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Represents the dates and times when a recurring event takes place. The returned string is in iCal format, as a list of properties.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/gdata/elements.html#gdRecurrence"&gt;
GData specification&lt;/ulink&gt;.

Note: gdata_calendar_event_add_time() and gdata_calendar_event_set_recurrence() are mutually
exclusive. See the documentation for gdata_calendar_event_add_time() for details.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="sequence" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">The revision sequence number of the event as defined in Section 4.8.7.4 of &lt;ulink type="http"
url="http://www.ietf.org/rfc/rfc2445.txt"&gt;RFC 2445&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="status"
                version="0.2.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The scheduling status of the event. For example: %GDATA_GD_EVENT_STATUS_CANCELED or %GDATA_GD_EVENT_STATUS_CONFIRMED.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/gdata/elements.html#gdEventStatus"&gt;
GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="transparency" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">How the event is marked as consuming time on a calendar. For example: %GDATA_GD_EVENT_TRANSPARENCY_OPAQUE or
%GDATA_GD_EVENT_TRANSPARENCY_TRANSPARENT.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/gdata/elements.html#gdTransparency"&gt;
GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="uid" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">The globally unique identifier (UID) of the event as defined in Section 4.8.4.7 of &lt;ulink type="http"
url="http://www.ietf.org/rfc/rfc2445.txt"&gt;RFC 2445&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="visibility" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">The event's visibility to calendar users. For example: %GDATA_GD_EVENT_VISIBILITY_PUBLIC or %GDATA_GD_EVENT_VISIBILITY_DEFAULT.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/gdata/elements.html#gdVisibility"&gt;
GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="CalendarEventPrivate" c:type="GDataCalendarEventPrivate*"/>
      </field>
    </class>
    <record name="CalendarEventClass"
            c:type="GDataCalendarEventClass"
            glib:is-gtype-struct-for="CalendarEvent">
      <doc xml:space="preserve">All the fields in the #GDataCalendarEventClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="CalendarEventPrivate"
            c:type="GDataCalendarEventPrivate"
            disguised="1">
    </record>
    <class name="CalendarFeed"
           c:symbol-prefix="calendar_feed"
           c:type="GDataCalendarFeed"
           version="0.3.0"
           parent="Feed"
           glib:type-name="GDataCalendarFeed"
           glib:get-type="gdata_calendar_feed_get_type"
           glib:type-struct="CalendarFeedClass">
      <doc xml:space="preserve">All the fields in the #GDataCalendarFeed structure are private and should never be accessed directly.</doc>
      <method name="get_times_cleaned"
              c:identifier="gdata_calendar_feed_get_times_cleaned"
              version="0.3.0"
              deprecated="1"
              deprecated-version="0.17.2">
        <doc xml:space="preserve">Gets the #GDataCalendarFeed:times-cleaned property.</doc>
        <doc-deprecated xml:space="preserve">Unsupported by the online API any more. There is no
  replacement; this will always return %NULL.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the number of times the feed has been totally emptied</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarFeed</doc>
            <type name="CalendarFeed" c:type="GDataCalendarFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_timezone"
              c:identifier="gdata_calendar_feed_get_timezone"
              version="0.3.0"
              deprecated="1"
              deprecated-version="0.17.2">
        <doc xml:space="preserve">Gets the #GDataCalendarFeed:timezone property.</doc>
        <doc-deprecated xml:space="preserve">Unsupported by the online API any more. There is no
  replacement; this will always return %NULL.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the feed's timezone, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarFeed</doc>
            <type name="CalendarFeed" c:type="GDataCalendarFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="times-cleaned"
                version="0.3.0"
                deprecated="1"
                deprecated-version="0.17.2"
                transfer-ownership="none">
        <doc xml:space="preserve">The number of times the feed has been completely cleared of entries.</doc>
        <doc-deprecated xml:space="preserve">Unsupported by the online API any more. There
  is no replacement; this will always return 0.</doc-deprecated>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="timezone"
                version="0.3.0"
                deprecated="1"
                deprecated-version="0.17.2"
                transfer-ownership="none">
        <doc xml:space="preserve">The timezone in which the feed's times are given. This is a timezone name in tz database notation: &lt;ulink type="http"
url="http://en.wikipedia.org/wiki/Tz_database#Names_of_time_zones"&gt;reference&lt;/ulink&gt;.</doc>
        <doc-deprecated xml:space="preserve">Unsupported by the online API any more. There
  is no replacement; this will always return %NULL.</doc-deprecated>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Feed" c:type="GDataFeed"/>
      </field>
      <field name="priv">
        <type name="CalendarFeedPrivate" c:type="GDataCalendarFeedPrivate*"/>
      </field>
    </class>
    <record name="CalendarFeedClass"
            c:type="GDataCalendarFeedClass"
            glib:is-gtype-struct-for="CalendarFeed"
            version="0.3.0">
      <doc xml:space="preserve">All the fields in the #GDataCalendarFeedClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="FeedClass" c:type="GDataFeedClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="CalendarFeedPrivate"
            c:type="GDataCalendarFeedPrivate"
            disguised="1">
    </record>
    <class name="CalendarQuery"
           c:symbol-prefix="calendar_query"
           c:type="GDataCalendarQuery"
           parent="Query"
           glib:type-name="GDataCalendarQuery"
           glib:get-type="gdata_calendar_query_get_type"
           glib:type-struct="CalendarQueryClass">
      <doc xml:space="preserve">All the fields in the #GDataCalendarQuery structure are private and should never be accessed directly.</doc>
      <constructor name="new" c:identifier="gdata_calendar_query_new">
        <doc xml:space="preserve">Creates a new #GDataCalendarQuery with its #GDataQuery:q property set to @q.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataCalendarQuery</doc>
          <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
        </return-value>
        <parameters>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <constructor name="new_with_limits"
                   c:identifier="gdata_calendar_query_new_with_limits">
        <doc xml:space="preserve">Creates a new #GDataCalendarQuery with its #GDataQuery:q property set to @q, and the time limits @start_min and @start_max
applied.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataCalendarQuery</doc>
          <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
        </return-value>
        <parameters>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="start_min" transfer-ownership="none">
            <doc xml:space="preserve">a starting time for the event period, or -1</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
          <parameter name="start_max" transfer-ownership="none">
            <doc xml:space="preserve">an ending time for the event period, or -1</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_future_events"
              c:identifier="gdata_calendar_query_get_future_events">
        <doc xml:space="preserve">Gets the #GDataCalendarQuery:future-events property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the future events property</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_max_attendees"
              c:identifier="gdata_calendar_query_get_max_attendees"
              version="0.9.1">
        <doc xml:space="preserve">Gets the #GDataCalendarQuery:max-attendees property. If the property is unset, &lt;code class="literal"&gt;0&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the maximum number of attendees, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_order_by"
              c:identifier="gdata_calendar_query_get_order_by">
        <doc xml:space="preserve">Gets the #GDataCalendarQuery:order-by property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the order by property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_recurrence_expansion_end"
              c:identifier="gdata_calendar_query_get_recurrence_expansion_end">
        <doc xml:space="preserve">Gets the #GDataCalendarQuery:recurrence-expansion-end property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the recurrence-expansion-end property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_recurrence_expansion_start"
              c:identifier="gdata_calendar_query_get_recurrence_expansion_start">
        <doc xml:space="preserve">Gets the #GDataCalendarQuery:recurrence-expansion-start property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the recurrence-expansion-start property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_single_events"
              c:identifier="gdata_calendar_query_get_single_events">
        <doc xml:space="preserve">Gets the #GDataCalendarQuery:single-events property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the single events property</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_sort_order"
              c:identifier="gdata_calendar_query_get_sort_order">
        <doc xml:space="preserve">Gets the #GDataCalendarQuery:sort-order property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the sort order property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_start_max"
              c:identifier="gdata_calendar_query_get_start_max">
        <doc xml:space="preserve">Gets the #GDataCalendarQuery:start-max property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the start-max property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_start_min"
              c:identifier="gdata_calendar_query_get_start_min">
        <doc xml:space="preserve">Gets the #GDataCalendarQuery:start-min property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the start-min property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_timezone"
              c:identifier="gdata_calendar_query_get_timezone"
              version="0.2.0">
        <doc xml:space="preserve">Gets the #GDataCalendarQuery:timezone property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the timezone property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_future_events"
              c:identifier="gdata_calendar_query_set_future_events">
        <doc xml:space="preserve">Sets the #GDataCalendarQuery:future-events property of the #GDataCalendarQuery to @future_events.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
          <parameter name="future_events" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE to unconditionally show future events, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_max_attendees"
              c:identifier="gdata_calendar_query_set_max_attendees"
              version="0.9.1">
        <doc xml:space="preserve">Sets the #GDataCalendarQuery:max-attendees property of the #GDataCalendarQuery to the new value, @max_attendees.

Set @max_attendees to &lt;code class="literal"&gt;0&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
          <parameter name="max_attendees" transfer-ownership="none">
            <doc xml:space="preserve">a new maximum attendee count, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_order_by"
              c:identifier="gdata_calendar_query_set_order_by">
        <doc xml:space="preserve">Sets the #GDataCalendarQuery:order-by property of the #GDataCalendarQuery to the new order by string, @order_by.

Set @order_by to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
          <parameter name="order_by"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new order by string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_recurrence_expansion_end"
              c:identifier="gdata_calendar_query_set_recurrence_expansion_end">
        <doc xml:space="preserve">Sets the #GDataCalendarQuery:recurrence-expansion-end property of the #GDataCalendarQuery
to the new time/date, @end.

Set @end to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
          <parameter name="end" transfer-ownership="none">
            <doc xml:space="preserve">a new end time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_recurrence_expansion_start"
              c:identifier="gdata_calendar_query_set_recurrence_expansion_start">
        <doc xml:space="preserve">Sets the #GDataCalendarQuery:recurrence-expansion-start property of the #GDataCalendarQuery
to the new time/date, @start.

Set @start to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
          <parameter name="start" transfer-ownership="none">
            <doc xml:space="preserve">a new start time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_show_deleted"
              c:identifier="gdata_calendar_query_set_show_deleted"
              version="0.9.1">
        <doc xml:space="preserve">Sets the #GDataCalendarQuery:show-deleted property of the #GDataCalendarQuery.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
          <parameter name="show_deleted" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE to show deleted events, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_single_events"
              c:identifier="gdata_calendar_query_set_single_events">
        <doc xml:space="preserve">Sets the #GDataCalendarQuery:single-events property of the #GDataCalendarQuery to @single_events.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
          <parameter name="single_events" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE to show recurring events as single events, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_sort_order"
              c:identifier="gdata_calendar_query_set_sort_order">
        <doc xml:space="preserve">Sets the #GDataCalendarQuery:sort-order property of the #GDataCalendarQuery to the new sort order string, @sort_order.

Set @sort_order to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
          <parameter name="sort_order"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new sort order string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_start_max"
              c:identifier="gdata_calendar_query_set_start_max">
        <doc xml:space="preserve">Sets the #GDataCalendarQuery:start-max property of the #GDataCalendarQuery
to the new time/date, @start_max.

Set @start_max to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
          <parameter name="start_max" transfer-ownership="none">
            <doc xml:space="preserve">a new maximum start time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_start_min"
              c:identifier="gdata_calendar_query_set_start_min">
        <doc xml:space="preserve">Sets the #GDataCalendarQuery:start-min property of the #GDataCalendarQuery
to the new time/date, @start_min.

Set @start_min to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
          <parameter name="start_min" transfer-ownership="none">
            <doc xml:space="preserve">a new minimum start time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_timezone"
              c:identifier="gdata_calendar_query_set_timezone"
              version="0.2.0">
        <doc xml:space="preserve">Sets the #GDataCalendarQuery:timezone property of the #GDataCalendarQuery to the new timezone string, @timezone.

Set @timezone to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
          <parameter name="_timezone"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new timezone string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="show_deleted"
              c:identifier="gdata_calendar_query_show_deleted"
              version="0.9.1">
        <doc xml:space="preserve">Gets the #GDataCalendarQuery:show-deleted property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if deleted/cancelled events should be shown, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarQuery</doc>
            <type name="CalendarQuery" c:type="GDataCalendarQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="future-events" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">A shortcut to request all events scheduled for the future. Overrides the
#GDataCalendarQuery:recurrence-expansion-start, #GDataCalendarQuery:recurrence-expansion-end,
#GDataCalendarQuery:start-min and #GDataCalendarQuery:start-max properties.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="max-attendees"
                version="0.9.1"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies the maximum number of attendees to list for an event. If the actual number of attendees for an event is greater than this value,
only the current user and the event organiser are listed.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="order-by" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">Specifies order of entries in a feed. Supported values are &lt;literal&gt;lastmodified&lt;/literal&gt; and
&lt;literal&gt;starttime&lt;/literal&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="recurrence-expansion-end"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies the end of the time period to expand recurring events for, exclusive.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="recurrence-expansion-start"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies the beginning of the time period to expand recurring events for, inclusive.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="show-deleted"
                version="0.9.1"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Whether to include deleted/cancelled events in the query feed. Deleted events have their #GDataCalendarEvent:status property set to
%GDATA_GD_EVENT_STATUS_CANCELED. They do not normally appear in query results.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="single-events" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">Indicates whether recurring events should be expanded or represented as a single event.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="sort-order" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">Specifies direction of sorting. Supported values are &lt;literal&gt;ascending&lt;/literal&gt; and
&lt;literal&gt;descending&lt;/literal&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="start-max" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">Together with #GDataCalendarQuery:start-min, creates a timespan such that only events within the timespan are returned

#GDataCalendarQuery:start-min is inclusive, while #GDataCalendarQuery:start-max is exclusive. Events that overlap the range are
included.

If not specified, the default #GDataCalendarQuery:start-max is &lt;literal&gt;2031-01-01&lt;/literal&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="start-min" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">Together with #GDataCalendarQuery:start-max, creates a timespan such that only events within the timespan are returned.

#GDataCalendarQuery:start-min is inclusive, while #GDataCalendarQuery:start-max is exclusive. Events that overlap the range are
included.

If not specified, the default #GDataCalendarQuery:start-min is &lt;literal&gt;1970-01-01&lt;/literal&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="timezone"
                version="0.2.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The current timezone. If this is not specified, all times are returned in UTC.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Query" c:type="GDataQuery"/>
      </field>
      <field name="priv">
        <type name="CalendarQueryPrivate" c:type="GDataCalendarQueryPrivate*"/>
      </field>
    </class>
    <record name="CalendarQueryClass"
            c:type="GDataCalendarQueryClass"
            glib:is-gtype-struct-for="CalendarQuery">
      <doc xml:space="preserve">All the fields in the #GDataCalendarQueryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="QueryClass" c:type="GDataQueryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="CalendarQueryPrivate"
            c:type="GDataCalendarQueryPrivate"
            disguised="1">
    </record>
    <class name="CalendarService"
           c:symbol-prefix="calendar_service"
           c:type="GDataCalendarService"
           parent="Service"
           glib:type-name="GDataCalendarService"
           glib:get-type="gdata_calendar_service_get_type"
           glib:type-struct="CalendarServiceClass">
      <doc xml:space="preserve">All the fields in the #GDataCalendarService structure are private and should never be accessed directly.</doc>
      <implements name="Batchable"/>
      <constructor name="new"
                   c:identifier="gdata_calendar_service_new"
                   version="0.9.0">
        <doc xml:space="preserve">Creates a new #GDataCalendarService using the given #GDataAuthorizer. If @authorizer is %NULL, all requests are made as an unauthenticated user.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataCalendarService, or %NULL; unref with g_object_unref()</doc>
          <type name="CalendarService" c:type="GDataCalendarService*"/>
        </return-value>
        <parameters>
          <parameter name="authorizer"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataAuthorizer to authorize the service's requests, or %NULL</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </parameter>
        </parameters>
      </constructor>
      <function name="get_primary_authorization_domain"
                c:identifier="gdata_calendar_service_get_primary_authorization_domain"
                version="0.9.0">
        <doc xml:space="preserve">The primary #GDataAuthorizationDomain for interacting with Google Calendar. This will not normally need to be used, as it's used internally
by the #GDataCalendarService methods. However, if using the plain #GDataService methods to implement custom queries or requests which libgdata
does not support natively, then this domain may be needed to authorize the requests.

The domain never changes, and is interned so that pointer comparison can be used to differentiate it from other authorization domains.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the service's authorization domain</doc>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
      </function>
      <method name="insert_calendar_event"
              c:identifier="gdata_calendar_service_insert_calendar_event"
              version="0.17.2"
              throws="1">
        <doc xml:space="preserve">Inserts @event by uploading it to the online calendar service, adding it to
the specified @calendar.

For more details, see gdata_service_insert_entry().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataCalendarEvent, or %NULL;
unref with g_object_unref()</doc>
          <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarService</doc>
            <type name="CalendarService" c:type="GDataCalendarService*"/>
          </instance-parameter>
          <parameter name="calendar" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataCalendarCalendar to insert the event into</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </parameter>
          <parameter name="event" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataCalendarEvent to insert</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_calendar_event_async"
              c:identifier="gdata_calendar_service_insert_calendar_event_async"
              version="0.17.2">
        <doc xml:space="preserve">Inserts @event by uploading it to the online calendar service, adding it to
the specified @calendar. @self and @event are both reffed when this function
is called, so can safely be unreffed after this function returns.

@callback should call gdata_service_insert_entry_finish() to obtain a
#GDataCalendarEvent representing the inserted event and to check for possible
errors.

For more details, see gdata_calendar_service_insert_event(), which is the
synchronous version of this function, and gdata_service_insert_entry_async(),
which is the base asynchronous insertion function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarService</doc>
            <type name="CalendarService" c:type="GDataCalendarService*"/>
          </instance-parameter>
          <parameter name="calendar" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataCalendarCalendar to insert the event into</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </parameter>
          <parameter name="event" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataCalendarEvent to insert</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="4">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when insertion is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_event"
              c:identifier="gdata_calendar_service_insert_event"
              version="0.2.0"
              deprecated="1"
              deprecated-version="0.17.2"
              throws="1">
        <doc xml:space="preserve">Inserts @event by uploading it to the online calendar service.

For more details, see gdata_service_insert_entry().</doc>
        <doc-deprecated xml:space="preserve">Use gdata_calendar_service_insert_calendar_event()
  instead to be able to specify the calendar to add the event to; otherwise
  the default calendar will be used.</doc-deprecated>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataCalendarEvent, or %NULL; unref with g_object_unref()</doc>
          <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarService</doc>
            <type name="CalendarService" c:type="GDataCalendarService*"/>
          </instance-parameter>
          <parameter name="event" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataCalendarEvent to insert</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_event_async"
              c:identifier="gdata_calendar_service_insert_event_async"
              version="0.8.0"
              deprecated="1"
              deprecated-version="0.17.2">
        <doc xml:space="preserve">Inserts @event by uploading it to the online calendar service. @self and @event are both reffed when this function is called, so can safely be
unreffed after this function returns.

@callback should call gdata_service_insert_entry_finish() to obtain a #GDataCalendarEvent representing the inserted event and to check for possible
errors.

For more details, see gdata_calendar_service_insert_event(), which is the synchronous version of this function, and
gdata_service_insert_entry_async(), which is the base asynchronous insertion function.</doc>
        <doc-deprecated xml:space="preserve">Use
  gdata_calendar_service_insert_calendar_event_async() instead to be able to
  specify the calendar to add the event to; otherwise the default calendar
  will be used.</doc-deprecated>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarService</doc>
            <type name="CalendarService" c:type="GDataCalendarService*"/>
          </instance-parameter>
          <parameter name="event" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataCalendarEvent to insert</doc>
            <type name="CalendarEvent" c:type="GDataCalendarEvent*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when insertion is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_all_calendars"
              c:identifier="gdata_calendar_service_query_all_calendars"
              throws="1">
        <doc xml:space="preserve">Queries the service to return a list of all calendars from the authenticated account which match the given
@query. It will return all calendars the user has read access to, including primary, secondary and imported
calendars.

For more details, see gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarService</doc>
            <type name="CalendarService" c:type="GDataCalendarService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_all_calendars_async"
              c:identifier="gdata_calendar_service_query_all_calendars_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the service to return a list of all calendars from the authenticated account which match the given
@query. @self and @query are all reffed when this function is called, so can safely be unreffed after
this function returns.

For more details, see gdata_calendar_service_query_all_calendars(), which is the synchronous version of
this function, and gdata_service_query_async(), which is the base asynchronous query function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarService</doc>
            <type name="CalendarService" c:type="GDataCalendarService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="3"
                     destroy="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="6">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authentication is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_events"
              c:identifier="gdata_calendar_service_query_events"
              throws="1">
        <doc xml:space="preserve">Queries the service to return a list of events in the given @calendar, which match @query.

For more details, see gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarService</doc>
            <type name="CalendarService" c:type="GDataCalendarService*"/>
          </instance-parameter>
          <parameter name="calendar" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_events_async"
              c:identifier="gdata_calendar_service_query_events_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the service to return a list of events in the given @calendar, which match @query. @self, @calendar and @query are all reffed when this
function is called, so can safely be unreffed after this function returns.

Get the results of the query using gdata_service_query_finish() in the @callback.

For more details, see gdata_calendar_service_query_events(), which is the synchronous version of this function, and gdata_service_query_async(),
which is the base asynchronous query function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarService</doc>
            <type name="CalendarService" c:type="GDataCalendarService*"/>
          </instance-parameter>
          <parameter name="calendar" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarCalendar</doc>
            <type name="CalendarCalendar" c:type="GDataCalendarCalendar*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="4"
                     destroy="5">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="7">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the query is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_own_calendars"
              c:identifier="gdata_calendar_service_query_own_calendars"
              throws="1">
        <doc xml:space="preserve">Queries the service to return a list of calendars from the authenticated account which match the given
@query, and the authenticated user owns. (i.e. They have full read/write access to the calendar, as well
as the ability to set permissions on the calendar.)

For more details, see gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarService</doc>
            <type name="CalendarService" c:type="GDataCalendarService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_own_calendars_async"
              c:identifier="gdata_calendar_service_query_own_calendars_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the service to return a list of calendars from the authenticated account which match the given
@query, and the authenticated user owns. @self and @query are all reffed when this function is called,
so can safely be unreffed after this function returns.

For more details, see gdata_calendar_service_query_own_calendars(), which is the synchronous version of
this function, and gdata_service_query_async(), which is the base asynchronous query function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCalendarService</doc>
            <type name="CalendarService" c:type="GDataCalendarService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="3"
                     destroy="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="6">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authentication is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <field name="parent">
        <type name="Service" c:type="GDataService"/>
      </field>
    </class>
    <record name="CalendarServiceClass"
            c:type="GDataCalendarServiceClass"
            glib:is-gtype-struct-for="CalendarService">
      <doc xml:space="preserve">All the fields in the #GDataCalendarServiceClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ServiceClass" c:type="GDataServiceClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="CalendarServicePrivate"
            c:type="GDataCalendarServicePrivate"
            disguised="1">
    </record>
    <class name="Category"
           c:symbol-prefix="category"
           c:type="GDataCategory"
           parent="Parsable"
           glib:type-name="GDataCategory"
           glib:get-type="gdata_category_get_type"
           glib:type-struct="CategoryClass">
      <doc xml:space="preserve">All the fields in the #GDataCategory structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new" c:identifier="gdata_category_new">
        <doc xml:space="preserve">Creates a new #GDataCategory. More information is available in the &lt;ulink type="http"
url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.category"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataCategory, or %NULL; unref with g_object_unref()</doc>
          <type name="Category" c:type="GDataCategory*"/>
        </return-value>
        <parameters>
          <parameter name="term" transfer-ownership="none">
            <doc xml:space="preserve">a category identifier</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="scheme"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">an IRI to define the categorisation scheme, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a human-readable label for the category, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_label"
              c:identifier="gdata_category_get_label"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataCategory:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the category's label, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCategory</doc>
            <type name="Category" c:type="GDataCategory*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_scheme"
              c:identifier="gdata_category_get_scheme"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataCategory:scheme property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the category's scheme, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCategory</doc>
            <type name="Category" c:type="GDataCategory*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_term"
              c:identifier="gdata_category_get_term"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataCategory:term property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the category's term</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCategory</doc>
            <type name="Category" c:type="GDataCategory*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_category_set_label"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataCategory:label property to @label.

Set @label to %NULL to unset the property in the category.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCategory</doc>
            <type name="Category" c:type="GDataCategory*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new label for the category, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_scheme"
              c:identifier="gdata_category_set_scheme"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataCategory:scheme property to @scheme.

Set @scheme to %NULL to unset the property in the category.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCategory</doc>
            <type name="Category" c:type="GDataCategory*"/>
          </instance-parameter>
          <parameter name="scheme"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new scheme for the category, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_term"
              c:identifier="gdata_category_set_term"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataCategory:term property to @term.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCategory</doc>
            <type name="Category" c:type="GDataCategory*"/>
          </instance-parameter>
          <parameter name="term" transfer-ownership="none">
            <doc xml:space="preserve">the new term for the category</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="label"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A human-readable label for display in end-user applications.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.category"&gt;
Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="scheme"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An IRI that identifies a categorization scheme.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.category"&gt;
Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="term"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Identifies the category to which the entry or feed belongs.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.category"&gt;
Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="CategoryPrivate" c:type="GDataCategoryPrivate*"/>
      </field>
    </class>
    <record name="CategoryClass"
            c:type="GDataCategoryClass"
            glib:is-gtype-struct-for="Category"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataCategoryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="CategoryPrivate" c:type="GDataCategoryPrivate" disguised="1">
    </record>
    <class name="ClientLoginAuthorizer"
           c:symbol-prefix="client_login_authorizer"
           c:type="GDataClientLoginAuthorizer"
           version="0.9.0"
           parent="GObject.Object"
           glib:type-name="GDataClientLoginAuthorizer"
           glib:get-type="gdata_client_login_authorizer_get_type"
           glib:type-struct="ClientLoginAuthorizerClass">
      <doc xml:space="preserve">All the fields in the #GDataClientLoginAuthorizer structure are private and should never be accessed directly.</doc>
      <implements name="Authorizer"/>
      <constructor name="new"
                   c:identifier="gdata_client_login_authorizer_new"
                   version="0.9.0">
        <doc xml:space="preserve">Creates a new #GDataClientLoginAuthorizer. The @client_id must be unique for your application, and as registered with Google.

The #GDataAuthorizationDomain&lt;!-- --&gt;s for the given @service_type (i.e. as returned by gdata_service_get_authorization_domains()) are the ones the
user will be logged in to using the provided username and password when gdata_client_login_authorizer_authenticate() is called. Note that the same
username and password will be used for all domains.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataClientLoginAuthorizer, or %NULL; unref with g_object_unref()</doc>
          <type name="ClientLoginAuthorizer"
                c:type="GDataClientLoginAuthorizer*"/>
        </return-value>
        <parameters>
          <parameter name="client_id" transfer-ownership="none">
            <doc xml:space="preserve">your application's client ID</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="service_type" transfer-ownership="none">
            <doc xml:space="preserve">the #GType of a #GDataService subclass which the #GDataClientLoginAuthorizer will be used with</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
        </parameters>
      </constructor>
      <constructor name="new_for_authorization_domains"
                   c:identifier="gdata_client_login_authorizer_new_for_authorization_domains"
                   version="0.9.0">
        <doc xml:space="preserve">Creates a new #GDataClientLoginAuthorizer. The @client_id must be unique for your application, and as registered with Google. This function is
intended to be used only when the default authorization domain list for a single #GDataService, as used by gdata_client_login_authorizer_new(),
isn't suitable. For example, this could be because the #GDataClientLoginAuthorizer will be used with multiple #GDataService subclasses, or because
the client requires a specific set of authorization domains.

The specified #GDataAuthorizationDomain&lt;!-- --&gt;s are the ones the user will be logged in to using the provided username and password when
gdata_client_login_authorizer_authenticate() is called. Note that the same username and password will be used for all domains.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataClientLoginAuthorizer, or %NULL; unref with g_object_unref()</doc>
          <type name="ClientLoginAuthorizer"
                c:type="GDataClientLoginAuthorizer*"/>
        </return-value>
        <parameters>
          <parameter name="client_id" transfer-ownership="none">
            <doc xml:space="preserve">your application's client ID</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="authorization_domains" transfer-ownership="none">
            <doc xml:space="preserve">a non-empty list of #GDataAuthorizationDomain&lt;!-- --&gt;s to be
authorized against by the #GDataClientLoginAuthorizer</doc>
            <type name="GLib.List" c:type="GList*">
              <type name="AuthorizationDomain"/>
            </type>
          </parameter>
        </parameters>
      </constructor>
      <method name="authenticate"
              c:identifier="gdata_client_login_authorizer_authenticate"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Authenticates the #GDataClientLoginAuthorizer with the Google Accounts service using @username and @password and authorizes it against all the
service types passed to gdata_client_login_authorizer_new(); i.e. logs into the service with the given user account. @username should be a full
e-mail address (e.g. &lt;literal&gt;john.smith\@gmail.com&lt;/literal&gt;). If a full e-mail address is not given, @username will have
&lt;literal&gt;\@gmail.com&lt;/literal&gt; appended to create an e-mail address

If @cancellable is not %NULL, then the operation can be cancelled by triggering the @cancellable object from another thread.
If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.

If the operation errors or is cancelled part-way through, gdata_authorizer_is_authorized_for_domain() is guaranteed to return %FALSE
for all #GDataAuthorizationDomain&lt;!-- --&gt;s, even if authentication has succeeded for some of them already.

A %GDATA_CLIENT_LOGIN_AUTHORIZER_ERROR_BAD_AUTHENTICATION will be returned if authentication failed due to an incorrect username or password.
Other #GDataClientLoginAuthorizerError errors can be returned for other conditions.

If the service requires a CAPTCHA to be completed, the #GDataClientLoginAuthorizer::captcha-challenge signal will be emitted.
The return value from a signal handler for the signal should be a newly allocated string containing the text from the image. If the text is %NULL
or empty, authentication will fail with a %GDATA_CLIENT_LOGIN_AUTHORIZER_ERROR_CAPTCHA_REQUIRED error. Otherwise, authentication will be
automatically and transparently restarted with the new CAPTCHA details.

A %GDATA_SERVICE_ERROR_PROTOCOL_ERROR will be returned if the server's responses were invalid.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if authentication and authorization was successful against all the services, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataClientLoginAuthorizer</doc>
            <type name="ClientLoginAuthorizer"
                  c:type="GDataClientLoginAuthorizer*"/>
          </instance-parameter>
          <parameter name="username" transfer-ownership="none">
            <doc xml:space="preserve">the user's username</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="password" transfer-ownership="none">
            <doc xml:space="preserve">the user's password</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="authenticate_async"
              c:identifier="gdata_client_login_authorizer_authenticate_async"
              version="0.9.0">
        <doc xml:space="preserve">Authenticates the #GDataClientLoginAuthorizer with the Google accounts service using the given @username and @password. @self, @username and
@password are all reffed/copied when this function is called, so can safely be freed after this function returns.

For more details, see gdata_client_login_authorizer_authenticate(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_client_login_authorizer_authenticate_finish()
to get the results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataClientLoginAuthorizer</doc>
            <type name="ClientLoginAuthorizer"
                  c:type="GDataClientLoginAuthorizer*"/>
          </instance-parameter>
          <parameter name="username" transfer-ownership="none">
            <doc xml:space="preserve">the user's username</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="password" transfer-ownership="none">
            <doc xml:space="preserve">the user's password</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="4">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authentication is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="authenticate_finish"
              c:identifier="gdata_client_login_authorizer_authenticate_finish"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous authentication operation started with gdata_client_login_authorizer_authenticate_async().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if authentication was successful, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataClientLoginAuthorizer</doc>
            <type name="ClientLoginAuthorizer"
                  c:type="GDataClientLoginAuthorizer*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_client_id"
              c:identifier="gdata_client_login_authorizer_get_client_id"
              version="0.9.0">
        <doc xml:space="preserve">Returns the authorizer's client ID, as specified on constructing the #GDataClientLoginAuthorizer.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the authorizer's client ID</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataClientLoginAuthorizer</doc>
            <type name="ClientLoginAuthorizer"
                  c:type="GDataClientLoginAuthorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_password"
              c:identifier="gdata_client_login_authorizer_get_password"
              version="0.9.0">
        <doc xml:space="preserve">Returns the password of the currently authenticated user, or %NULL if nobody is authenticated.

It is not safe to call this while an authentication operation is ongoing.

If libgdata is compiled with libgcr support, the password will be stored in non-pageable memory. Since this function doesn't return
a copy of the password, the returned value is guaranteed to not hit disk. It's advised that any copies of the password made in client programs
also use non-pageable memory.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the password of the currently authenticated user, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataClientLoginAuthorizer</doc>
            <type name="ClientLoginAuthorizer"
                  c:type="GDataClientLoginAuthorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_proxy_resolver"
              c:identifier="gdata_client_login_authorizer_get_proxy_resolver"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GProxyResolver on the #GDataClientLoginAuthorizer's #SoupSession.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GProxyResolver, or %NULL</doc>
          <type name="Gio.ProxyResolver" c:type="GProxyResolver*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataClientLoginAuthorizer</doc>
            <type name="ClientLoginAuthorizer"
                  c:type="GDataClientLoginAuthorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_proxy_uri"
              c:identifier="gdata_client_login_authorizer_get_proxy_uri"
              version="0.9.0"
              deprecated="1"
              deprecated-version="0.15.0">
        <doc xml:space="preserve">Gets the proxy URI on the #GDataClientLoginAuthorizer's #SoupSession.</doc>
        <doc-deprecated xml:space="preserve">Use gdata_client_login_authorizer_get_proxy_resolver() instead, which gives more flexibility over the proxy used.</doc-deprecated>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the proxy URI, or %NULL; free with soup_uri_free()</doc>
          <type name="Soup.URI" c:type="SoupURI*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataClientLoginAuthorizer</doc>
            <type name="ClientLoginAuthorizer"
                  c:type="GDataClientLoginAuthorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_timeout"
              c:identifier="gdata_client_login_authorizer_get_timeout"
              version="0.9.0">
        <doc xml:space="preserve">Gets the #GDataClientLoginAuthorizer:timeout property; the network timeout, in seconds.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the timeout, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataClientLoginAuthorizer</doc>
            <type name="ClientLoginAuthorizer"
                  c:type="GDataClientLoginAuthorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_username"
              c:identifier="gdata_client_login_authorizer_get_username"
              version="0.9.0">
        <doc xml:space="preserve">Returns the username of the currently authenticated user, or %NULL if nobody is authenticated.

It is not safe to call this while an authentication operation is ongoing.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the username of the currently authenticated user, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataClientLoginAuthorizer</doc>
            <type name="ClientLoginAuthorizer"
                  c:type="GDataClientLoginAuthorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_proxy_resolver"
              c:identifier="gdata_client_login_authorizer_set_proxy_resolver"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GProxyResolver on the #SoupSession used internally by the given #GDataClientLoginAuthorizer.

Setting this will clear the #GDataClientLoginAuthorizer:proxy-uri property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataClientLoginAuthorizer</doc>
            <type name="ClientLoginAuthorizer"
                  c:type="GDataClientLoginAuthorizer*"/>
          </instance-parameter>
          <parameter name="proxy_resolver"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GProxyResolver, or %NULL</doc>
            <type name="Gio.ProxyResolver" c:type="GProxyResolver*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_proxy_uri"
              c:identifier="gdata_client_login_authorizer_set_proxy_uri"
              version="0.9.0"
              deprecated="1"
              deprecated-version="0.15.0">
        <doc xml:space="preserve">Sets the proxy URI on the #SoupSession used internally by the #GDataClientLoginAuthorizer. This forces all requests through the given proxy.

If @proxy_uri is %NULL, no proxy will be used.</doc>
        <doc-deprecated xml:space="preserve">Use gdata_client_login_authorizer_set_proxy_resolver() instead, which gives more flexibility over the proxy used.</doc-deprecated>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataClientLoginAuthorizer</doc>
            <type name="ClientLoginAuthorizer"
                  c:type="GDataClientLoginAuthorizer*"/>
          </instance-parameter>
          <parameter name="proxy_uri"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the proxy URI, or %NULL</doc>
            <type name="Soup.URI" c:type="SoupURI*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_timeout"
              c:identifier="gdata_client_login_authorizer_set_timeout"
              version="0.9.0">
        <doc xml:space="preserve">Sets the #GDataClientLoginAuthorizer:timeout property; the network timeout, in seconds.

If @timeout is &lt;code class="literal"&gt;0&lt;/code&gt;, network operations will never time out.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataClientLoginAuthorizer</doc>
            <type name="ClientLoginAuthorizer"
                  c:type="GDataClientLoginAuthorizer*"/>
          </instance-parameter>
          <parameter name="timeout" transfer-ownership="none">
            <doc xml:space="preserve">the timeout, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <property name="client-id"
                version="0.9.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A client ID for your application (see the
&lt;ulink url="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html#Request" type="http"&gt;reference documentation&lt;/ulink&gt;).

It is recommended that the ID is of the form &lt;literal&gt;&lt;replaceable&gt;company name&lt;/replaceable&gt;-&lt;replaceable&gt;application name&lt;/replaceable&gt;-
&lt;replaceable&gt;version ID&lt;/replaceable&gt;&lt;/literal&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="password" version="0.9.0" transfer-ownership="none">
        <doc xml:space="preserve">The user's account password for authentication.

This will only be set after authentication using gdata_client_login_authorizer_authenticate() is completed successfully. It will
then be set to the password passed to gdata_client_login_authorizer_authenticate(), and a #GObject::notify signal will be emitted. If
authentication fails, it will be set to %NULL.

If libgdata is compiled with libgcr support, the password will be stored in non-pageable memory. However, if it is retrieved
using g_object_get() (or related functions) it will be copied to non-pageable memory and could end up being written to disk. Accessing
the password using gdata_client_login_authorizer_get_password() will not perform any copies, and so maintains privacy.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="proxy-resolver"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The #GProxyResolver used to determine a proxy URI.  Setting this will clear the #GDataClientLoginAuthorizer:proxy-uri property.</doc>
        <type name="Gio.ProxyResolver"/>
      </property>
      <property name="proxy-uri"
                version="0.9.0"
                deprecated="1"
                deprecated-version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The proxy URI used internally for all network requests.</doc>
        <doc-deprecated xml:space="preserve">Use #GDataClientLoginAuthorizer:proxy-resolver instead, which gives more flexibility over the proxy used.</doc-deprecated>
        <type name="Soup.URI"/>
      </property>
      <property name="timeout"
                version="0.9.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A timeout, in seconds, for network operations. If the timeout is exceeded, the operation will be cancelled and
%GDATA_SERVICE_ERROR_NETWORK_ERROR will be returned.

If the timeout is &lt;code class="literal"&gt;0&lt;/code&gt;, operations will never time out.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="username" version="0.9.0" transfer-ownership="none">
        <doc xml:space="preserve">The user's Google username for authentication. This will always be a full e-mail address.

This will only be set after authentication using gdata_client_login_authorizer_authenticate() is completed successfully. It will
then be set to the username passed to gdata_client_login_authorizer_authenticate(), and a #GObject::notify signal will be emitted. If
authentication fails, it will be set to %NULL.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent" readable="0" private="1">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="ClientLoginAuthorizerPrivate"
              c:type="GDataClientLoginAuthorizerPrivate*"/>
      </field>
      <glib:signal name="captcha-challenge" when="last" version="0.9.0">
        <doc xml:space="preserve">The #GDataClientLoginAuthorizer::captcha-challenge signal is emitted during the authentication process if the authorizer requires a CAPTCHA
to be completed. The URI of a CAPTCHA image is given, and the program should display this to the user, and return their response (the text
displayed in the image). There is no timeout imposed by the library for the response.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a newly allocated string containing the text in the CAPTCHA image</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <parameter name="uri" transfer-ownership="none">
            <doc xml:space="preserve">the URI of the CAPTCHA image to be used</doc>
            <type name="utf8" c:type="gchar*"/>
          </parameter>
        </parameters>
      </glib:signal>
    </class>
    <record name="ClientLoginAuthorizerClass"
            c:type="GDataClientLoginAuthorizerClass"
            glib:is-gtype-struct-for="ClientLoginAuthorizer"
            version="0.9.0">
      <doc xml:space="preserve">All the fields in the #GDataClientLoginAuthorizerClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <enumeration name="ClientLoginAuthorizerError"
                 version="0.9.0"
                 glib:type-name="GDataClientLoginAuthorizerError"
                 glib:get-type="gdata_client_login_authorizer_error_get_type"
                 c:type="GDataClientLoginAuthorizerError"
                 glib:error-domain="gdata-client-login-authorizer-error-quark">
      <doc xml:space="preserve">Error codes for authentication and authorization operations on #GDataClientLoginAuthorizer. See the
&lt;ulink type="http" url="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html#Errors"&gt;online ClientLogin documentation&lt;/ulink&gt; for
more information.</doc>
      <member name="bad_authentication"
              value="1"
              c:identifier="GDATA_CLIENT_LOGIN_AUTHORIZER_ERROR_BAD_AUTHENTICATION"
              glib:nick="bad-authentication">
        <doc xml:space="preserve">The login request used a username or password that is not recognized.</doc>
      </member>
      <member name="not_verified"
              value="2"
              c:identifier="GDATA_CLIENT_LOGIN_AUTHORIZER_ERROR_NOT_VERIFIED"
              glib:nick="not-verified">
        <doc xml:space="preserve">The account email address has not been verified. The user will need to access their Google
account directly to resolve the issue before logging in using a non-Google application.</doc>
      </member>
      <member name="terms_not_agreed"
              value="3"
              c:identifier="GDATA_CLIENT_LOGIN_AUTHORIZER_ERROR_TERMS_NOT_AGREED"
              glib:nick="terms-not-agreed">
        <doc xml:space="preserve">The user has not agreed to terms. The user will need to access their Google account directly
to resolve the issue before logging in using a non-Google application.</doc>
      </member>
      <member name="captcha_required"
              value="4"
              c:identifier="GDATA_CLIENT_LOGIN_AUTHORIZER_ERROR_CAPTCHA_REQUIRED"
              glib:nick="captcha-required">
        <doc xml:space="preserve">A CAPTCHA is required. (A response with this error code will also contain an image URI and a
CAPTCHA token.)</doc>
      </member>
      <member name="account_deleted"
              value="5"
              c:identifier="GDATA_CLIENT_LOGIN_AUTHORIZER_ERROR_ACCOUNT_DELETED"
              glib:nick="account-deleted">
        <doc xml:space="preserve">The user account has been deleted.</doc>
      </member>
      <member name="account_disabled"
              value="6"
              c:identifier="GDATA_CLIENT_LOGIN_AUTHORIZER_ERROR_ACCOUNT_DISABLED"
              glib:nick="account-disabled">
        <doc xml:space="preserve">The user account has been disabled.</doc>
      </member>
      <member name="service_disabled"
              value="7"
              c:identifier="GDATA_CLIENT_LOGIN_AUTHORIZER_ERROR_SERVICE_DISABLED"
              glib:nick="service-disabled">
        <doc xml:space="preserve">The user's access to the specified service has been disabled. (The user account may still be
valid.)</doc>
      </member>
      <member name="account_migrated"
              value="8"
              c:identifier="GDATA_CLIENT_LOGIN_AUTHORIZER_ERROR_ACCOUNT_MIGRATED"
              glib:nick="account-migrated">
        <doc xml:space="preserve">The user's account login details have been migrated to a new system. (This is used for the
transition from the old YouTube login details to the new ones.)</doc>
      </member>
      <member name="invalid_second_factor"
              value="9"
              c:identifier="GDATA_CLIENT_LOGIN_AUTHORIZER_ERROR_INVALID_SECOND_FACTOR"
              glib:nick="invalid-second-factor">
        <doc xml:space="preserve">The user's account requires an application-specific password to be used.</doc>
      </member>
      <function name="quark"
                c:identifier="gdata_client_login_authorizer_error_quark">
        <return-value transfer-ownership="none">
          <type name="GLib.Quark" c:type="GQuark"/>
        </return-value>
      </function>
    </enumeration>
    <record name="ClientLoginAuthorizerPrivate"
            c:type="GDataClientLoginAuthorizerPrivate"
            disguised="1">
    </record>
    <record name="Color"
            c:type="GDataColor"
            glib:type-name="GDataColor"
            glib:get-type="gdata_color_get_type"
            c:symbol-prefix="color">
      <doc xml:space="preserve">Describes a color, such as used in the Google Calendar interface to
differentiate calendars.</doc>
      <field name="red" writable="1">
        <doc xml:space="preserve">red color intensity, from 0–255</doc>
        <type name="guint16" c:type="guint16"/>
      </field>
      <field name="green" writable="1">
        <doc xml:space="preserve">green color intensity, from 0–255</doc>
        <type name="guint16" c:type="guint16"/>
      </field>
      <field name="blue" writable="1">
        <doc xml:space="preserve">blue color intensity, from 0–255</doc>
        <type name="guint16" c:type="guint16"/>
      </field>
      <method name="to_hexadecimal"
              c:identifier="gdata_color_to_hexadecimal"
              version="0.3.0">
        <doc xml:space="preserve">Returns a string describing @color in hexadecimal form; in the form &lt;literal&gt;#&lt;replaceable&gt;rr&lt;/replaceable&gt;&lt;replaceable&gt;gg&lt;/replaceable&gt;
&lt;replaceable&gt;bb&lt;/replaceable&gt;&lt;/literal&gt;, where &lt;replaceable&gt;rr&lt;/replaceable&gt; is a two-digit hexadecimal red intensity value,
&lt;replaceable&gt;gg&lt;/replaceable&gt; is green and &lt;replaceable&gt;bb&lt;/replaceable&gt; is blue. The hash is always present.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the color string; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="color" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataColor</doc>
            <type name="Color" c:type="const GDataColor*"/>
          </instance-parameter>
        </parameters>
      </method>
      <function name="from_hexadecimal"
                c:identifier="gdata_color_from_hexadecimal">
        <doc xml:space="preserve">Parses @hexadecimal and returns a #GDataColor describing it in @color.

@hexadecimal should be in the form &lt;literal&gt;#&lt;replaceable&gt;rr&lt;/replaceable&gt;&lt;replaceable&gt;gg&lt;/replaceable&gt;&lt;replaceable&gt;bb&lt;/replaceable&gt;&lt;/literal&gt;,
where &lt;replaceable&gt;rr&lt;/replaceable&gt; is a two-digit hexadecimal red intensity value, &lt;replaceable&gt;gg&lt;/replaceable&gt; is green
and &lt;replaceable&gt;bb&lt;/replaceable&gt; is blue. The hash is optional.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <parameter name="hexadecimal" transfer-ownership="none">
            <doc xml:space="preserve">a hexadecimal color string</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="color"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:space="preserve">a #GDataColor</doc>
            <type name="Color" c:type="GDataColor*"/>
          </parameter>
        </parameters>
      </function>
    </record>
    <class name="Comment"
           c:symbol-prefix="comment"
           c:type="GDataComment"
           version="0.10.0"
           parent="Entry"
           abstract="1"
           glib:type-name="GDataComment"
           glib:get-type="gdata_comment_get_type"
           glib:type-struct="CommentClass">
      <doc xml:space="preserve">All the fields in the #GDataComment structure are private and should never be accessed directly.</doc>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="CommentPrivate" c:type="GDataCommentPrivate*"/>
      </field>
    </class>
    <record name="CommentClass"
            c:type="GDataCommentClass"
            glib:is-gtype-struct-for="Comment"
            version="0.10.0">
      <doc xml:space="preserve">All the fields in the #GDataCommentClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="CommentPrivate" c:type="GDataCommentPrivate" disguised="1">
    </record>
    <interface name="Commentable"
               c:symbol-prefix="commentable"
               c:type="GDataCommentable"
               version="0.10.0"
               glib:type-name="GDataCommentable"
               glib:get-type="gdata_commentable_get_type"
               glib:type-struct="CommentableInterface">
      <doc xml:space="preserve">All the fields in the #GDataCommentable structure are private and should never be accessed directly</doc>
      <prerequisite name="Entry"/>
      <virtual-method name="get_authorization_domain" introspectable="0">
        <return-value>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="get_insert_comment_uri">
        <return-value transfer-ownership="full">
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
          <parameter name="comment" transfer-ownership="none">
            <type name="Comment" c:type="GDataComment*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="get_query_comments_uri">
        <return-value transfer-ownership="full">
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="is_comment_deletable">
        <return-value transfer-ownership="none">
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
          <parameter name="comment" transfer-ownership="none">
            <type name="Comment" c:type="GDataComment*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <method name="delete_comment"
              c:identifier="gdata_commentable_delete_comment"
              version="0.10.0"
              throws="1">
        <doc xml:space="preserve">Deletes @comment from the #GDataCommentable.

If the given @comment isn't deletable (either because the service doesn't support deleting comments at all, or because this particular comment
is not deletable due to having insufficient permissions), %GDATA_SERVICE_ERROR_FORBIDDEN will be set in @error and %FALSE will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the comment was successfully deleted, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCommentable</doc>
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService with which the comment will be deleted</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="comment_" transfer-ownership="none">
            <doc xml:space="preserve">a comment to be deleted</doc>
            <type name="Comment" c:type="GDataComment*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="delete_comment_async"
              c:identifier="gdata_commentable_delete_comment_async"
              version="0.10.0">
        <doc xml:space="preserve">Deletes @comment from the #GDataCommentable. @self, @service and @comment_ are all reffed when this method is called, so can safely be freed after
this method returns.

For more details, see gdata_commentable_delete_comment(), which is the synchronous version of this method.

When the operation is finished, @callback will be called. You can then call gdata_commentable_delete_comment_finish() to get the results of the
operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCommentable</doc>
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService with which the comment will be deleted</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="comment_" transfer-ownership="none">
            <doc xml:space="preserve">a comment to be deleted</doc>
            <type name="Comment" c:type="GDataComment*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="4">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the operation is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="delete_comment_finish"
              c:identifier="gdata_commentable_delete_comment_finish"
              version="0.10.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous comment deletion operation started with gdata_commentable_delete_comment_async().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the comment was successfully deleted, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCommentable</doc>
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
          <parameter name="result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_comment"
              c:identifier="gdata_commentable_insert_comment"
              version="0.10.0"
              throws="1">
        <doc xml:space="preserve">Adds @comment to the #GDataCommentable.

If the #GDataCommentable doesn't support commenting, %NULL will be returned and @error will be set to %GDATA_SERVICE_ERROR_FORBIDDEN.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the added #GDataComment, or %NULL; unref with g_object_unref()</doc>
          <type name="Comment" c:type="GDataComment*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCommentable</doc>
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService with which the comment will be added</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="comment_" transfer-ownership="none">
            <doc xml:space="preserve">a new comment to be added to the #GDataCommentable</doc>
            <type name="Comment" c:type="GDataComment*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_comment_async"
              c:identifier="gdata_commentable_insert_comment_async"
              version="0.10.0">
        <doc xml:space="preserve">Adds @comment to the #GDataCommentable. @self, @service and @comment_ are all reffed when this method is called, so can safely be freed after this
method returns.

For more details, see gdata_commentable_insert_comment(), which is the synchronous version of this method.

When the operation is finished, @callback will be called. You can then call gdata_commentable_insert_comment_finish() to get the results of the
operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCommentable</doc>
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService with which the comment will be added</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="comment_" transfer-ownership="none">
            <doc xml:space="preserve">a new comment to be added to the #GDataCommentable</doc>
            <type name="Comment" c:type="GDataComment*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="4">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the operation is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_comment_finish"
              c:identifier="gdata_commentable_insert_comment_finish"
              version="0.10.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous comment insertion operation started with gdata_commentable_insert_comment_async().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the added #GDataComment, or %NULL; unref with g_object_unref()</doc>
          <type name="Comment" c:type="GDataComment*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCommentable</doc>
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
          <parameter name="result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_comments"
              c:identifier="gdata_commentable_query_comments"
              version="0.10.0"
              throws="1">
        <doc xml:space="preserve">Retrieves a #GDataFeed containing the #GDataComment&lt;!-- --&gt;s representing the comments on the #GDataCommentable which match the given @query.

If the #GDataCommentable doesn't support commenting, %NULL will be returned and @error will be set to %GDATA_SERVICE_ERROR_FORBIDDEN. This is in
contrast to if it does support commenting but hasn't had any comments added yet, in which case an empty #GDataFeed will be returned and no error
will be set.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of #GDataComment&lt;!-- --&gt;s, or %NULL; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCommentable</doc>
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService representing the service with which the object's comments will be manipulated</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when a comment is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_comments_async"
              c:identifier="gdata_commentable_query_comments_async"
              version="0.10.0">
        <doc xml:space="preserve">Retrieves a #GDataFeed containing the #GDataComment&lt;!-- --&gt;s representing the comments on the #GDataCommentable which match the given @query.
@self, @service and @query are all reffed when this method is called, so can safely be freed after this method returns.

For more details, see gdata_commentable_query_comments(), which is the synchronous version of this method.

When the operation is finished, @callback will be called. You can then call gdata_commentable_query_comments_finish() to get the results of the
operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCommentable</doc>
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService representing the service with which the object's comments will be manipulated</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="4"
                     destroy="5">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when a comment is loaded,
or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">a function to call when @progress_callback will not be called any more, or %NULL; this function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="7">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the query is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_comments_finish"
              c:identifier="gdata_commentable_query_comments_finish"
              version="0.10.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous comment query operation started with gdata_commentable_query_comments_async().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of #GDataComment&lt;!-- --&gt;s, or %NULL; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCommentable</doc>
            <type name="Commentable" c:type="GDataCommentable*"/>
          </instance-parameter>
          <parameter name="result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
    </interface>
    <record name="CommentableInterface"
            c:type="GDataCommentableInterface"
            glib:is-gtype-struct-for="Commentable"
            version="0.10.0">
      <doc xml:space="preserve">The interface structure for the #GDataCommentable interface.</doc>
      <field name="parent">
        <doc xml:space="preserve">the parent type</doc>
        <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
      </field>
      <field name="comment_type">
        <doc xml:space="preserve">the #GType of the comment class (subclass of #GDataComment) to use for query results from this commentable object</doc>
        <type name="GType" c:type="GType"/>
      </field>
      <field name="get_authorization_domain" introspectable="0">
        <callback name="get_authorization_domain" introspectable="0">
          <return-value>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <type name="Commentable" c:type="GDataCommentable*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="get_query_comments_uri">
        <callback name="get_query_comments_uri">
          <return-value transfer-ownership="full">
            <type name="utf8" c:type="gchar*"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <type name="Commentable" c:type="GDataCommentable*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="get_insert_comment_uri">
        <callback name="get_insert_comment_uri">
          <return-value transfer-ownership="full">
            <type name="utf8" c:type="gchar*"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <type name="Commentable" c:type="GDataCommentable*"/>
            </parameter>
            <parameter name="comment" transfer-ownership="none">
              <type name="Comment" c:type="GDataComment*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="is_comment_deletable">
        <callback name="is_comment_deletable">
          <return-value transfer-ownership="none">
            <type name="gboolean" c:type="gboolean"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <type name="Commentable" c:type="GDataCommentable*"/>
            </parameter>
            <parameter name="comment" transfer-ownership="none">
              <type name="Comment" c:type="GDataComment*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
    </record>
    <interface name="Comparable"
               c:symbol-prefix="comparable"
               c:type="GDataComparable"
               version="0.7.0"
               glib:type-name="GDataComparable"
               glib:get-type="gdata_comparable_get_type"
               glib:type-struct="ComparableIface">
      <doc xml:space="preserve">All the fields in the #GDataComparable structure are private and should never be accessed directly.</doc>
      <virtual-method name="compare_with">
        <return-value transfer-ownership="none">
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <type name="Comparable" c:type="GDataComparable*"/>
          </instance-parameter>
          <parameter name="other" transfer-ownership="none">
            <type name="Comparable" c:type="GDataComparable*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <method name="compare"
              c:identifier="gdata_comparable_compare"
              version="0.7.0">
        <doc xml:space="preserve">Compares the two objects, returning &lt;code class="literal"&gt;-1&lt;/code&gt; if @self is "less than" @other by some metric, &lt;code class="literal"&gt;0&lt;/code&gt;
if they're equal, or &lt;code class="literal"&gt;1&lt;/code&gt; if @self is "greater than" @other.

%NULL values are handled gracefully, with &lt;code class="literal"&gt;0&lt;/code&gt; returned if both @self and @other are %NULL,
&lt;code class="literal"&gt;-1&lt;/code&gt; if @self is %NULL and &lt;code class="literal"&gt;1&lt;/code&gt; if @other is %NULL.

The @other object must be of the same type as @self, or of a type derived from @self's type.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success, %FALSE otherwise</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self"
                              transfer-ownership="none"
                              nullable="1"
                              allow-none="1">
            <doc xml:space="preserve">a #GDataComparable, or %NULL</doc>
            <type name="Comparable" c:type="GDataComparable*"/>
          </instance-parameter>
          <parameter name="other"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">another #GDataComparable of the same type, or %NULL</doc>
            <type name="Comparable" c:type="GDataComparable*"/>
          </parameter>
        </parameters>
      </method>
    </interface>
    <record name="ComparableIface"
            c:type="GDataComparableIface"
            glib:is-gtype-struct-for="Comparable"
            version="0.7.0">
      <doc xml:space="preserve">The class structure for the #GDataComparable interface.</doc>
      <field name="parent">
        <doc xml:space="preserve">the parent type</doc>
        <type name="GObject.TypeInterface" c:type="GTypeInterface"/>
      </field>
      <field name="compare_with">
        <callback name="compare_with">
          <return-value transfer-ownership="none">
            <type name="gint" c:type="gint"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <type name="Comparable" c:type="GDataComparable*"/>
            </parameter>
            <parameter name="other" transfer-ownership="none">
              <type name="Comparable" c:type="GDataComparable*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
    </record>
    <class name="ContactsContact"
           c:symbol-prefix="contacts_contact"
           c:type="GDataContactsContact"
           version="0.2.0"
           parent="Entry"
           glib:type-name="GDataContactsContact"
           glib:get-type="gdata_contacts_contact_get_type"
           glib:type-struct="ContactsContactClass">
      <doc xml:space="preserve">All the fields in the #GDataContactsContact structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_contacts_contact_new"
                   version="0.2.0">
        <doc xml:space="preserve">Creates a new #GDataContactsContact with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataContactsContact; unref with g_object_unref()</doc>
          <type name="ContactsContact" c:type="GDataContactsContact*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the contact's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="add_calendar"
              c:identifier="gdata_contacts_contact_add_calendar"
              version="0.7.0">
        <doc xml:space="preserve">Adds a calendar to the contact's list of calendars and increments its reference count.

Duplicate calendars will not be added to the list, though the same URI may appear in several #GDataGContactCalendar&lt;!-- --&gt;s with different
relation types or labels.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="calendar" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactCalendar to add</doc>
            <type name="GContactCalendar" c:type="GDataGContactCalendar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_email_address"
              c:identifier="gdata_contacts_contact_add_email_address"
              version="0.2.0">
        <doc xml:space="preserve">Adds an e-mail address to the contact's list of e-mail addresses and increments its reference count.

Note that only one e-mail address per contact may be marked as "primary". Insertion and update operations
(with gdata_contacts_service_insert_contact()) will return an error if more than one e-mail address
is marked as primary.

Duplicate e-mail addresses will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="email_address" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDEmailAddress to add</doc>
            <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_event"
              c:identifier="gdata_contacts_contact_add_event"
              version="0.7.0">
        <doc xml:space="preserve">Adds an event to the contact's list of events and increments its reference count.

Duplicate events will be added to the list, and multiple events with the same event type can be added to a single contact.
Though it may not make sense for some event types to be repeated, adding them is allowed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="event" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactEvent to add</doc>
            <type name="GContactEvent" c:type="GDataGContactEvent*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_external_id"
              c:identifier="gdata_contacts_contact_add_external_id"
              version="0.7.0">
        <doc xml:space="preserve">Adds an external ID to the contact's list of external IDs and increments its reference count.

Duplicate IDs will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="external_id" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactExternalID to add</doc>
            <type name="GContactExternalID" c:type="GDataGContactExternalID*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_group"
              c:identifier="gdata_contacts_contact_add_group"
              version="0.2.0">
        <doc xml:space="preserve">Adds the contact to the given group. @href should be a URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="href" transfer-ownership="none">
            <doc xml:space="preserve">the group's ID URI</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_hobby"
              c:identifier="gdata_contacts_contact_add_hobby"
              version="0.7.0">
        <doc xml:space="preserve">Adds a hobby to the contact's list of hobbies, copying it in the process.

Duplicate hobbies will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="hobby" transfer-ownership="none">
            <doc xml:space="preserve">a hobby to add</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_im_address"
              c:identifier="gdata_contacts_contact_add_im_address"
              version="0.2.0">
        <doc xml:space="preserve">Adds an IM (instant messaging) address to the contact's list of IM addresses and increments its reference count.

Note that only one IM address per contact may be marked as "primary". Insertion and update operations
(with gdata_contacts_service_insert_contact()) will return an error if more than one IM address
is marked as primary.

Duplicate IM addresses will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="im_address" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDIMAddress to add</doc>
            <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_jot"
              c:identifier="gdata_contacts_contact_add_jot"
              version="0.7.0">
        <doc xml:space="preserve">Adds a jot to the contact's list of jots and increments its reference count.

Duplicate jots will be added to the list, and multiple jots with the same relation type can be added to a single contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="jot" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactJot to add</doc>
            <type name="GContactJot" c:type="GDataGContactJot*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_language"
              c:identifier="gdata_contacts_contact_add_language"
              version="0.7.0">
        <doc xml:space="preserve">Adds a language to the contact's list of languages and increments its reference count.

Duplicate languages will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="language" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactLanguage to add</doc>
            <type name="GContactLanguage" c:type="GDataGContactLanguage*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_organization"
              c:identifier="gdata_contacts_contact_add_organization"
              version="0.2.0">
        <doc xml:space="preserve">Adds an organization to the contact's list of organizations (e.g. employers) and increments its reference count.

Note that only one organization per contact may be marked as "primary". Insertion and update operations
(with gdata_contacts_service_insert_contact()) will return an error if more than one organization
is marked as primary.

Duplicate organizations will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="organization" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization to add</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_phone_number"
              c:identifier="gdata_contacts_contact_add_phone_number"
              version="0.2.0">
        <doc xml:space="preserve">Adds a phone number to the contact's list of phone numbers and increments its reference count

Note that only one phone number per contact may be marked as "primary". Insertion and update operations
(with gdata_contacts_service_insert_contact()) will return an error if more than one phone number
is marked as primary.

Duplicate phone numbers will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="phone_number" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPhoneNumber to add</doc>
            <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_postal_address"
              c:identifier="gdata_contacts_contact_add_postal_address"
              version="0.2.0">
        <doc xml:space="preserve">Adds a postal address to the contact's list of postal addresses and increments its reference count.

Note that only one postal address per contact may be marked as "primary". Insertion and update operations
(with gdata_contacts_service_insert_contact()) will return an error if more than one postal address
is marked as primary.

Duplicate postal addresses will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="postal_address" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress to add</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_relation"
              c:identifier="gdata_contacts_contact_add_relation"
              version="0.7.0">
        <doc xml:space="preserve">Adds a relation to the contact's list of relations and increments its reference count.

Duplicate relations will be added to the list, and multiple relations with the same relation type can be added to a single contact.
Though it may not make sense for some relation types to be repeated, adding them is allowed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="relation" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactRelation to add</doc>
            <type name="GContactRelation" c:type="GDataGContactRelation*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_website"
              c:identifier="gdata_contacts_contact_add_website"
              version="0.7.0">
        <doc xml:space="preserve">Adds a website to the contact's list of websites and increments its reference count.

Duplicate websites will not be added to the list, though the same URI may appear in several #GDataGContactWebsite&lt;!-- --&gt;s with different
relation types or labels.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="website" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactWebsite to add</doc>
            <type name="GContactWebsite" c:type="GDataGContactWebsite*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_billing_information"
              c:identifier="gdata_contacts_contact_get_billing_information"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:billing-information property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the contact's billing information, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_birthday"
              c:identifier="gdata_contacts_contact_get_birthday"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:birthday and #GDataContactsContact:birthday-has-year properties. If @birthday is non-%NULL,
#GDataContactsContact:birthday is returned in it. The function returns the value of #GDataContactsContact:birthday-has-year,
which specifies whether the year in @birthday is meaningful. Contacts may not have the year of their birth set, in which
case, the function would return %FALSE, and the year in @birthday should be ignored.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">whether the contact's birthday has the year set</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="birthday"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the birthday, or %NULL</doc>
            <type name="GLib.Date" c:type="GDate*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_calendars"
              c:identifier="gdata_contacts_contact_get_calendars"
              version="0.7.0">
        <doc xml:space="preserve">Gets a list of the calendars of the contact.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGContactCalendar&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GContactCalendar"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_directory_server"
              c:identifier="gdata_contacts_contact_get_directory_server"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:directory-server property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the name or address of a directory server associated with the contact, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_edited"
              c:identifier="gdata_contacts_contact_get_edited"
              version="0.2.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:edited property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the time the contact was last edited, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_email_addresses"
              c:identifier="gdata_contacts_contact_get_email_addresses"
              version="0.2.0">
        <doc xml:space="preserve">Gets a list of the e-mail addresses owned by the contact.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGDEmailAddress&lt;!-- --&gt;es, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GDEmailAddress"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_events"
              c:identifier="gdata_contacts_contact_get_events"
              version="0.7.0">
        <doc xml:space="preserve">Gets a list of the events of the contact.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGContactEvent&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GContactEvent"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_extended_properties"
              c:identifier="gdata_contacts_contact_get_extended_properties"
              version="0.4.0">
        <doc xml:space="preserve">Gets the full list of extended properties of the contact; a hash table mapping property name to value.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GHashTable of extended properties</doc>
          <type name="GLib.HashTable" c:type="GHashTable*">
            <type name="gpointer" c:type="gpointer"/>
            <type name="gpointer" c:type="gpointer"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_extended_property"
              c:identifier="gdata_contacts_contact_get_extended_property"
              version="0.2.0">
        <doc xml:space="preserve">Gets the value of an extended property of the contact. Each contact can have up to 10 client-set extended
properties to store data of the client's choosing.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the property's value, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">the property name; an arbitrary, unique string</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_external_ids"
              c:identifier="gdata_contacts_contact_get_external_ids"
              version="0.7.0">
        <doc xml:space="preserve">Gets a list of the external IDs of the contact.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGContactExternalID&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GContactExternalID"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_file_as"
              c:identifier="gdata_contacts_contact_get_file_as"
              version="0.11.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:file-as property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the name the contact's filed under, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_gender"
              c:identifier="gdata_contacts_contact_get_gender"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:gender property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the gender of the contact, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_groups"
              c:identifier="gdata_contacts_contact_get_groups"
              version="0.2.0">
        <doc xml:space="preserve">Gets a list of the groups to which the contact belongs.</doc>
        <return-value transfer-ownership="container">
          <doc xml:space="preserve">a #GList of constant group ID URIs, or %NULL; free with g_list_free()</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="utf8"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_hobbies"
              c:identifier="gdata_contacts_contact_get_hobbies"
              version="0.7.0">
        <doc xml:space="preserve">Gets a list of the hobbies of the contact.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of hobby strings, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="utf8"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_im_addresses"
              c:identifier="gdata_contacts_contact_get_im_addresses"
              version="0.2.0">
        <doc xml:space="preserve">Gets a list of the IM addresses owned by the contact.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGDIMAddress&lt;!-- --&gt;es, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GDIMAddress"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_initials"
              c:identifier="gdata_contacts_contact_get_initials"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:initials property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the initials of the contact, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_jots"
              c:identifier="gdata_contacts_contact_get_jots"
              version="0.7.0">
        <doc xml:space="preserve">Gets a list of the jots attached to the contact.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGContactJot&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GContactJot"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_languages"
              c:identifier="gdata_contacts_contact_get_languages"
              version="0.7.0">
        <doc xml:space="preserve">Gets a list of the languages of the contact.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGContactLanguage&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GContactLanguage"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_maiden_name"
              c:identifier="gdata_contacts_contact_get_maiden_name"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:maiden-name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the maiden name of the contact, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_mileage"
              c:identifier="gdata_contacts_contact_get_mileage"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:mileage property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a mileage associated with the contact, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_name"
              c:identifier="gdata_contacts_contact_get_name"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the contact's name, or %NULL</doc>
          <type name="GDName" c:type="GDataGDName*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_nickname"
              c:identifier="gdata_contacts_contact_get_nickname"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:nickname property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the contact's nickname, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_occupation"
              c:identifier="gdata_contacts_contact_get_occupation"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:occupation property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the contact's occupation, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_organizations"
              c:identifier="gdata_contacts_contact_get_organizations"
              version="0.2.0">
        <doc xml:space="preserve">Gets a list of the organizations to which the contact belongs.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGDOrganization&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GDOrganization"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_phone_numbers"
              c:identifier="gdata_contacts_contact_get_phone_numbers"
              version="0.2.0">
        <doc xml:space="preserve">Gets a list of the phone numbers owned by the contact.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGDPhoneNumber&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GDPhoneNumber"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_photo"
              c:identifier="gdata_contacts_contact_get_photo"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Downloads and returns the contact's photo, if they have one. If the contact doesn't
have a photo (i.e. gdata_contacts_contact_get_photo_etag() returns %NULL), %NULL is returned, but
no error is set in @error.

If @cancellable is not %NULL, then the operation can be cancelled by triggering the @cancellable object from another thread.
If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.

If there is an error getting the photo, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the image data, or %NULL; free with g_free()</doc>
          <array length="1" zero-terminated="0" c:type="guint8*">
            <type name="guint8" c:type="guint8"/>
          </array>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsService</doc>
            <type name="ContactsService" c:type="GDataContactsService*"/>
          </parameter>
          <parameter name="length"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="full">
            <doc xml:space="preserve">return location for the image length, in bytes</doc>
            <type name="gsize" c:type="gsize*"/>
          </parameter>
          <parameter name="content_type"
                     direction="out"
                     caller-allocates="0"
                     transfer-ownership="full"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the image's content type, or %NULL; free with g_free()</doc>
            <type name="utf8" c:type="gchar**"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_photo_async"
              c:identifier="gdata_contacts_contact_get_photo_async"
              version="0.8.0">
        <doc xml:space="preserve">Downloads and returns the contact's photo, if they have one, asynchronously. @self and @service are both reffed when this function is called, so
can safely be unreffed after this function returns.

When the operation is finished, @callback will be called. You can then call gdata_contacts_contact_get_photo_finish() to get the results of the
operation.

For more details, see gdata_contacts_contact_get_photo(), which is the synchronous version of this function.

If @cancellable is not %NULL, then the operation can be cancelled by triggering the @cancellable object from another thread.
If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned by gdata_contacts_contact_get_photo_finish().

If there is an error getting the photo, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned by gdata_contacts_contact_get_photo_finish().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsService</doc>
            <type name="ContactsService" c:type="GDataContactsService*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the photo has been retrieved, or %NULL</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_photo_etag"
              c:identifier="gdata_contacts_contact_get_photo_etag"
              version="0.9.0">
        <doc xml:space="preserve">Returns the ETag for the contact's attached photo, if it exists. If it does exist, the contact's photo can be retrieved using
gdata_contacts_contact_get_photo(). If it doesn't exist, %NULL will be returned, and the contact doesn't have a photo (so calling
gdata_contacts_contact_get_photo() will also return %NULL)</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the contact's photo's ETag if it exists, %NULL otherwise</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_photo_finish"
              c:identifier="gdata_contacts_contact_get_photo_finish"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous contact photo retrieval operation started with gdata_contacts_contact_get_photo_async(). If the contact doesn't have a
photo (i.e. gdata_contacts_contact_get_photo_etag() returns %NULL), %NULL is returned, but no error is set in @error.

If there is an error getting the photo, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned. @length will be set to
&lt;code class="literal"&gt;0&lt;/code&gt; and @content_type will be set to %NULL.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the image data, or %NULL; free with g_free()</doc>
          <array length="1" zero-terminated="0" c:type="guint8*">
            <type name="guint8" c:type="guint8"/>
          </array>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
          <parameter name="length"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="full">
            <doc xml:space="preserve">return location for the image length, in bytes</doc>
            <type name="gsize" c:type="gsize*"/>
          </parameter>
          <parameter name="content_type"
                     direction="out"
                     caller-allocates="0"
                     transfer-ownership="full"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the image's content type, or %NULL; free with g_free()</doc>
            <type name="utf8" c:type="gchar**"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_postal_addresses"
              c:identifier="gdata_contacts_contact_get_postal_addresses"
              version="0.2.0">
        <doc xml:space="preserve">Gets a list of the postal addresses owned by the contact.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGDPostalAddress&lt;!-- --&gt;es, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GDPostalAddress"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_primary_calendar"
              c:identifier="gdata_contacts_contact_get_primary_calendar"
              version="0.7.0">
        <doc xml:space="preserve">Gets the contact's primary calendar, if one exists.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataGContactCalendar, or %NULL</doc>
          <type name="GContactCalendar" c:type="GDataGContactCalendar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_primary_email_address"
              c:identifier="gdata_contacts_contact_get_primary_email_address"
              version="0.2.0">
        <doc xml:space="preserve">Gets the contact's primary e-mail address, if one exists.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataGDEmailAddress, or %NULL</doc>
          <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_primary_im_address"
              c:identifier="gdata_contacts_contact_get_primary_im_address"
              version="0.2.0">
        <doc xml:space="preserve">Gets the contact's primary IM address, if one exists.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataGDIMAddress, or %NULL</doc>
          <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_primary_organization"
              c:identifier="gdata_contacts_contact_get_primary_organization"
              version="0.2.0">
        <doc xml:space="preserve">Gets the contact's primary organization, if one exists.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataGDOrganization, or %NULL</doc>
          <type name="GDOrganization" c:type="GDataGDOrganization*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_primary_phone_number"
              c:identifier="gdata_contacts_contact_get_primary_phone_number"
              version="0.2.0">
        <doc xml:space="preserve">Gets the contact's primary phone number, if one exists.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataGDPhoneNumber, or %NULL</doc>
          <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_primary_postal_address"
              c:identifier="gdata_contacts_contact_get_primary_postal_address"
              version="0.2.0">
        <doc xml:space="preserve">Gets the contact's primary postal address, if one exists.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataGDPostalAddress, or %NULL</doc>
          <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_primary_website"
              c:identifier="gdata_contacts_contact_get_primary_website"
              version="0.7.0">
        <doc xml:space="preserve">Gets the contact's primary website, if one exists.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataGContactWebsite, or %NULL</doc>
          <type name="GContactWebsite" c:type="GDataGContactWebsite*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_priority"
              c:identifier="gdata_contacts_contact_get_priority"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:priority property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the contact's priority, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relations"
              c:identifier="gdata_contacts_contact_get_relations"
              version="0.7.0">
        <doc xml:space="preserve">Gets a list of the relations of the contact.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGContactRelation&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GContactRelation"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_sensitivity"
              c:identifier="gdata_contacts_contact_get_sensitivity"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:sensitivity property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the contact's sensitivity, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_short_name"
              c:identifier="gdata_contacts_contact_get_short_name"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:short-name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the contact's short name, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_subject"
              c:identifier="gdata_contacts_contact_get_subject"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsContact:subject property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the contact's subject, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_user_defined_field"
              c:identifier="gdata_contacts_contact_get_user_defined_field"
              version="0.7.0">
        <doc xml:space="preserve">Gets the value of a user-defined field of the contact. User-defined fields are settable by the user through the Google Contacts web interface,
in contrast to extended properties, which are visible and settable only through the GData interface.

The @name of the field may not be %NULL, but may be an empty string.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the field's value, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">the field name; an arbitrary, case-sensitive, unique string</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_user_defined_fields"
              c:identifier="gdata_contacts_contact_get_user_defined_fields"
              version="0.7.0">
        <doc xml:space="preserve">Gets the full list of user-defined fields of the contact; a hash table mapping field name to value.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GHashTable of user-defined fields</doc>
          <type name="GLib.HashTable" c:type="GHashTable*">
            <type name="gpointer" c:type="gpointer"/>
            <type name="gpointer" c:type="gpointer"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_websites"
              c:identifier="gdata_contacts_contact_get_websites"
              version="0.7.0">
        <doc xml:space="preserve">Gets a list of the websites of the contact.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGContactWebsite&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GContactWebsite"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_deleted"
              c:identifier="gdata_contacts_contact_is_deleted"
              version="0.2.0">
        <doc xml:space="preserve">Returns whether the contact has recently been deleted. This will always return
%FALSE unless #GDataContactsQuery:show-deleted has been set to
%TRUE for the query which returned the contact; then this function will return
%TRUE only if the contact has been deleted.

If a contact has been deleted, no other information is available about it. This
is designed to allow contacts to be deleted from local address books using
incremental updates from the server (e.g. with #GDataQuery:updated-min and
#GDataContactsQuery:show-deleted).</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the contact has been deleted, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_group_deleted"
              c:identifier="gdata_contacts_contact_is_group_deleted"
              version="0.2.0">
        <doc xml:space="preserve">Returns whether the contact has recently been removed from the given group on the server. This
will always return %FALSE unless #GDataContactsQuery:show-deleted has been set to
%TRUE for the query which returned the contact.

If you've just removed a contact from a group locally using gdata_contacts_contact_remove_group(), %FALSE will still be returned by this function,
as the change hasn't been sent to the server.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the contact has recently been removed from the group, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="href" transfer-ownership="none">
            <doc xml:space="preserve">the group's ID URI</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="remove_all_calendars"
              c:identifier="gdata_contacts_contact_remove_all_calendars"
              version="0.7.0">
        <doc xml:space="preserve">Removes all calendars from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_all_email_addresses"
              c:identifier="gdata_contacts_contact_remove_all_email_addresses"
              version="0.4.0">
        <doc xml:space="preserve">Removes all e-mail addresses from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_all_events"
              c:identifier="gdata_contacts_contact_remove_all_events"
              version="0.7.0">
        <doc xml:space="preserve">Removes all events from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_all_external_ids"
              c:identifier="gdata_contacts_contact_remove_all_external_ids"
              version="0.7.0">
        <doc xml:space="preserve">Removes all external IDs from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_all_hobbies"
              c:identifier="gdata_contacts_contact_remove_all_hobbies"
              version="0.7.0">
        <doc xml:space="preserve">Removes all hobbies from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_all_im_addresses"
              c:identifier="gdata_contacts_contact_remove_all_im_addresses"
              version="0.4.0">
        <doc xml:space="preserve">Removes all IM addresses from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_all_jots"
              c:identifier="gdata_contacts_contact_remove_all_jots"
              version="0.7.0">
        <doc xml:space="preserve">Removes all jots from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_all_languages"
              c:identifier="gdata_contacts_contact_remove_all_languages"
              version="0.7.0">
        <doc xml:space="preserve">Removes all languages from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_all_organizations"
              c:identifier="gdata_contacts_contact_remove_all_organizations"
              version="0.4.0">
        <doc xml:space="preserve">Removes all organizations from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_all_phone_numbers"
              c:identifier="gdata_contacts_contact_remove_all_phone_numbers"
              version="0.4.0">
        <doc xml:space="preserve">Removes all phone numbers from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_all_postal_addresses"
              c:identifier="gdata_contacts_contact_remove_all_postal_addresses"
              version="0.4.0">
        <doc xml:space="preserve">Removes all postal addresses from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_all_relations"
              c:identifier="gdata_contacts_contact_remove_all_relations"
              version="0.7.0">
        <doc xml:space="preserve">Removes all relations from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_all_websites"
              c:identifier="gdata_contacts_contact_remove_all_websites"
              version="0.7.0">
        <doc xml:space="preserve">Removes all websites from the contact.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="remove_group"
              c:identifier="gdata_contacts_contact_remove_group"
              version="0.2.0">
        <doc xml:space="preserve">Removes the contact from the given group. @href should be a URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="href" transfer-ownership="none">
            <doc xml:space="preserve">the group's ID URI</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_billing_information"
              c:identifier="gdata_contacts_contact_set_billing_information"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:billing-information property to @billing_information.

If @billing_information is %NULL, the contact's billing information will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="billing_information"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new billing information for the contact, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_birthday"
              c:identifier="gdata_contacts_contact_set_birthday"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:birthday property to @birthday and the #GDataContactsContact:birthday-has-year property to @birthday_has_year.
See gdata_contacts_contact_get_birthday() for an explanation of the interation between these two properties.

If @birthday is %NULL, the contact's birthday will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="birthday"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new birthday, or %NULL</doc>
            <type name="GLib.Date" c:type="GDate*"/>
          </parameter>
          <parameter name="birthday_has_year" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if @birthday's year is relevant, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_directory_server"
              c:identifier="gdata_contacts_contact_set_directory_server"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:directory-server property to @directory_server.

If @directory_server is %NULL, the contact's directory server will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="directory_server"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new name or address of a directory server associated with the contact, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_extended_property"
              c:identifier="gdata_contacts_contact_set_extended_property"
              version="0.2.0">
        <doc xml:space="preserve">Sets the value of a contact's extended property. Extended property names are unique (but of the client's choosing),
and reusing the same property name will result in the old value of that property being overwritten.

To unset a property, set @value to %NULL or an empty string.

A contact may have up to 10 extended properties, and each should be reasonably small (i.e. not a photo or ringtone).
For more information, see the &lt;ulink type="http"
url="http://code.google.com/apis/contacts/docs/2.0/reference.html#ProjectionsAndExtended"&gt;online documentation&lt;/ulink&gt;.
%FALSE will be returned if you attempt to add more than 10 extended properties.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the property was updated or deleted successfully, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">the property name; an arbitrary, unique string</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="value"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the property value, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_file_as"
              c:identifier="gdata_contacts_contact_set_file_as"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:file-as property to @file_as.

If @file_as is %NULL, the contact will be filed under their full name.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="file_as"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new name to file the contact under, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_gender"
              c:identifier="gdata_contacts_contact_set_gender"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:gender property to @gender.

If @gender is %NULL, the contact's gender will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="gender"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new gender of the contact, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_initials"
              c:identifier="gdata_contacts_contact_set_initials"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:initials property to @initials.

If @initials is %NULL, the contact's initials will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="initials"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new initials of the contact, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_maiden_name"
              c:identifier="gdata_contacts_contact_set_maiden_name"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:maiden-name property to @maiden_name.

If @maiden_name is %NULL, the contact's maiden name will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="maiden_name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new maiden name of the contact, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_mileage"
              c:identifier="gdata_contacts_contact_set_mileage"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:mileage property to @mileage.

If @mileage is %NULL, the contact's mileage will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="mileage"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new mileage associated with the contact, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_name"
              c:identifier="gdata_contacts_contact_set_name"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:name property to @name, and increments its reference count.

@name must not be %NULL, though all its properties may be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">the new #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_nickname"
              c:identifier="gdata_contacts_contact_set_nickname"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:nickname property to @nickname.

If @nickname is %NULL, the contact's nickname will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="nickname"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new nickname, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_occupation"
              c:identifier="gdata_contacts_contact_set_occupation"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:occupation property to @occupation.

If @occupation is %NULL, the contact's occupation will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="occupation"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the contact's new occupation, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_photo"
              c:identifier="gdata_contacts_contact_set_photo"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Sets the contact's photo to @data or, if @data is %NULL, deletes the contact's photo. @content_type must be specified if @data is non-%NULL.

If @cancellable is not %NULL, then the operation can be cancelled by triggering the @cancellable object from another thread.
If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned.

If there is an error setting the photo, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsService</doc>
            <type name="ContactsService" c:type="GDataContactsService*"/>
          </parameter>
          <parameter name="data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the image data, or %NULL</doc>
            <type name="guint8" c:type="const guint8*"/>
          </parameter>
          <parameter name="length" transfer-ownership="none">
            <doc xml:space="preserve">the image length, in bytes</doc>
            <type name="gsize" c:type="gsize"/>
          </parameter>
          <parameter name="content_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the content type of the image, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_photo_async"
              c:identifier="gdata_contacts_contact_set_photo_async"
              version="0.8.0">
        <doc xml:space="preserve">Sets the contact's photo to @data or, if @data is %NULL, deletes the contact's photo. @content_type must be specified if @data is non-%NULL. @self,
@service, @data and @content_type are all reffed and copied when this function is called, so can safely be unreffed after this function returns.

When the operation is finished, @callback will be called. You can then call gdata_contacts_contact_set_photo_finish() to get the results of the
operation.

For more details, see gdata_contacts_contact_set_photo(), which is the synchronous version of this function.

If @cancellable is not %NULL, then the operation can be cancelled by triggering the @cancellable object from another thread.
If the operation was cancelled, the error %G_IO_ERROR_CANCELLED will be returned by gdata_contacts_contact_set_photo_finish().

If there is an error setting the photo, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned by gdata_contacts_contact_set_photo_finish().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsService</doc>
            <type name="ContactsService" c:type="GDataContactsService*"/>
          </parameter>
          <parameter name="data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the image data, or %NULL</doc>
            <type name="guint8" c:type="const guint8*"/>
          </parameter>
          <parameter name="length" transfer-ownership="none">
            <doc xml:space="preserve">the image length, in bytes</doc>
            <type name="gsize" c:type="gsize"/>
          </parameter>
          <parameter name="content_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the content type of the image, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="6">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the photo has been set, or %NULL</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_photo_finish"
              c:identifier="gdata_contacts_contact_set_photo_finish"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous contact photo setting operation started with gdata_contacts_contact_set_photo_async().

If there is an error setting the photo, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_priority"
              c:identifier="gdata_contacts_contact_set_priority"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:priority property to @priority.

If @priority is %NULL, the contact's priority will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="priority"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the contact's new priority, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_sensitivity"
              c:identifier="gdata_contacts_contact_set_sensitivity"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:sensitivity property to @sensitivity.

If @sensitivity is %NULL, the contact's sensitivity will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="sensitivity"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the contact's new sensitivity, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_short_name"
              c:identifier="gdata_contacts_contact_set_short_name"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:short-name property to @short_name.

If @short_name is %NULL, the contact's short name will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="short_name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the contact's new short name, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_subject"
              c:identifier="gdata_contacts_contact_set_subject"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataContactsContact:subject property to @subject.

If @subject is %NULL, the contact's subject will be removed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="subject"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the contact's new subject, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_user_defined_field"
              c:identifier="gdata_contacts_contact_set_user_defined_field"
              version="0.7.0">
        <doc xml:space="preserve">Sets the value of a contact's user-defined field. User-defined field names are unique (but of the client's choosing),
and reusing the same field name will result in the old value of that field being overwritten.

The @name of the field may not be %NULL, but may be an empty string.

To unset a field, set @value to %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsContact</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </instance-parameter>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">the field name; an arbitrary, case-sensitive, unique string</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="value"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the field value, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="billing-information"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Billing information for the contact, such as their billing name and address.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="birthday"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The contact's birthday.</doc>
        <type name="GLib.Date"/>
      </property>
      <property name="birthday-has-year"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Whether the contact's birthday includes their year of birth.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="deleted" version="0.2.0" transfer-ownership="none">
        <doc xml:space="preserve">Whether the entry has been deleted.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="directory-server"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The name or address of a directory server associated with the contact.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="edited" version="0.2.0" transfer-ownership="none">
        <doc xml:space="preserve">The last time the contact was edited. If the contact has not been edited yet, the content indicates the time it was created.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/protocol/#appEdited"&gt;
Atom Publishing Protocol specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="file-as"
                version="0.11.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The name to file the contact under for sorting purposes.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="gender"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The gender of the contact. For example: %GDATA_CONTACTS_GENDER_MALE or %GDATA_CONTACTS_GENDER_FEMALE.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="initials"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The initials of the contact.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="maiden-name"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The maiden name of the contact.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="mileage"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A mileage associated with the contact, such as one for reimbursement purposes. It can be in any format.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="name"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The contact's name in a structured representation.</doc>
        <type name="GDName"/>
      </property>
      <property name="nickname"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The contact's chosen nickname.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="occupation"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The contact's occupation.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="photo-etag" version="0.9.0" transfer-ownership="none">
        <doc xml:space="preserve">The ETag of the contact's photo, if the contact has a photo; %NULL otherwise.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="priority"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The contact's importance. For example: %GDATA_CONTACTS_PRIORITY_NORMAL or %GDATA_CONTACTS_PRIORITY_HIGH.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="sensitivity"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The sensitivity of the contact's data. For example: %GDATA_CONTACTS_SENSITIVITY_NORMAL or %GDATA_CONTACTS_SENSITIVITY_PRIVATE.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="short-name"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A short name for the contact. This should be used for contracted versions of the contact's actual name,
whereas #GDataContactsContact:nickname should be used for nicknames.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="subject"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The subject of the contact. (i.e. The contact's relevance to the address book.)</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="ContactsContactPrivate"
              c:type="GDataContactsContactPrivate*"/>
      </field>
    </class>
    <record name="ContactsContactClass"
            c:type="GDataContactsContactClass"
            glib:is-gtype-struct-for="ContactsContact"
            version="0.2.0">
      <doc xml:space="preserve">All the fields in the #GDataContactsContactClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="ContactsContactPrivate"
            c:type="GDataContactsContactPrivate"
            disguised="1">
    </record>
    <class name="ContactsGroup"
           c:symbol-prefix="contacts_group"
           c:type="GDataContactsGroup"
           version="0.7.0"
           parent="Entry"
           glib:type-name="GDataContactsGroup"
           glib:get-type="gdata_contacts_group_get_type"
           glib:type-struct="ContactsGroupClass">
      <doc xml:space="preserve">All the fields in the #GDataContactsGroup structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_contacts_group_new"
                   version="0.7.0">
        <doc xml:space="preserve">Creates a new #GDataContactsGroup with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataContactsGroup; unref with g_object_unref()</doc>
          <type name="ContactsGroup" c:type="GDataContactsGroup*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the group's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_edited"
              c:identifier="gdata_contacts_group_get_edited"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsGroup:edited property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the time the file was last edited, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsGroup</doc>
            <type name="ContactsGroup" c:type="GDataContactsGroup*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_extended_properties"
              c:identifier="gdata_contacts_group_get_extended_properties"
              version="0.7.0">
        <doc xml:space="preserve">Gets the full list of extended properties of the group; a hash table mapping property name to value.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GHashTable of extended properties</doc>
          <type name="GLib.HashTable" c:type="GHashTable*">
            <type name="gpointer" c:type="gpointer"/>
            <type name="gpointer" c:type="gpointer"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsGroup</doc>
            <type name="ContactsGroup" c:type="GDataContactsGroup*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_extended_property"
              c:identifier="gdata_contacts_group_get_extended_property"
              version="0.7.0">
        <doc xml:space="preserve">Gets the value of an extended property of the group. Each group can have up to 10 client-set extended properties to store data of the client's
choosing.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the property's value, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsGroup</doc>
            <type name="ContactsGroup" c:type="GDataContactsGroup*"/>
          </instance-parameter>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">the property name; an arbitrary, unique string</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_system_group_id"
              c:identifier="gdata_contacts_group_get_system_group_id"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataContactsGroup:system-group-id property. If the group is not a system group, %NULL will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the group's system group ID, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsGroup</doc>
            <type name="ContactsGroup" c:type="GDataContactsGroup*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_deleted"
              c:identifier="gdata_contacts_group_is_deleted"
              version="0.7.0">
        <doc xml:space="preserve">Returns whether the group has recently been deleted. This will always return %FALSE unless #GDataContactsQuery:show-deleted has been set to %TRUE
for the query which returned the group; then this function will return %TRUE only if the group has been deleted.

If a group has been deleted, no other information is available about it. This is designed to allow groups to be deleted from local address
books using incremental updates from the server (e.g. with #GDataQuery:updated-min and #GDataContactsQuery:show-deleted).</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the group has been deleted, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsGroup</doc>
            <type name="ContactsGroup" c:type="GDataContactsGroup*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_extended_property"
              c:identifier="gdata_contacts_group_set_extended_property"
              version="0.7.0">
        <doc xml:space="preserve">Sets the value of a group's extended property. Extended property names are unique (but of the client's choosing), and reusing the same property
name will result in the old value of that property being overwritten.

To unset a property, set @value to %NULL or an empty string.

A group may have up to 10 extended properties, and each should be reasonably small (i.e. not a photo or ringtone). For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/2.0/reference.html#ProjectionsAndExtended"&gt;online documentation&lt;/ulink&gt;.
%FALSE will be returned if you attempt to add more than 10 extended properties.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the property was updated or deleted successfully, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsGroup</doc>
            <type name="ContactsGroup" c:type="GDataContactsGroup*"/>
          </instance-parameter>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">the property name; an arbitrary, unique string</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="value"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the property value, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="deleted" version="0.7.0" transfer-ownership="none">
        <doc xml:space="preserve">Whether the entry has been deleted.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="edited" version="0.7.0" transfer-ownership="none">
        <doc xml:space="preserve">The last time the group was edited. If the group has not been edited yet, the content indicates the time it was created.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/protocol/#appEdited"&gt;
Atom Publishing Protocol specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="system-group-id"
                version="0.7.0"
                transfer-ownership="none">
        <doc xml:space="preserve">The system group ID for this group, if it's a system group. If the group is not a system group, this is %NULL. Otherwise, it is one of the
four system group IDs: %GDATA_CONTACTS_GROUP_CONTACTS, %GDATA_CONTACTS_GROUP_FRIENDS, %GDATA_CONTACTS_GROUP_FAMILY and
%GDATA_CONTACTS_GROUP_COWORKERS.

If this is non-%NULL, the group name stored in #GDataEntry:title will not be localised, so clients should provide localised group names of
their own for each of the system groups. Whether a group is a system group should be detected solely on the basis of the value of this
property, not by comparing the group name (#GDataEntry:title) or entry ID (#GDataEntry:id). The entry ID is not the same as the system
group ID.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="ContactsGroupPrivate" c:type="GDataContactsGroupPrivate*"/>
      </field>
    </class>
    <record name="ContactsGroupClass"
            c:type="GDataContactsGroupClass"
            glib:is-gtype-struct-for="ContactsGroup"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataContactsGroupClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="ContactsGroupPrivate"
            c:type="GDataContactsGroupPrivate"
            disguised="1">
    </record>
    <class name="ContactsQuery"
           c:symbol-prefix="contacts_query"
           c:type="GDataContactsQuery"
           version="0.2.0"
           parent="Query"
           glib:type-name="GDataContactsQuery"
           glib:get-type="gdata_contacts_query_get_type"
           glib:type-struct="ContactsQueryClass">
      <doc xml:space="preserve">All the fields in the #GDataContactsQuery structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_contacts_query_new"
                   version="0.2.0">
        <doc xml:space="preserve">Creates a new #GDataContactsQuery with its #GDataQuery:q property set to @q.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataContactsQuery</doc>
          <type name="ContactsQuery" c:type="GDataContactsQuery*"/>
        </return-value>
        <parameters>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <constructor name="new_with_limits"
                   c:identifier="gdata_contacts_query_new_with_limits"
                   version="0.2.0">
        <doc xml:space="preserve">Creates a new #GDataContactsQuery with its #GDataQuery:q property set to @q, and the limits @start_index and @max_results
applied.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataContactsQuery</doc>
          <type name="ContactsQuery" c:type="GDataContactsQuery*"/>
        </return-value>
        <parameters>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="start_index" transfer-ownership="none">
            <doc xml:space="preserve">a one-based start index for the results, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="max_results" transfer-ownership="none">
            <doc xml:space="preserve">the maximum number of results to return, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_group"
              c:identifier="gdata_contacts_query_get_group"
              version="0.2.0">
        <doc xml:space="preserve">Gets the #GDataContactsQuery:group property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the group property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsQuery</doc>
            <type name="ContactsQuery" c:type="GDataContactsQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_order_by"
              c:identifier="gdata_contacts_query_get_order_by"
              version="0.2.0">
        <doc xml:space="preserve">Gets the #GDataContactsQuery:order-by property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the order by property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsQuery</doc>
            <type name="ContactsQuery" c:type="GDataContactsQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_sort_order"
              c:identifier="gdata_contacts_query_get_sort_order"
              version="0.2.0">
        <doc xml:space="preserve">Gets the #GDataContactsQuery:sort-order property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the sort order property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsQuery</doc>
            <type name="ContactsQuery" c:type="GDataContactsQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_group"
              c:identifier="gdata_contacts_query_set_group"
              version="0.2.0">
        <doc xml:space="preserve">Sets the #GDataContactsQuery:group property of the #GDataContactsQuery to the new group ID URI, @group.

Set @group to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsQuery</doc>
            <type name="ContactsQuery" c:type="GDataContactsQuery*"/>
          </instance-parameter>
          <parameter name="group"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new group ID URI, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_order_by"
              c:identifier="gdata_contacts_query_set_order_by"
              version="0.2.0">
        <doc xml:space="preserve">Sets the #GDataContactsQuery:order-by property of the #GDataContactsQuery to the new order by string, @order_by.

Set @order_by to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsQuery</doc>
            <type name="ContactsQuery" c:type="GDataContactsQuery*"/>
          </instance-parameter>
          <parameter name="order_by"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new order by string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_show_deleted"
              c:identifier="gdata_contacts_query_set_show_deleted"
              version="0.2.0">
        <doc xml:space="preserve">Sets the #GDataContactsQuery:show-deleted property of the #GDataContactsQuery.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsQuery</doc>
            <type name="ContactsQuery" c:type="GDataContactsQuery*"/>
          </instance-parameter>
          <parameter name="show_deleted" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE to show deleted contacts, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_sort_order"
              c:identifier="gdata_contacts_query_set_sort_order"
              version="0.2.0">
        <doc xml:space="preserve">Sets the #GDataContactsQuery:sort-order property of the #GDataContactsQuery to the new sort order string, @sort_order.

Set @sort_order to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsQuery</doc>
            <type name="ContactsQuery" c:type="GDataContactsQuery*"/>
          </instance-parameter>
          <parameter name="sort_order"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new sort order string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="show_deleted"
              c:identifier="gdata_contacts_query_show_deleted"
              version="0.2.0">
        <doc xml:space="preserve">Gets the #GDataContactsQuery:show-deleted property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if deleted contacts should be shown, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsQuery</doc>
            <type name="ContactsQuery" c:type="GDataContactsQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="group"
                version="0.2.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Constrains the results to only those belonging to the group specified. The value of this parameter
should be a group ID URI.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="order-by"
                version="0.2.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Sorting criterion. The only supported value is &lt;literal&gt;lastmodified&lt;/literal&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="show-deleted"
                version="0.2.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Whether to include deleted contacts in the query feed. Deleted contacts return %TRUE
from gdata_contacts_contact_is_deleted(), and have no other information. They do not
normally appear in query results.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="sort-order"
                version="0.2.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Sorting order direction. Can be either &lt;literal&gt;ascending&lt;/literal&gt; or &lt;literal&gt;descending&lt;/literal&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Query" c:type="GDataQuery"/>
      </field>
      <field name="priv">
        <type name="ContactsQueryPrivate" c:type="GDataContactsQueryPrivate*"/>
      </field>
    </class>
    <record name="ContactsQueryClass"
            c:type="GDataContactsQueryClass"
            glib:is-gtype-struct-for="ContactsQuery"
            version="0.2.0">
      <doc xml:space="preserve">All the fields in the #GDataContactsQueryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="QueryClass" c:type="GDataQueryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="ContactsQueryPrivate"
            c:type="GDataContactsQueryPrivate"
            disguised="1">
    </record>
    <class name="ContactsService"
           c:symbol-prefix="contacts_service"
           c:type="GDataContactsService"
           version="0.2.0"
           parent="Service"
           glib:type-name="GDataContactsService"
           glib:get-type="gdata_contacts_service_get_type"
           glib:type-struct="ContactsServiceClass">
      <doc xml:space="preserve">All the fields in the #GDataContactsService structure are private and should never be accessed directly.</doc>
      <implements name="Batchable"/>
      <constructor name="new"
                   c:identifier="gdata_contacts_service_new"
                   version="0.9.0">
        <doc xml:space="preserve">Creates a new #GDataContactsService using the given #GDataAuthorizer. If @authorizer is %NULL, all requests are made as an unauthenticated user.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataContactsService, or %NULL; unref with g_object_unref()</doc>
          <type name="ContactsService" c:type="GDataContactsService*"/>
        </return-value>
        <parameters>
          <parameter name="authorizer"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataAuthorizer to authorize the service's requests, or %NULL</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </parameter>
        </parameters>
      </constructor>
      <function name="get_primary_authorization_domain"
                c:identifier="gdata_contacts_service_get_primary_authorization_domain"
                version="0.9.0">
        <doc xml:space="preserve">The primary #GDataAuthorizationDomain for interacting with Google Contacts. This will not normally need to be used, as it's used internally
by the #GDataContactsService methods. However, if using the plain #GDataService methods to implement custom queries or requests which libgdata
does not support natively, then this domain may be needed to authorize the requests.

The domain never changes, and is interned so that pointer comparison can be used to differentiate it from other authorization domains.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the service's authorization domain</doc>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
      </function>
      <method name="insert_contact"
              c:identifier="gdata_contacts_service_insert_contact"
              version="0.2.0"
              throws="1">
        <doc xml:space="preserve">Inserts @contact by uploading it to the online contacts service.

For more details, see gdata_service_insert_entry().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataContactsContact, or %NULL; unref with g_object_unref()</doc>
          <type name="ContactsContact" c:type="GDataContactsContact*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsService</doc>
            <type name="ContactsService" c:type="GDataContactsService*"/>
          </instance-parameter>
          <parameter name="contact" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataContactsContact to insert</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_contact_async"
              c:identifier="gdata_contacts_service_insert_contact_async"
              version="0.7.0">
        <doc xml:space="preserve">Inserts @contact by uploading it to the online contacts service. @self and @contact are both reffed when this function is called, so can safely be
unreffed after this function returns.

@callback should call gdata_service_insert_entry_finish() to obtain a #GDataContactsContact representing the inserted contact and to check for
possible errors.

For more details, see gdata_contacts_service_insert_contact(), which is the synchronous version of this function,
and gdata_service_insert_entry_async(), which is the base asynchronous insertion function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsService</doc>
            <type name="ContactsService" c:type="GDataContactsService*"/>
          </instance-parameter>
          <parameter name="contact" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataContactsContact to insert</doc>
            <type name="ContactsContact" c:type="GDataContactsContact*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when insertion is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_group"
              c:identifier="gdata_contacts_service_insert_group"
              version="0.7.0"
              throws="1">
        <doc xml:space="preserve">Inserts a new contact group described by @group. The user must be authenticated to use this function.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the inserted #GDataContactsGroup; unref with g_object_unref()</doc>
          <type name="ContactsGroup" c:type="GDataContactsGroup*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsService</doc>
            <type name="ContactsService" c:type="GDataContactsService*"/>
          </instance-parameter>
          <parameter name="group" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsGroup to create on the server</doc>
            <type name="ContactsGroup" c:type="GDataContactsGroup*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_group_async"
              c:identifier="gdata_contacts_service_insert_group_async"
              version="0.7.0">
        <doc xml:space="preserve">Inserts a new contact group described by @group. The user must be authenticated to use this function. @self and @group are both reffed when this
function is called, so can safely be unreffed after this function returns.

@callback should call gdata_service_insert_entry_finish() to obtain a #GDataContactsGroup representing the inserted group and to check for possible
errors.

For more details, see gdata_contacts_service_insert_group(), which is the synchronous version of this function, and
gdata_service_insert_entry_async(), which is the base asynchronous insertion function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsService</doc>
            <type name="ContactsService" c:type="GDataContactsService*"/>
          </instance-parameter>
          <parameter name="group" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataContactsGroup to insert</doc>
            <type name="ContactsGroup" c:type="GDataContactsGroup*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when insertion is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_contacts"
              c:identifier="gdata_contacts_service_query_contacts"
              version="0.2.0"
              throws="1">
        <doc xml:space="preserve">Queries the service to return a list of contacts matching the given @query.

For more details, see gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsService</doc>
            <type name="ContactsService" c:type="GDataContactsService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_contacts_async"
              c:identifier="gdata_contacts_service_query_contacts_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the service to return a list of contacts matching the given @query. @self and
@query are all reffed when this function is called, so can safely be unreffed after this function returns.

For more details, see gdata_contacts_service_query_contacts(), which is the synchronous version of this function,
and gdata_service_query_async(), which is the base asynchronous query function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsService</doc>
            <type name="ContactsService" c:type="GDataContactsService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="3"
                     destroy="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="6">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the query is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_groups"
              c:identifier="gdata_contacts_service_query_groups"
              version="0.7.0"
              throws="1">
        <doc xml:space="preserve">Queries the service to return a list of groups matching the given @query.

For more details, see gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsService</doc>
            <type name="ContactsService" c:type="GDataContactsService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_groups_async"
              c:identifier="gdata_contacts_service_query_groups_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the service to return a list of groups matching the given @query. @self and @query are all reffed when this function is called, so can
safely be unreffed after this function returns.

For more details, see gdata_contacts_service_query_groups(), which is the synchronous version of this function, and gdata_service_query_async(),
which is the base asynchronous query function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataContactsService</doc>
            <type name="ContactsService" c:type="GDataContactsService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="3"
                     destroy="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="6">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the query is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <field name="parent">
        <type name="Service" c:type="GDataService"/>
      </field>
    </class>
    <record name="ContactsServiceClass"
            c:type="GDataContactsServiceClass"
            glib:is-gtype-struct-for="ContactsService"
            version="0.2.0">
      <doc xml:space="preserve">All the fields in the #GDataContactsServiceClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ServiceClass" c:type="GDataServiceClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="ContactsServicePrivate"
            c:type="GDataContactsServicePrivate"
            disguised="1">
    </record>
    <constant name="DOCUMENTS_ACCESS_ROLE_OWNER"
              value="owner"
              c:type="GDATA_DOCUMENTS_ACCESS_ROLE_OWNER"
              version="0.7.0">
      <doc xml:space="preserve">The users specified by the #GDataAccessRule have full owner access to the document. This allows them to modify the access rules and delete
the document, amongst other things.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_ACCESS_ROLE_READER"
              value="reader"
              c:type="GDATA_DOCUMENTS_ACCESS_ROLE_READER"
              version="0.7.0">
      <doc xml:space="preserve">The users specified by the #GDataAccessRule have read-only access to the document.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_ACCESS_ROLE_WRITER"
              value="writer"
              c:type="GDATA_DOCUMENTS_ACCESS_ROLE_WRITER"
              version="0.7.0">
      <doc xml:space="preserve">The users specified by the #GDataAccessRule have write access to the document. They cannot modify the access rules or delete the document.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_DRAWING_JPEG"
              value="jpeg"
              c:type="GDATA_DOCUMENTS_DRAWING_JPEG"
              version="0.13.1">
      <doc xml:space="preserve">The export format for JPEG image format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_drawings"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_DRAWING_PDF"
              value="pdf"
              c:type="GDATA_DOCUMENTS_DRAWING_PDF"
              version="0.13.1">
      <doc xml:space="preserve">The export format for Portable Document Format (PDF).

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_drawings"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_DRAWING_PNG"
              value="png"
              c:type="GDATA_DOCUMENTS_DRAWING_PNG"
              version="0.13.1">
      <doc xml:space="preserve">The export format for Portable Network Graphics (PNG) image format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_drawings"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_DRAWING_SVG"
              value="svg"
              c:type="GDATA_DOCUMENTS_DRAWING_SVG"
              version="0.13.1">
      <doc xml:space="preserve">The export format for Scalable Vector Graphics (SVG) image format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_drawings"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_PRESENTATION_PDF"
              value="pdf"
              c:type="GDATA_DOCUMENTS_PRESENTATION_PDF"
              version="0.7.0">
      <doc xml:space="preserve">The export format for Portable Document Format (PDF).

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_formats_for_presentations"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_PRESENTATION_PNG"
              value="png"
              c:type="GDATA_DOCUMENTS_PRESENTATION_PNG"
              version="0.7.0">
      <doc xml:space="preserve">The export format for Portable Network Graphics (PNG) image format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_formats_for_presentations"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_PRESENTATION_PPT"
              value="ppt"
              c:type="GDATA_DOCUMENTS_PRESENTATION_PPT"
              version="0.7.0">
      <doc xml:space="preserve">The export format for Microsoft PowerPoint (PPT) format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_formats_for_presentations"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_PRESENTATION_SWF"
              value="swf"
              c:type="GDATA_DOCUMENTS_PRESENTATION_SWF"
              version="0.7.0"
              deprecated="1">
      <doc xml:space="preserve">The export format for Adobe Flash (SWF) format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_formats_for_presentations"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <doc-deprecated xml:space="preserve">SWF export has been deprecated in the protocol due to low demand for it; PDF export (using %GDATA_DOCUMENTS_PRESENTATION_PDF) is
recommended instead. (Since: 0.11.0.)</doc-deprecated>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_PRESENTATION_TXT"
              value="txt"
              c:type="GDATA_DOCUMENTS_PRESENTATION_TXT"
              version="0.7.0">
      <doc xml:space="preserve">The export format for plain text format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_formats_for_presentations"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_SPREADSHEET_CSV"
              value="csv"
              c:type="GDATA_DOCUMENTS_SPREADSHEET_CSV"
              version="0.7.0">
      <doc xml:space="preserve">The export format for Comma-Separated Values (CSV) format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_formats_for_spreadsheets"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_SPREADSHEET_HTML"
              value="html"
              c:type="GDATA_DOCUMENTS_SPREADSHEET_HTML"
              version="0.7.0">
      <doc xml:space="preserve">The export format for HyperText Markup Language (HTML) format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_formats_for_spreadsheets"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_SPREADSHEET_ODS"
              value="ods"
              c:type="GDATA_DOCUMENTS_SPREADSHEET_ODS"
              version="0.7.0">
      <doc xml:space="preserve">The export format for OpenDocument Spreadsheet (ODS) format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_formats_for_spreadsheets"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_SPREADSHEET_PDF"
              value="pdf"
              c:type="GDATA_DOCUMENTS_SPREADSHEET_PDF"
              version="0.7.0">
      <doc xml:space="preserve">The export format for Portable Document Format (PDF).

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_formats_for_spreadsheets"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_SPREADSHEET_TSV"
              value="tsv"
              c:type="GDATA_DOCUMENTS_SPREADSHEET_TSV"
              version="0.7.0">
      <doc xml:space="preserve">The export format for Tab-Separated Values (TSV) format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_formats_for_spreadsheets"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_SPREADSHEET_XLS"
              value="xls"
              c:type="GDATA_DOCUMENTS_SPREADSHEET_XLS"
              version="0.7.0">
      <doc xml:space="preserve">The export format for Microsoft Excel spreadsheet (XLS) format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_formats_for_spreadsheets"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_TEXT_DOC"
              value="doc"
              c:type="GDATA_DOCUMENTS_TEXT_DOC"
              version="0.7.0">
      <doc xml:space="preserve">The export format for Microsoft Word (DOC) format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_text_documents"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_TEXT_HTML"
              value="html"
              c:type="GDATA_DOCUMENTS_TEXT_HTML"
              version="0.7.0">
      <doc xml:space="preserve">The export format for HyperText Markup Language (HTML) format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_text_documents"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_TEXT_JPEG"
              value="jpeg"
              c:type="GDATA_DOCUMENTS_TEXT_JPEG"
              version="0.13.0">
      <doc xml:space="preserve">The export format for JPEG image format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_text_documents"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_TEXT_ODT"
              value="odt"
              c:type="GDATA_DOCUMENTS_TEXT_ODT"
              version="0.7.0">
      <doc xml:space="preserve">The export format for OpenDocument Text (ODT) format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_text_documents"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_TEXT_PDF"
              value="pdf"
              c:type="GDATA_DOCUMENTS_TEXT_PDF"
              version="0.7.0">
      <doc xml:space="preserve">The export format for Portable Document Format (PDF).

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_text_documents"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_TEXT_PNG"
              value="png"
              c:type="GDATA_DOCUMENTS_TEXT_PNG"
              version="0.7.0">
      <doc xml:space="preserve">The export format for Portable Network Graphics (PNG) image format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_text_documents"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_TEXT_RTF"
              value="rtf"
              c:type="GDATA_DOCUMENTS_TEXT_RTF"
              version="0.7.0">
      <doc xml:space="preserve">The export format for Rich Text Format (RTF).

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_text_documents"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_TEXT_TXT"
              value="txt"
              c:type="GDATA_DOCUMENTS_TEXT_TXT"
              version="0.7.0">
      <doc xml:space="preserve">The export format for plain text format.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_text_documents"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="DOCUMENTS_TEXT_ZIP"
              value="zip"
              c:type="GDATA_DOCUMENTS_TEXT_ZIP"
              version="0.7.0">
      <doc xml:space="preserve">The export format for a ZIP archive containing images and exported HTML.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#valid_download_formats_for_text_documents"&gt;
GData protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <class name="DocumentsAccessRule"
           c:symbol-prefix="documents_access_rule"
           c:type="GDataDocumentsAccessRule"
           version="0.17.2"
           parent="AccessRule"
           glib:type-name="GDataDocumentsAccessRule"
           glib:get-type="gdata_documents_access_rule_get_type"
           glib:type-struct="DocumentsAccessRuleClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsAccessRule structure are private and
should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_documents_access_rule_new"
                   version="0.17.2">
        <doc xml:space="preserve">Creates a new #GDataDocumentsAccessRule with the given ID and default
properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataDocumentsAccessRule; unref with
  g_object_unref()</doc>
          <type name="DocumentsAccessRule" c:type="GDataDocumentsAccessRule*"/>
        </return-value>
        <parameters>
          <parameter name="id" transfer-ownership="none">
            <doc xml:space="preserve">the access rule's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <field name="parent">
        <type name="AccessRule" c:type="GDataAccessRule"/>
      </field>
    </class>
    <record name="DocumentsAccessRuleClass"
            c:type="GDataDocumentsAccessRuleClass"
            glib:is-gtype-struct-for="DocumentsAccessRule"
            version="0.17.2">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsAccessRuleClass structure are private
and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="AccessRuleClass" c:type="GDataAccessRuleClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <class name="DocumentsDocument"
           c:symbol-prefix="documents_document"
           c:type="GDataDocumentsDocument"
           version="0.7.0"
           parent="DocumentsEntry"
           glib:type-name="GDataDocumentsDocument"
           glib:get-type="gdata_documents_document_get_type"
           glib:type-struct="DocumentsDocumentClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsDocument structure are private and should never be accessed directly.</doc>
      <implements name="AccessHandler"/>
      <constructor name="new"
                   c:identifier="gdata_documents_document_new"
                   version="0.13.0">
        <doc xml:space="preserve">Creates a new #GDataDocumentsDocument with the given entry ID (#GDataEntry:id).</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataDocumentsDocument, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the entry's ID (not the document ID), or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="download"
              c:identifier="gdata_documents_document_download"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Downloads and returns the document file represented by the #GDataDocumentsDocument. If the document doesn't exist, %NULL is returned, but no error
is set in @error.

@export_format should be the file extension of the desired output format for the document, from the list accepted by Google Documents. For example:
%GDATA_DOCUMENTS_PRESENTATION_PDF, %GDATA_DOCUMENTS_SPREADSHEET_ODS or %GDATA_DOCUMENTS_TEXT_ODT.

If @self is a #GDataDocumentsSpreadsheet, only the first grid, or sheet, in the spreadsheet will be downloaded for some export formats. To download
a specific a specific grid, use gdata_documents_spreadsheet_get_download_uri() with #GDataDownloadStream to download the grid manually. See the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#downloading_spreadsheets"&gt;GData protocol
specification&lt;/ulink&gt; for more information.

To get the content type of the downloaded file, gdata_download_stream_get_content_type() can be called on the returned #GDataDownloadStream.
Calling gdata_download_stream_get_content_length() on the stream will not return a meaningful result, however, as the stream is encoded in chunks,
rather than by content length.

In order to cancel the download, a #GCancellable passed in to @cancellable must be cancelled using g_cancellable_cancel(). Cancelling the individual
#GInputStream operations on the #GDataDownloadStream will not cancel the entire download; merely the read or close operation in question. See the
#GDataDownloadStream:cancellable for more details.

If @service isn't authenticated, a %GDATA_SERVICE_ERROR_AUTHENTICATION_REQUIRED will be returned.

If there is an error getting the document, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataDownloadStream to download the document with, or %NULL; unref with g_object_unref()</doc>
          <type name="DownloadStream" c:type="GDataDownloadStream*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsDocument</doc>
            <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </parameter>
          <parameter name="export_format" transfer-ownership="none">
            <doc xml:space="preserve">the format in which the document should be exported</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable for the entire download stream, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_download_uri"
              c:identifier="gdata_documents_document_get_download_uri"
              version="0.7.0">
        <doc xml:space="preserve">Builds and returns the download URI for the given #GDataDocumentsDocument in the desired format. Note that directly downloading the document using
this URI isn't possible, as authentication is required. You should instead use gdata_download_stream_new() with the URI, and use the resulting
#GInputStream.

@export_format should be the file extension of the desired output format for the document, from the list accepted by Google Documents. For example:
%GDATA_DOCUMENTS_PRESENTATION_PDF, %GDATA_DOCUMENTS_SPREADSHEET_ODS or %GDATA_DOCUMENTS_TEXT_ODT.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the download URI; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsDocument</doc>
            <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
          </instance-parameter>
          <parameter name="export_format" transfer-ownership="none">
            <doc xml:space="preserve">the format in which the document should be exported when downloaded</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_thumbnail_uri"
              c:identifier="gdata_documents_document_get_thumbnail_uri"
              version="0.13.1">
        <doc xml:space="preserve">Gets the URI of the thumbnail for the #GDataDocumentsDocument. If no thumbnail exists for the document, %NULL will be returned.

The thumbnail may then be downloaded using a #GDataDownloadStream.

&lt;example&gt;
&lt;title&gt;Downloading a Document Thumbnail&lt;/title&gt;
&lt;programlisting&gt;
GDataDocumentsService *service;
const gchar *thumbnail_uri;
GCancellable *cancellable;
GdkPixbuf *pixbuf;
GError *error = NULL;

service = get_my_documents_service ();
thumbnail_uri = gdata_documents_document_get_thumbnail_uri (my_document);
cancellable = g_cancellable_new ();

/&lt;!-- --&gt;* Prepare a download stream *&lt;!-- --&gt;/
download_stream = GDATA_DOWNLOAD_STREAM (gdata_download_stream_new (GDATA_SERVICE (service), NULL, thumbnail_uri, cancellable));

/&lt;!-- --&gt;* Download into a new GdkPixbuf. This can be cancelled using 'cancellable'. *&lt;!-- --&gt;/
pixbuf = gdk_pixbuf_new_from_stream (G_INPUT_STREAM (download_stream), NULL, &amp;error);

if (error != NULL) {
	/&lt;!-- --&gt;* Handle the error. *&lt;!-- --&gt;/
	g_error_free (error);
}

g_object_unref (download_stream);
g_object_unref (cancellable);

/&lt;!-- --&gt;* Do something with the GdkPixbuf. *&lt;!-- --&gt;/

g_object_unref (pixbuf);
&lt;/programlisting&gt;
&lt;/example&gt;</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the URI of the document's thumbnail, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsDocument</doc>
            <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
          </instance-parameter>
        </parameters>
      </method>
      <field name="parent">
        <type name="DocumentsEntry" c:type="GDataDocumentsEntry"/>
      </field>
      <field name="priv">
        <type name="DocumentsDocumentPrivate"
              c:type="GDataDocumentsDocumentPrivate*"/>
      </field>
    </class>
    <record name="DocumentsDocumentClass"
            c:type="GDataDocumentsDocumentClass"
            glib:is-gtype-struct-for="DocumentsDocument"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsDocumentClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="DocumentsEntryClass" c:type="GDataDocumentsEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="DocumentsDocumentPrivate"
            c:type="GDataDocumentsDocumentPrivate"
            disguised="1">
    </record>
    <class name="DocumentsDrawing"
           c:symbol-prefix="documents_drawing"
           c:type="GDataDocumentsDrawing"
           version="0.13.1"
           parent="DocumentsDocument"
           glib:type-name="GDataDocumentsDrawing"
           glib:get-type="gdata_documents_drawing_get_type"
           glib:type-struct="DocumentsDrawingClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsDrawing structure are private and should never be accessed directly.</doc>
      <implements name="AccessHandler"/>
      <constructor name="new"
                   c:identifier="gdata_documents_drawing_new"
                   version="0.13.1">
        <doc xml:space="preserve">Creates a new #GDataDocumentsDrawing with the given entry ID (#GDataEntry:id).</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataDocumentsDrawing, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsDrawing" c:type="GDataDocumentsDrawing*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the entry's ID (not the document ID of the drawing document), or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <field name="parent">
        <type name="DocumentsDocument" c:type="GDataDocumentsDocument"/>
      </field>
      <field name="priv">
        <type name="DocumentsDrawingPrivate"
              c:type="GDataDocumentsDrawingPrivate*"/>
      </field>
    </class>
    <record name="DocumentsDrawingClass"
            c:type="GDataDocumentsDrawingClass"
            glib:is-gtype-struct-for="DocumentsDrawing"
            version="0.13.1">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsDrawingClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="DocumentsDocumentClass"
              c:type="GDataDocumentsDocumentClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="DocumentsDrawingPrivate"
            c:type="GDataDocumentsDrawingPrivate"
            disguised="1">
    </record>
    <class name="DocumentsEntry"
           c:symbol-prefix="documents_entry"
           c:type="GDataDocumentsEntry"
           version="0.4.0"
           parent="Entry"
           abstract="1"
           glib:type-name="GDataDocumentsEntry"
           glib:get-type="gdata_documents_entry_get_type"
           glib:type-struct="DocumentsEntryClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsEntry structure are private and should never be accessed directly.</doc>
      <implements name="AccessHandler"/>
      <method name="get_document_id"
              c:identifier="gdata_documents_entry_get_document_id"
              version="0.4.0"
              deprecated="1"
              deprecated-version="0.11.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsEntry:document-id property. The
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#terminology_used_in_this_guide"&gt;online GData Documentation&lt;/ulink&gt;
refers to these as “untyped resource IDs”.</doc>
        <doc-deprecated xml:space="preserve">Use gdata_documents_entry_get_resource_id() instead. See #GDataDocumentsEntry:document-id.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the document's document ID</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsEntry</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_edited"
              c:identifier="gdata_documents_entry_get_edited"
              version="0.4.0"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsEntry:edited property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <doc-deprecated xml:space="preserve">Use gdata_entry_get_updated() instead. See #GDataDocumentsEntry:edited.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the time the document was last edited, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsEntry</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_last_modified_by"
              c:identifier="gdata_documents_entry_get_last_modified_by"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsEntry:last-modified-by property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the author who last modified the document</doc>
          <type name="Author" c:type="GDataAuthor*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsEntry</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_last_viewed"
              c:identifier="gdata_documents_entry_get_last_viewed"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsEntry:last-viewed property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the time the document was last viewed, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsEntry</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_path"
              c:identifier="gdata_documents_entry_get_path"
              version="0.4.0">
        <doc xml:space="preserve">Builds a path for the #GDataDocumentsEntry, starting from a root node and traversing the folders containing the document, then ending with the
document's ID.

An example path would be: &lt;literal&gt;/folder_id1/folder_id2/document_id&lt;/literal&gt;.

Note: the path is based on the entry/document IDs of the folders (#GDataEntry:id) and document (#GDataDocumentsEntry:document-id),
and not the entries' human-readable names (#GDataEntry:title).</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the folder hierarchy path containing the document, or %NULL; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsEntry</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_quota_used"
              c:identifier="gdata_documents_entry_get_quota_used"
              version="0.13.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsEntry:quota-used property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the number of quota bytes used by the document</doc>
          <type name="gint64" c:type="goffset"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsEntry</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_resource_id"
              c:identifier="gdata_documents_entry_get_resource_id"
              version="0.11.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsEntry:resource-id property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the document's resource ID</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsEntry</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_deleted"
              c:identifier="gdata_documents_entry_is_deleted"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsEntry:is-deleted property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the document has been deleted, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsEntry</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_writers_can_invite"
              c:identifier="gdata_documents_entry_set_writers_can_invite"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataDocumentsEntry:writers-can-invite property to @writers_can_invite.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsEntry</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </instance-parameter>
          <parameter name="writers_can_invite" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if writers can invite other people to edit the document, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="writers_can_invite"
              c:identifier="gdata_documents_entry_writers_can_invite"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsEntry:writers-can-invite property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if writers can invite other people to edit the document, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsEntry</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="document-id"
                version="0.4.0"
                deprecated="1"
                deprecated-version="0.11.0"
                transfer-ownership="none">
        <doc xml:space="preserve">The document ID of the document, which is different from its entry ID (GDataEntry:id). The
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#terminology_used_in_this_guide"&gt;online GData
Documentation&lt;/ulink&gt; refers to these as “untyped resource IDs”.</doc>
        <doc-deprecated xml:space="preserve">This a substring of the #GDataDocumentsEntry:resource-id, which is more general and should be used instead.</doc-deprecated>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="edited"
                version="0.4.0"
                deprecated="1"
                deprecated-version="0.17.0"
                transfer-ownership="none">
        <doc xml:space="preserve">The last time the document was edited. If the document has not been edited yet, the content indicates the time it was created.</doc>
        <doc-deprecated xml:space="preserve">This is identical to #GDataEntry:updated.</doc-deprecated>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="is-deleted"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates whether the document entry has been deleted (moved to the trash). Deleted documents will only
appear in query results if the #GDataDocumentsQuery:show-deleted property is %TRUE.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="last-modified-by"
                version="0.4.0"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates the author of the last modification.</doc>
        <type name="Author"/>
      </property>
      <property name="last-viewed" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The last time the document was viewed.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="quota-used" version="0.13.0" transfer-ownership="none">
        <doc xml:space="preserve">The amount of user quota the document is occupying. Currently, only arbitrary files consume file space quota (whereas standard document
formats, such as #GDataDocumentsText, #GDataDocumentsSpreadsheet and #GDataDocumentsFolder don't). Measured in bytes.

This property will be &lt;code class="literal"&gt;0&lt;/code&gt; for documents which aren't consuming any quota.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="resource-id" version="0.11.0" transfer-ownership="none">
        <doc xml:space="preserve">The resource ID of the document. This should not normally need to be used in client code, and is mostly for internal use. To uniquely
identify a given document or folder, use its #GDataEntry:id.

Resource IDs have the form:
&lt;literal&gt;&lt;replaceable&gt;document|drawing|pdf|spreadsheet|presentation|folder&lt;/replaceable&gt;:&lt;replaceable&gt;untyped resource ID&lt;/replaceable&gt;&lt;/literal&gt;; whereas
entry IDs have the form:
&lt;literal&gt;https://docs.google.com/feeds/id/&lt;replaceable&gt;resource ID&lt;/replaceable&gt;&lt;/literal&gt; in version 3 of the API.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#resource_ids_explained"&gt;Google Documents
API reference&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="writers-can-invite"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates whether the document entry writers can invite others to edit the document.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="DocumentsEntryPrivate"
              c:type="GDataDocumentsEntryPrivate*"/>
      </field>
    </class>
    <record name="DocumentsEntryClass"
            c:type="GDataDocumentsEntryClass"
            glib:is-gtype-struct-for="DocumentsEntry"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsEntryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="DocumentsEntryPrivate"
            c:type="GDataDocumentsEntryPrivate"
            disguised="1">
    </record>
    <class name="DocumentsFeed"
           c:symbol-prefix="documents_feed"
           c:type="GDataDocumentsFeed"
           version="0.4.0"
           parent="Feed"
           glib:type-name="GDataDocumentsFeed"
           glib:get-type="gdata_documents_feed_get_type"
           glib:type-struct="DocumentsFeedClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsFeed structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="Feed" c:type="GDataFeed"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="DocumentsFeedPrivate" c:type="GDataDocumentsFeedPrivate*"/>
      </field>
    </class>
    <record name="DocumentsFeedClass"
            c:type="GDataDocumentsFeedClass"
            glib:is-gtype-struct-for="DocumentsFeed"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsFeedClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="FeedClass" c:type="GDataFeedClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="DocumentsFeedPrivate"
            c:type="GDataDocumentsFeedPrivate"
            disguised="1">
    </record>
    <class name="DocumentsFolder"
           c:symbol-prefix="documents_folder"
           c:type="GDataDocumentsFolder"
           version="0.4.0"
           parent="DocumentsEntry"
           glib:type-name="GDataDocumentsFolder"
           glib:get-type="gdata_documents_folder_get_type"
           glib:type-struct="DocumentsFolderClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsFolder structure are private and should never be accessed directly.</doc>
      <implements name="AccessHandler"/>
      <constructor name="new"
                   c:identifier="gdata_documents_folder_new"
                   version="0.4.0">
        <doc xml:space="preserve">Creates a new #GDataDocumentsFolder with the given entry ID (#GDataEntry:id).</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataDocumentsFolder, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsFolder" c:type="GDataDocumentsFolder*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the entry's ID (not the document ID of the folder), or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <field name="parent">
        <type name="DocumentsEntry" c:type="GDataDocumentsEntry"/>
      </field>
      <field name="priv">
        <type name="DocumentsFolderPrivate"
              c:type="GDataDocumentsFolderPrivate*"/>
      </field>
    </class>
    <record name="DocumentsFolderClass"
            c:type="GDataDocumentsFolderClass"
            glib:is-gtype-struct-for="DocumentsFolder"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsFolderClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="DocumentsEntryClass" c:type="GDataDocumentsEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="DocumentsFolderPrivate"
            c:type="GDataDocumentsFolderPrivate"
            disguised="1">
    </record>
    <class name="DocumentsPdf"
           c:symbol-prefix="documents_pdf"
           c:type="GDataDocumentsPdf"
           version="0.13.3"
           parent="DocumentsDocument"
           glib:type-name="GDataDocumentsPdf"
           glib:get-type="gdata_documents_pdf_get_type"
           glib:type-struct="DocumentsPdfClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsPdf structure are private and should never be accessed directly.</doc>
      <implements name="AccessHandler"/>
      <constructor name="new"
                   c:identifier="gdata_documents_pdf_new"
                   version="0.13.3">
        <doc xml:space="preserve">Creates a new #GDataDocumentsPdf with the given entry ID (#GDataEntry:id).</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataDocumentsPdf, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsPdf" c:type="GDataDocumentsPdf*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the entry's ID (not the document ID of the pdf document), or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <field name="parent">
        <type name="DocumentsDocument" c:type="GDataDocumentsDocument"/>
      </field>
      <field name="priv">
        <type name="DocumentsPdfPrivate" c:type="GDataDocumentsPdfPrivate*"/>
      </field>
    </class>
    <record name="DocumentsPdfClass"
            c:type="GDataDocumentsPdfClass"
            glib:is-gtype-struct-for="DocumentsPdf"
            version="0.13.3">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsPdfClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="DocumentsDocumentClass"
              c:type="GDataDocumentsDocumentClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="DocumentsPdfPrivate"
            c:type="GDataDocumentsPdfPrivate"
            disguised="1">
    </record>
    <class name="DocumentsPresentation"
           c:symbol-prefix="documents_presentation"
           c:type="GDataDocumentsPresentation"
           version="0.4.0"
           parent="DocumentsDocument"
           glib:type-name="GDataDocumentsPresentation"
           glib:get-type="gdata_documents_presentation_get_type"
           glib:type-struct="DocumentsPresentationClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsPresentation structure are private and should never be accessed directly.</doc>
      <implements name="AccessHandler"/>
      <constructor name="new"
                   c:identifier="gdata_documents_presentation_new"
                   version="0.4.0">
        <doc xml:space="preserve">Creates a new #GDataDocumentsPresentation with the given entry ID (#GDataEntry:id).</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataDocumentsPresentation, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsPresentation"
                c:type="GDataDocumentsPresentation*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the entry's ID (not the document ID of the presentation), or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <field name="parent">
        <type name="DocumentsDocument" c:type="GDataDocumentsDocument"/>
      </field>
      <field name="priv">
        <type name="DocumentsPresentationPrivate"
              c:type="GDataDocumentsPresentationPrivate*"/>
      </field>
    </class>
    <record name="DocumentsPresentationClass"
            c:type="GDataDocumentsPresentationClass"
            glib:is-gtype-struct-for="DocumentsPresentation"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsPresentationClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="DocumentsDocumentClass"
              c:type="GDataDocumentsDocumentClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="DocumentsPresentationPrivate"
            c:type="GDataDocumentsPresentationPrivate"
            disguised="1">
    </record>
    <class name="DocumentsQuery"
           c:symbol-prefix="documents_query"
           c:type="GDataDocumentsQuery"
           version="0.4.0"
           parent="Query"
           glib:type-name="GDataDocumentsQuery"
           glib:get-type="gdata_documents_query_get_type"
           glib:type-struct="DocumentsQueryClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsQuery structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_documents_query_new"
                   version="0.4.0">
        <doc xml:space="preserve">Creates a new #GDataDocumentsQuery with its #GDataQuery:q property set to @q.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataDocumentsQuery</doc>
          <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
        </return-value>
        <parameters>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <constructor name="new_with_limits"
                   c:identifier="gdata_documents_query_new_with_limits"
                   version="0.4.0">
        <doc xml:space="preserve">Creates a new #GDataDocumentsQuery with its #GDataQuery:q property set to @q, and the limits @start_index and @max_results
applied.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataDocumentsQuery</doc>
          <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
        </return-value>
        <parameters>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="start_index" transfer-ownership="none">
            <doc xml:space="preserve">a one-based start index for the results, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="max_results" transfer-ownership="none">
            <doc xml:space="preserve">the maximum number of results to return, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="add_collaborator"
              c:identifier="gdata_documents_query_add_collaborator"
              version="0.4.0">
        <doc xml:space="preserve">Add @email_address as a #GDataGDEmailAddress to the list of collaborators whose edited documents will be queried.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
          <parameter name="email_address" transfer-ownership="none">
            <doc xml:space="preserve">the e-mail address of the collaborator to add</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_reader"
              c:identifier="gdata_documents_query_add_reader"
              version="0.4.0">
        <doc xml:space="preserve">Add @email_address as a #GDataGDEmailAddress to the list of readers, the documents readable by whom will be queried.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
          <parameter name="email_address" transfer-ownership="none">
            <doc xml:space="preserve">the e-mail address of the reader to add</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_collaborator_addresses"
              c:identifier="gdata_documents_query_get_collaborator_addresses"
              version="0.4.0">
        <doc xml:space="preserve">Gets a list of #GDataGDEmailAddress&lt;!-- --&gt;es of the document collaborators whose documents will be queried.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a list of #GDataGDEmailAddress&lt;!-- --&gt;es of the collaborators concerned by the
query, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GDEmailAddress"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_exact_title"
              c:identifier="gdata_documents_query_get_exact_title"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsQuery:exact-title property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the query matches the exact title of documents with #GDataDocumentsQuery:title, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_folder_id"
              c:identifier="gdata_documents_query_get_folder_id"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsQuery:folder-id property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the ID of the folder to be queried, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_reader_addresses"
              c:identifier="gdata_documents_query_get_reader_addresses"
              version="0.4.0">
        <doc xml:space="preserve">Gets a list of #GDataGDEmailAddress&lt;!-- --&gt;es of the document readers whose documents will be queried.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a list of #GDataGDEmailAddress&lt;!-- --&gt;es of the readers concerned by the query,
or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GDEmailAddress"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_title"
              c:identifier="gdata_documents_query_get_title"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsQuery:title property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the title (or title fragment) being queried for, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_folder_id"
              c:identifier="gdata_documents_query_set_folder_id"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataDocumentsQuery:folder-id property to @folder_id.

Set @folder_id to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
          <parameter name="folder_id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the ID of the folder to be queried, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_show_deleted"
              c:identifier="gdata_documents_query_set_show_deleted"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataDocumentsQuery:show_deleted property to @show_deleted.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
          <parameter name="show_deleted" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if the request should return deleted entries, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_show_folders"
              c:identifier="gdata_documents_query_set_show_folders"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataDocumentsQuery:show-folders property to show_folders.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
          <parameter name="show_folders" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if the request should return folders, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_title"
              c:identifier="gdata_documents_query_set_title"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataDocumentsQuery:title property to @title.

Set @title to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
          <parameter name="title"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the title (or title fragment) to query for, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="exact_title" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if the query should match the exact @title, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="show_deleted"
              c:identifier="gdata_documents_query_show_deleted"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsQuery:show_deleted property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the request should return deleted entries, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="show_folders"
              c:identifier="gdata_documents_query_show_folders"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataDocumentsQuery:show-folders property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the request should return folders, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsQuery</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="exact-title"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies whether the query should search for an exact title match for the #GDataDocumentsQuery:title parameter.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="folder-id"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies the ID of the folder in which to search.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="show-deleted"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A shortcut to request all documents that have been deleted.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="show-folders"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies if the request also returns folders.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="title"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A title (or title fragment) to be searched for. If #GDataDocumentsQuery:exact-title is %TRUE, an exact
title match will be searched for, otherwise substring matches will also be returned.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Query" c:type="GDataQuery"/>
      </field>
      <field name="priv">
        <type name="DocumentsQueryPrivate"
              c:type="GDataDocumentsQueryPrivate*"/>
      </field>
    </class>
    <record name="DocumentsQueryClass"
            c:type="GDataDocumentsQueryClass"
            glib:is-gtype-struct-for="DocumentsQuery"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsQueryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="QueryClass" c:type="GDataQueryClass"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="DocumentsQueryPrivate"
              c:type="GDataDocumentsQueryPrivate*"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="DocumentsQueryPrivate"
            c:type="GDataDocumentsQueryPrivate"
            disguised="1">
    </record>
    <class name="DocumentsService"
           c:symbol-prefix="documents_service"
           c:type="GDataDocumentsService"
           version="0.4.0"
           parent="Service"
           glib:type-name="GDataDocumentsService"
           glib:get-type="gdata_documents_service_get_type"
           glib:type-struct="DocumentsServiceClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsService structure are private and should never be accessed directly.</doc>
      <implements name="Batchable"/>
      <constructor name="new"
                   c:identifier="gdata_documents_service_new"
                   version="0.9.0">
        <doc xml:space="preserve">Creates a new #GDataDocumentsService using the given #GDataAuthorizer. If @authorizer is %NULL, all requests are made as an unauthenticated user.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataDocumentsService, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsService" c:type="GDataDocumentsService*"/>
        </return-value>
        <parameters>
          <parameter name="authorizer"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataAuthorizer to authorize the service's requests, or %NULL</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </parameter>
        </parameters>
      </constructor>
      <function name="get_primary_authorization_domain"
                c:identifier="gdata_documents_service_get_primary_authorization_domain"
                version="0.9.0">
        <doc xml:space="preserve">The primary #GDataAuthorizationDomain for interacting with Google Documents. This will not normally need to be used, as it's used internally
by the #GDataDocumentsService methods. However, if using the plain #GDataService methods to implement custom queries or requests which libgdata
does not support natively, then this domain may be needed to authorize the requests.

The domain never changes, and is interned so that pointer comparison can be used to differentiate it from other authorization domains.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the service's authorization domain</doc>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
      </function>
      <function name="get_spreadsheet_authorization_domain"
                c:identifier="gdata_documents_service_get_spreadsheet_authorization_domain"
                version="0.9.0">
        <doc xml:space="preserve">The #GDataAuthorizationDomain for interacting with spreadsheet data. This will not normally need to be used, as it's automatically used internally
by the #GDataDocumentsService methods. However, if using the plain #GDataService methods to implement custom queries or requests which libgdata
does not support natively, then this domain may be needed to authorize the requests which pertain to the Google Spreadsheets Data API, such as
requests to download or upload spreadsheet documents.

The domain never changes, and is interned so that pointer comparison can be used to differentiate it from other authorization domains.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the service's authorization domain</doc>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
      </function>
      <function name="get_upload_uri"
                c:identifier="gdata_documents_service_get_upload_uri"
                version="0.5.0">
        <doc xml:space="preserve">Gets the upload URI for documents for the service.

If @folder is %NULL, the URI will be the one to upload documents to the "root" folder.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the URI permitting the upload of documents to @folder, or %NULL; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <parameter name="folder"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataDocumentsFolder into which to upload the document, or %NULL</doc>
            <type name="DocumentsFolder" c:type="GDataDocumentsFolder*"/>
          </parameter>
        </parameters>
      </function>
      <method name="add_entry_to_folder"
              c:identifier="gdata_documents_service_add_entry_to_folder"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Add the given @entry to the specified @folder, and return an updated #GDataDocumentsEntry for @entry. If the @entry is already in another folder,
a copy will be added to the new folder. The copy and original will have different IDs. Note that @entry can't be a #GDataDocumentsFolder that
already exists on the server. It can be a new #GDataDocumentsFolder, or a #GDataDocumentsDocument that is either new or already present on the
server.

Errors from #GDataServiceError can be returned for exceptional conditions, as determined by the server.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">an authenticated #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataDocumentsEntry to copy</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </parameter>
          <parameter name="folder" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataDocumentsFolder to copy @entry into</doc>
            <type name="DocumentsFolder" c:type="GDataDocumentsFolder*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_entry_to_folder_async"
              c:identifier="gdata_documents_service_add_entry_to_folder_async"
              version="0.8.0">
        <doc xml:space="preserve">Add the given @entry to the specified @folder. @self, @entry and @folder are all reffed when this function is called, so can safely be unreffed
after this function returns.

For more details, see gdata_documents_service_add_entry_to_folder(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_documents_service_add_entry_to_folder_finish() to get the results
of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataDocumentsEntry to add to @folder</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </parameter>
          <parameter name="folder" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataDocumentsFolder to add @entry to</doc>
            <type name="DocumentsFolder" c:type="GDataDocumentsFolder*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="4">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the operation is finished, or %NULL</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_entry_to_folder_finish"
              c:identifier="gdata_documents_service_add_entry_to_folder_finish"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Finish an asynchronous operation to add a #GDataDocumentsEntry to a folder started with gdata_documents_service_add_entry_to_folder_async().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="copy_document"
              c:identifier="gdata_documents_service_copy_document"
              version="0.13.1"
              throws="1">
        <doc xml:space="preserve">Copy the given @document, producing a duplicate document in the same folder and returning its #GDataDocumentsDocument.

Errors from #GDataServiceError can be returned for exceptional conditions, as determined by the server.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the duplicate #GDataDocumentsDocument, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">an authenticated #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="document" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataDocumentsDocument to copy</doc>
            <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="copy_document_async"
              c:identifier="gdata_documents_service_copy_document_async"
              version="0.13.1">
        <doc xml:space="preserve">Copy the given @document, producing a duplicate document in the same folder and returning its #GDataDocumentsDocument. @self and @document are
both reffed when this function is called, so can safely be unreffed after this function returns.

For more details, see gdata_documents_service_copy_document(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_documents_service_copy_document_finish() to get the results
of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="document" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataDocumentsDocument to copy</doc>
            <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the operation is finished, or %NULL</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="copy_document_finish"
              c:identifier="gdata_documents_service_copy_document_finish"
              version="0.13.1"
              throws="1">
        <doc xml:space="preserve">Finish an asynchronous operation to copy a #GDataDocumentsDocument started with gdata_documents_service_copy_document_async().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the duplicate #GDataDocumentsDocument, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="finish_upload"
              c:identifier="gdata_documents_service_finish_upload"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Finish off a document upload or update operation started by gdata_documents_service_upload_document() or gdata_documents_service_update_document(),
parsing the result and returning the new or updated #GDataDocumentsDocument.

If an error occurred during the upload or update operation, it will have been returned during the operation (e.g. by g_output_stream_splice() or one
of the other stream methods). In such a case, %NULL will be returned but @error will remain unset. @error is only set in the case that the server
indicates that the operation was successful, but an error is encountered in parsing the result sent by the server.

In the case that no #GDataDocumentsDocument was passed (to gdata_documents_service_upload_document() or gdata_documents_service_update_document())
when starting the operation, %GDATA_DOCUMENTS_SERVICE_ERROR_INVALID_CONTENT_TYPE will be thrown in @error if the content type of the uploaded data
could not be mapped to a document type with which to interpret the response from the server.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the new or updated #GDataDocumentsDocument, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="upload_stream" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataUploadStream from the operation</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_documents"
              c:identifier="gdata_documents_service_query_documents"
              version="0.4.0"
              throws="1">
        <doc xml:space="preserve">Queries the service to return a list of documents matching the given @query. Note that @query has to be a #GDataDocumentsQuery, rather than just
a #GDataQuery, as it uses the folder ID specified in #GDataDocumentsQuery:folder-id.

For more details, see gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataDocumentsFeed of query results; unref with g_object_unref()</doc>
          <type name="DocumentsFeed" c:type="GDataDocumentsFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataDocumentsQuery with the query parameters, or %NULL</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_documents_async"
              c:identifier="gdata_documents_service_query_documents_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the service to return a list of documents matching the given @query. @self and
@query are both reffed when this function is called, so can safely be unreffed after this function returns.

For more details, see gdata_documents_service_query_documents(), which is the synchronous version of this function,
and gdata_service_query_async(), which is the base asynchronous query function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataDocumentsQuery with the query parameters, or %NULL</doc>
            <type name="DocumentsQuery" c:type="GDataDocumentsQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="3"
                     destroy="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="6">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authentication is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="remove_entry_from_folder"
              c:identifier="gdata_documents_service_remove_entry_from_folder"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Remove the given @entry from @folder, and return an updated #GDataDocumentsEntry for @entry. @entry will remain a member of any other folders it's
currently in. Note that @entry can be either a #GDataDocumentsDocument or a #GDataDocumentsFolder.

Errors from #GDataServiceError can be returned for exceptional conditions, as determined by the server.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataDocumentsEntry to remove</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </parameter>
          <parameter name="folder" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataDocumentsFolder from which we should remove @entry</doc>
            <type name="DocumentsFolder" c:type="GDataDocumentsFolder*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="remove_entry_from_folder_async"
              c:identifier="gdata_documents_service_remove_entry_from_folder_async"
              version="0.8.0">
        <doc xml:space="preserve">Remove the given @entry from the specified @folder. @self, @entry and @folder are all reffed when this function is called, so can safely be unreffed
after this function returns.

For more details, see gdata_documents_service_remove_entry_from_folder(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_documents_service_remove_entry_from_folder_finish() to get the
results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataDocumentsEntry to remove from @folder</doc>
            <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
          </parameter>
          <parameter name="folder" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataDocumentsFolder to remove @entry from</doc>
            <type name="DocumentsFolder" c:type="GDataDocumentsFolder*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="4">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the operation is finished, or %NULL</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="remove_entry_from_folder_finish"
              c:identifier="gdata_documents_service_remove_entry_from_folder_finish"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Finish an asynchronous operation to remove a #GDataDocumentsEntry from a folder started with
gdata_documents_service_remove_entry_from_folder_async().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataDocumentsEntry, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsEntry" c:type="GDataDocumentsEntry*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="update_document"
              c:identifier="gdata_documents_service_update_document"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Update the document using the properties from @document and the document data written to the resulting #GDataUploadStream. If the document data does
not need to be changed, just the metadata, use gdata_service_update_entry() instead.

This performs a non-resumable upload, unlike gdata_documents_service_update_document(). This means that errors during transmission will cause the
upload to fail, and the entire document will have to be re-uploaded. It is recommended that gdata_documents_service_update_document_resumable()
be used instead.

The stream returned by this function should be written to using the standard #GOutputStream methods, asychronously or synchronously. Once the stream
is closed (using g_output_stream_close()), gdata_documents_service_finish_upload() should be called on it to parse and return the updated
#GDataDocumentsDocument for the document. This must be done, as @document isn't updated in-place.

In order to cancel the update, a #GCancellable passed in to @cancellable must be cancelled using g_cancellable_cancel(). Cancelling the individual
#GOutputStream operations on the #GDataUploadStream will not cancel the entire update; merely the write or close operation in question. See the
#GDataUploadStream:cancellable for more details.

Any upload errors will be thrown by the stream methods, and may come from the #GDataServiceError domain.

For more information, see gdata_service_update_entry().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataUploadStream to write the document data to; unref with g_object_unref()</doc>
          <type name="UploadStream" c:type="GDataUploadStream*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="document" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataDocumentsDocument to update</doc>
            <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
          </parameter>
          <parameter name="slug" transfer-ownership="none">
            <doc xml:space="preserve">the filename to give to the uploaded document</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="content_type" transfer-ownership="none">
            <doc xml:space="preserve">the content type of the uploaded data</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable for the entire upload stream, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="update_document_resumable"
              c:identifier="gdata_documents_service_update_document_resumable"
              version="0.13.0"
              throws="1">
        <doc xml:space="preserve">Update the document using the properties from @document and the document data written to the resulting #GDataUploadStream. If the document data does
not need to be changed, just the metadata, use gdata_service_update_entry() instead.

Unlike gdata_documents_service_update_document(), this method performs a
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/resumable_upload.html"&gt;resumable upload&lt;/ulink&gt; which allows for correction of
transmission errors without re-uploading the entire file. Use of this method is preferred over gdata_documents_service_update_document().

The stream returned by this function should be written to using the standard #GOutputStream methods, asychronously or synchronously. Once the stream
is closed (using g_output_stream_close()), gdata_documents_service_finish_upload() should be called on it to parse and return the updated
#GDataDocumentsDocument for the document. This must be done, as @document isn't updated in-place.

In order to cancel the update, a #GCancellable passed in to @cancellable must be cancelled using g_cancellable_cancel(). Cancelling the individual
#GOutputStream operations on the #GDataUploadStream will not cancel the entire update; merely the write or close operation in question. See the
#GDataUploadStream:cancellable for more details.

Any upload errors will be thrown by the stream methods, and may come from the #GDataServiceError domain.

For more information, see gdata_service_update_entry().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataUploadStream to write the document data to; unref with g_object_unref()</doc>
          <type name="UploadStream" c:type="GDataUploadStream*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="document" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataDocumentsDocument to update</doc>
            <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
          </parameter>
          <parameter name="slug" transfer-ownership="none">
            <doc xml:space="preserve">the filename to give to the uploaded document</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="content_type" transfer-ownership="none">
            <doc xml:space="preserve">the content type of the uploaded data</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="content_length" transfer-ownership="none">
            <doc xml:space="preserve">the size (in bytes) of the file being uploaded</doc>
            <type name="gint64" c:type="goffset"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable for the entire upload stream, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="upload_document"
              c:identifier="gdata_documents_service_upload_document"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Uploads a document to Google Documents, using the properties from @document and the document data written to the resulting #GDataUploadStream. If
the document data does not need to be provided at the moment, just the metadata, use gdata_service_insert_entry() instead (e.g. in the case of
creating a new, empty file to be edited at a later date).

This performs a non-resumable upload, unlike gdata_documents_service_upload_document(). This means that errors during transmission will cause the
upload to fail, and the entire document will have to be re-uploaded. It is recommended that gdata_documents_service_upload_document_resumable()
be used instead.

If @document is %NULL, only the document data will be uploaded. The new document entry will be named using @slug, and will have default metadata.

The stream returned by this function should be written to using the standard #GOutputStream methods, asychronously or synchronously. Once the stream
is closed (using g_output_stream_close()), gdata_documents_service_finish_upload() should be called on it to parse and return the updated
#GDataDocumentsDocument for the document. This must be done, as @document isn't updated in-place.

In order to cancel the upload, a #GCancellable passed in to @cancellable must be cancelled using g_cancellable_cancel(). Cancelling the individual
#GOutputStream operations on the #GDataUploadStream will not cancel the entire upload; merely the write or close operation in question. See the
#GDataUploadStream:cancellable for more details.

Any upload errors will be thrown by the stream methods, and may come from the #GDataServiceError domain.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataUploadStream to write the document data to, or %NULL; unref with g_object_unref()</doc>
          <type name="UploadStream" c:type="GDataUploadStream*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">an authenticated #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="document"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataDocumentsDocument to insert, or %NULL</doc>
            <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
          </parameter>
          <parameter name="slug" transfer-ownership="none">
            <doc xml:space="preserve">the filename to give to the uploaded document</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="content_type" transfer-ownership="none">
            <doc xml:space="preserve">the content type of the uploaded data</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="folder"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the folder to which the document should be uploaded, or %NULL</doc>
            <type name="DocumentsFolder" c:type="GDataDocumentsFolder*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable for the entire upload stream, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="upload_document_resumable"
              c:identifier="gdata_documents_service_upload_document_resumable"
              version="0.13.0"
              throws="1">
        <doc xml:space="preserve">Uploads a document to Google Documents, using the properties from @document and the document data written to the resulting #GDataUploadStream. If
the document data does not need to be provided at the moment, just the metadata, use gdata_service_insert_entry() instead (e.g. in the case of
creating a new, empty file to be edited at a later date).

Unlike gdata_documents_service_upload_document(), this method performs a
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/resumable_upload.html"&gt;resumable upload&lt;/ulink&gt; which allows for correction of
transmission errors without re-uploading the entire file. Use of this method is preferred over gdata_documents_service_upload_document().

If @document is %NULL, only the document data will be uploaded. The new document entry will be named using @slug, and will have default metadata.

If non-%NULL, the @query specifies parameters for the upload, such as a #GDataDocumentsFolder to upload the document into; and whether to treat
the document as an opaque file, or convert it to a standard format. If @query is %NULL, the document will be uploaded into the root folder, and
automatically converted to a standard format. No OCR or automatic language translation will be performed by default.

If @query is non-%NULL and #GDataDocumentsUploadQuery:convert is %FALSE, @document must be an instance of #GDataDocumentsDocument. Otherwise,
@document must be a subclass of it, such as #GDataDocumentsPresentation.

The stream returned by this function should be written to using the standard #GOutputStream methods, asychronously or synchronously. Once the stream
is closed (using g_output_stream_close()), gdata_documents_service_finish_upload() should be called on it to parse and return the updated
#GDataDocumentsDocument for the document. This must be done, as @document isn't updated in-place.

In order to cancel the upload, a #GCancellable passed in to @cancellable must be cancelled using g_cancellable_cancel(). Cancelling the individual
#GOutputStream operations on the #GDataUploadStream will not cancel the entire upload; merely the write or close operation in question. See the
#GDataUploadStream:cancellable for more details.

Any upload errors will be thrown by the stream methods, and may come from the #GDataServiceError domain.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataUploadStream to write the document data to, or %NULL; unref with g_object_unref()</doc>
          <type name="UploadStream" c:type="GDataUploadStream*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">an authenticated #GDataDocumentsService</doc>
            <type name="DocumentsService" c:type="GDataDocumentsService*"/>
          </instance-parameter>
          <parameter name="document"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataDocumentsDocument to insert, or %NULL</doc>
            <type name="DocumentsDocument" c:type="GDataDocumentsDocument*"/>
          </parameter>
          <parameter name="slug" transfer-ownership="none">
            <doc xml:space="preserve">the filename to give to the uploaded document</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="content_type" transfer-ownership="none">
            <doc xml:space="preserve">the content type of the uploaded data</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="content_length" transfer-ownership="none">
            <doc xml:space="preserve">the size (in bytes) of the file being uploaded</doc>
            <type name="gint64" c:type="goffset"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query specifying parameters for the upload, or %NULL</doc>
            <type name="DocumentsUploadQuery"
                  c:type="GDataDocumentsUploadQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable for the entire upload stream, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <field name="parent">
        <type name="Service" c:type="GDataService"/>
      </field>
      <field name="priv">
        <type name="DocumentsServicePrivate"
              c:type="GDataDocumentsServicePrivate*"/>
      </field>
    </class>
    <record name="DocumentsServiceClass"
            c:type="GDataDocumentsServiceClass"
            glib:is-gtype-struct-for="DocumentsService"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsServiceClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ServiceClass" c:type="GDataServiceClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <enumeration name="DocumentsServiceError"
                 version="0.4.0"
                 glib:type-name="GDataDocumentsServiceError"
                 glib:get-type="gdata_documents_service_error_get_type"
                 c:type="GDataDocumentsServiceError"
                 glib:error-domain="gdata-documents-service-error-quark">
      <doc xml:space="preserve">Error codes for #GDataDocumentsService operations.</doc>
      <member name="type"
              value="0"
              c:identifier="GDATA_DOCUMENTS_SERVICE_ERROR_INVALID_CONTENT_TYPE"
              glib:nick="type">
        <doc xml:space="preserve">the content type of a provided file was invalid</doc>
      </member>
      <function name="quark"
                c:identifier="gdata_documents_service_error_quark">
        <return-value transfer-ownership="none">
          <type name="GLib.Quark" c:type="GQuark"/>
        </return-value>
      </function>
    </enumeration>
    <record name="DocumentsServicePrivate"
            c:type="GDataDocumentsServicePrivate"
            disguised="1">
    </record>
    <class name="DocumentsSpreadsheet"
           c:symbol-prefix="documents_spreadsheet"
           c:type="GDataDocumentsSpreadsheet"
           version="0.4.0"
           parent="DocumentsDocument"
           glib:type-name="GDataDocumentsSpreadsheet"
           glib:get-type="gdata_documents_spreadsheet_get_type"
           glib:type-struct="DocumentsSpreadsheetClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsSpreadsheet structure are private and should never be accessed directly.</doc>
      <implements name="AccessHandler"/>
      <constructor name="new"
                   c:identifier="gdata_documents_spreadsheet_new"
                   version="0.4.0">
        <doc xml:space="preserve">Creates a new #GDataDocumentsSpreadsheet with the given entry ID (#GDataEntry:id).</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataDocumentsSpreadsheet, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsSpreadsheet"
                c:type="GDataDocumentsSpreadsheet*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the entry's ID (not the document ID of the spreadsheet), or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_download_uri"
              c:identifier="gdata_documents_spreadsheet_get_download_uri"
              version="0.5.0">
        <doc xml:space="preserve">Builds and returns the download URI for the given #GDataDocumentsSpreadsheet in the desired format. Note that directly downloading
the document using this URI isn't possible, as authentication is required. You should instead use gdata_download_stream_new() with
the URI, and use the resulting #GInputStream.

When requesting a &lt;code class="literal"&gt;"csv"&lt;/code&gt;, &lt;code class="literal"&gt;"tsv"&lt;/code&gt;, &lt;code class="literal"&gt;"pdf"&lt;/code&gt; or
&lt;code class="literal"&gt;"html"&lt;/code&gt; file you may specify an additional parameter called @gid which indicates which grid, or sheet, you wish to get
(the index is &lt;code class="literal"&gt;0&lt;/code&gt;-based, so GID &lt;code class="literal"&gt;1&lt;/code&gt; actually refers to the second sheet on a given
spreadsheet).</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the download URI; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsSpreadsheet</doc>
            <type name="DocumentsSpreadsheet"
                  c:type="GDataDocumentsSpreadsheet*"/>
          </instance-parameter>
          <parameter name="export_format" transfer-ownership="none">
            <doc xml:space="preserve">the format in which the spreadsheet should be exported when downloaded</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="gid" transfer-ownership="none">
            <doc xml:space="preserve">the &lt;code class="literal"&gt;0&lt;/code&gt;-based sheet ID to download, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </method>
      <field name="parent">
        <type name="DocumentsDocument" c:type="GDataDocumentsDocument"/>
      </field>
      <field name="priv">
        <type name="DocumentsSpreadsheetPrivate"
              c:type="GDataDocumentsSpreadsheetPrivate*"/>
      </field>
    </class>
    <record name="DocumentsSpreadsheetClass"
            c:type="GDataDocumentsSpreadsheetClass"
            glib:is-gtype-struct-for="DocumentsSpreadsheet"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsSpreadsheetClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="DocumentsDocumentClass"
              c:type="GDataDocumentsDocumentClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="DocumentsSpreadsheetPrivate"
            c:type="GDataDocumentsSpreadsheetPrivate"
            disguised="1">
    </record>
    <class name="DocumentsText"
           c:symbol-prefix="documents_text"
           c:type="GDataDocumentsText"
           version="0.4.0"
           parent="DocumentsDocument"
           glib:type-name="GDataDocumentsText"
           glib:get-type="gdata_documents_text_get_type"
           glib:type-struct="DocumentsTextClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsText structure are private and should never be accessed directly.</doc>
      <implements name="AccessHandler"/>
      <constructor name="new"
                   c:identifier="gdata_documents_text_new"
                   version="0.4.0">
        <doc xml:space="preserve">Creates a new #GDataDocumentsText with the given entry ID (#GDataEntry:id).</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataDocumentsText, or %NULL; unref with g_object_unref()</doc>
          <type name="DocumentsText" c:type="GDataDocumentsText*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the entry's ID (not the document ID of the text document), or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <field name="parent">
        <type name="DocumentsDocument" c:type="GDataDocumentsDocument"/>
      </field>
      <field name="priv">
        <type name="DocumentsTextPrivate" c:type="GDataDocumentsTextPrivate*"/>
      </field>
    </class>
    <record name="DocumentsTextClass"
            c:type="GDataDocumentsTextClass"
            glib:is-gtype-struct-for="DocumentsText"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsTextClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="DocumentsDocumentClass"
              c:type="GDataDocumentsDocumentClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="DocumentsTextPrivate"
            c:type="GDataDocumentsTextPrivate"
            disguised="1">
    </record>
    <class name="DocumentsUploadQuery"
           c:symbol-prefix="documents_upload_query"
           c:type="GDataDocumentsUploadQuery"
           version="0.13.0"
           parent="GObject.Object"
           glib:type-name="GDataDocumentsUploadQuery"
           glib:get-type="gdata_documents_upload_query_get_type"
           glib:type-struct="DocumentsUploadQueryClass">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsUploadQuery structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_documents_upload_query_new"
                   version="0.13.0">
        <doc xml:space="preserve">Constructs a new empty #GDataDocumentsUploadQuery.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataDocumentsUploadQuery; unref with g_object_unref()</doc>
          <type name="DocumentsUploadQuery"
                c:type="GDataDocumentsUploadQuery*"/>
        </return-value>
      </constructor>
      <method name="build_uri"
              c:identifier="gdata_documents_upload_query_build_uri"
              version="0.13.0">
        <doc xml:space="preserve">Builds an upload URI suitable for passing to gdata_upload_stream_new_resumable() in order to upload a document to Google Documents as described in
the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#uploading_a_new_document_or_file_with_both_metadata_and_content"&gt;
online documentation&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a complete upload URI; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsUploadQuery</doc>
            <type name="DocumentsUploadQuery"
                  c:type="GDataDocumentsUploadQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_convert"
              c:identifier="gdata_documents_upload_query_get_convert"
              version="0.13.0">
        <doc xml:space="preserve">Gets #GDataDocumentsUploadQuery:convert.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE to convert documents to common formats, %FALSE to upload them unmodified</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsUploadQuery</doc>
            <type name="DocumentsUploadQuery"
                  c:type="GDataDocumentsUploadQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_folder"
              c:identifier="gdata_documents_upload_query_get_folder"
              version="0.13.0">
        <doc xml:space="preserve">Gets #GDataDocumentsUploadQuery:folder.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the folder to upload into, or %NULL</doc>
          <type name="DocumentsFolder" c:type="GDataDocumentsFolder*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsUploadQuery</doc>
            <type name="DocumentsUploadQuery"
                  c:type="GDataDocumentsUploadQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_convert"
              c:identifier="gdata_documents_upload_query_set_convert"
              version="0.13.0">
        <doc xml:space="preserve">Sets #GDataDocumentsUploadQuery:convert to @convert.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsUploadQuery</doc>
            <type name="DocumentsUploadQuery"
                  c:type="GDataDocumentsUploadQuery*"/>
          </instance-parameter>
          <parameter name="convert" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE to convert documents to common formats, %FALSE to upload them unmodified</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_folder"
              c:identifier="gdata_documents_upload_query_set_folder"
              version="0.13.0">
        <doc xml:space="preserve">Sets #GDataDocumentsUploadQuery:folder to @folder.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDocumentsUploadQuery</doc>
            <type name="DocumentsUploadQuery"
                  c:type="GDataDocumentsUploadQuery*"/>
          </instance-parameter>
          <parameter name="folder"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new folder to upload into, or %NULL</doc>
            <type name="DocumentsFolder" c:type="GDataDocumentsFolder*"/>
          </parameter>
        </parameters>
      </method>
      <property name="convert"
                version="0.13.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">%TRUE to automatically convert the uploaded document into a standard format (such as a text document, spreadsheet, presentation, etc.).
%FALSE to upload the document without converting it; this allows for arbitrary files to be uploaded to Google Documents.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/#creating_or_uploading_files"&gt;online documentation&lt;/ulink&gt;.

Note that uploading with this property set to %FALSE will only have an effect when using gdata_documents_service_update_document_resumable()
and not gdata_documents_service_update_document(). Additionally, the #GDataDocumentsDocument passed to
gdata_documents_service_update_document_resumable() must be a #GDataDocumentsDocument if this property is %FALSE, and a subclass of it
otherwise.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="folder"
                version="0.13.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Folder to upload the document into. If this is %NULL, the document will be uploaded into the root folder.</doc>
        <type name="DocumentsFolder"/>
      </property>
      <field name="parent">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="priv">
        <type name="DocumentsUploadQueryPrivate"
              c:type="GDataDocumentsUploadQueryPrivate*"/>
      </field>
    </class>
    <record name="DocumentsUploadQueryClass"
            c:type="GDataDocumentsUploadQueryClass"
            glib:is-gtype-struct-for="DocumentsUploadQuery"
            version="0.13.0">
      <doc xml:space="preserve">All the fields in the #GDataDocumentsUploadQueryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="DocumentsUploadQueryPrivate"
            c:type="GDataDocumentsUploadQueryPrivate"
            disguised="1">
    </record>
    <class name="DownloadStream"
           c:symbol-prefix="download_stream"
           c:type="GDataDownloadStream"
           version="0.5.0"
           parent="Gio.InputStream"
           glib:type-name="GDataDownloadStream"
           glib:get-type="gdata_download_stream_get_type"
           glib:type-struct="DownloadStreamClass">
      <doc xml:space="preserve">All the fields in the #GDataDownloadStream structure are private and should never be accessed directly.</doc>
      <implements name="Gio.Seekable"/>
      <constructor name="new"
                   c:identifier="gdata_download_stream_new"
                   version="0.9.0">
        <doc xml:space="preserve">Creates a new #GDataDownloadStream, allowing a file to be downloaded from a GData service using standard #GInputStream API.

As well as the standard GIO errors, calls to the #GInputStream API on a #GDataDownloadStream can also return any relevant specific error from
#GDataServiceError, or %GDATA_SERVICE_ERROR_PROTOCOL_ERROR in the general case.

If a #GCancellable is provided in @cancellable, the download operation may be cancelled at any time from another thread using g_cancellable_cancel().
In this case, any ongoing network activity will be stopped, and any pending or future calls to #GInputStream API on the #GDataDownloadStream will
return %G_IO_ERROR_CANCELLED. Note that the #GCancellable objects which can be passed to individual #GInputStream operations will not cancel the
download operation proper if cancelled — they will merely cancel that API call. The only way to cancel the download operation completely is using
this @cancellable.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GInputStream, or %NULL; unref with g_object_unref()</doc>
          <type name="Gio.InputStream" c:type="GInputStream*"/>
        </return-value>
        <parameters>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain to authorize the download, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="download_uri" transfer-ownership="none">
            <doc xml:space="preserve">the URI to download</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable for the entire download stream, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_authorization_domain"
              c:identifier="gdata_download_stream_get_authorization_domain"
              version="0.9.0">
        <doc xml:space="preserve">Gets the authorization domain used to authorize the download, as passed to gdata_download_stream_new(). It may be %NULL if authorization is not
needed for the download.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #GDataAuthorizationDomain used to authorize the download, or %NULL</doc>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDownloadStream</doc>
            <type name="DownloadStream" c:type="GDataDownloadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_cancellable"
              c:identifier="gdata_download_stream_get_cancellable"
              version="0.8.0">
        <doc xml:space="preserve">Gets the #GCancellable for the entire download operation, #GDataDownloadStream:cancellable.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #GCancellable for the entire download operation</doc>
          <type name="Gio.Cancellable" c:type="GCancellable*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDownloadStream</doc>
            <type name="DownloadStream" c:type="GDataDownloadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_content_length"
              c:identifier="gdata_download_stream_get_content_length"
              version="0.5.0">
        <doc xml:space="preserve">Gets the length (in bytes) of the file being downloaded. If the &lt;literal&gt;Content-Length&lt;/literal&gt; header has not yet
been received from the server, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the content length of the file being downloaded, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gssize" c:type="gssize"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDownloadStream</doc>
            <type name="DownloadStream" c:type="GDataDownloadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_content_type"
              c:identifier="gdata_download_stream_get_content_type"
              version="0.5.0">
        <doc xml:space="preserve">Gets the content type of the file being downloaded. If the &lt;literal&gt;Content-Type&lt;/literal&gt; header has not yet
been received, %NULL will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the content type of the file being downloaded, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDownloadStream</doc>
            <type name="DownloadStream" c:type="GDataDownloadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_download_uri"
              c:identifier="gdata_download_stream_get_download_uri"
              version="0.5.0">
        <doc xml:space="preserve">Gets the URI of the file being downloaded, as passed to gdata_download_stream_new().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the URI of the file being downloaded</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDownloadStream</doc>
            <type name="DownloadStream" c:type="GDataDownloadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_service"
              c:identifier="gdata_download_stream_get_service"
              version="0.5.0">
        <doc xml:space="preserve">Gets the service used to authorize the download, as passed to gdata_download_stream_new().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #GDataService used to authorize the download</doc>
          <type name="Service" c:type="GDataService*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataDownloadStream</doc>
            <type name="DownloadStream" c:type="GDataDownloadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="authorization-domain"
                version="0.9.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The authorization domain for the download, against which the #GDataService:authorizer for the #GDataDownloadStream:service should be
authorized. This may be %NULL if authorization is not needed for the download.</doc>
        <type name="AuthorizationDomain"/>
      </property>
      <property name="cancellable"
                version="0.8.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An optional cancellable used to cancel the entire download operation. If a #GCancellable instance isn't provided for this property at
construction time (i.e. to gdata_download_stream_new()), one will be created internally and can be retrieved using
gdata_download_stream_get_cancellable() and used to cancel the download operation with g_cancellable_cancel() just as if it was passed to
gdata_download_stream_new().

If the download operation is cancelled using this #GCancellable, any ongoing network activity will be stopped, and any pending or future
calls to #GInputStream API on the #GDataDownloadStream will return %G_IO_ERROR_CANCELLED. Note that the #GCancellable objects which can be
passed to individual #GInputStream operations will not cancel the download operation proper if cancelled — they will merely cancel that API
call. The only way to cancel the download operation completely is using #GDataDownloadStream:cancellable.</doc>
        <type name="Gio.Cancellable"/>
      </property>
      <property name="content-length"
                version="0.5.0"
                transfer-ownership="none">
        <doc xml:space="preserve">The length (in bytes) of the file being downloaded. This will initially be &lt;code class="literal"&gt;-1&lt;/code&gt;, and will be populated as soon as
the appropriate header is received from the server. Its value will never change after this.

Note that change notifications for this property (#GObject::notify emissions) may be emitted in threads other than the one which created
the #GDataDownloadStream. It is the client's responsibility to ensure that any notification signal handlers are either multi-thread safe
or marshal the notification to the thread which owns the #GDataDownloadStream as appropriate.</doc>
        <type name="glong" c:type="glong"/>
      </property>
      <property name="content-type" version="0.5.0" transfer-ownership="none">
        <doc xml:space="preserve">The content type of the file being downloaded. This will initially be %NULL, and will be populated as soon as the appropriate header is
received from the server. Its value will never change after this.

Note that change notifications for this property (#GObject::notify emissions) may be emitted in threads other than the one which created
the #GDataDownloadStream. It is the client's responsibility to ensure that any notification signal handlers are either multi-thread safe
or marshal the notification to the thread which owns the #GDataDownloadStream as appropriate.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="download-uri"
                version="0.5.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The URI of the file to download.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="service"
                version="0.5.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The service which is used to authorize the download, and to which the download relates.</doc>
        <type name="Service"/>
      </property>
      <field name="parent">
        <type name="Gio.InputStream" c:type="GInputStream"/>
      </field>
      <field name="priv">
        <type name="DownloadStreamPrivate"
              c:type="GDataDownloadStreamPrivate*"/>
      </field>
    </class>
    <record name="DownloadStreamClass"
            c:type="GDataDownloadStreamClass"
            glib:is-gtype-struct-for="DownloadStream"
            version="0.5.0">
      <doc xml:space="preserve">All the fields in the #GDataDownloadStreamClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="Gio.InputStreamClass" c:type="GInputStreamClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="DownloadStreamPrivate"
            c:type="GDataDownloadStreamPrivate"
            disguised="1">
    </record>
    <class name="Entry"
           c:symbol-prefix="entry"
           c:type="GDataEntry"
           parent="Parsable"
           glib:type-name="GDataEntry"
           glib:get-type="gdata_entry_get_type"
           glib:type-struct="EntryClass">
      <doc xml:space="preserve">All the fields in the #GDataEntry structure are private and should never be accessed directly.</doc>
      <constructor name="new" c:identifier="gdata_entry_new">
        <doc xml:space="preserve">Creates a new #GDataEntry with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataEntry; unref with g_object_unref()</doc>
          <type name="Entry" c:type="GDataEntry*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the entry's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="add_author" c:identifier="gdata_entry_add_author">
        <doc xml:space="preserve">Adds @author to the list of authors in the given #GDataEntry and increments its reference count.

Duplicate authors will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
          <parameter name="author" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataAuthor to add</doc>
            <type name="Author" c:type="GDataAuthor*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_category" c:identifier="gdata_entry_add_category">
        <doc xml:space="preserve">Adds @category to the list of categories in the given #GDataEntry, and increments its reference count.

Duplicate categories will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
          <parameter name="category" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataCategory to add</doc>
            <type name="Category" c:type="GDataCategory*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_link" c:identifier="gdata_entry_add_link">
        <doc xml:space="preserve">Adds @_link to the list of links in the given #GDataEntry and increments its reference count.

Duplicate links will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
          <parameter name="_link" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink to add</doc>
            <type name="Link" c:type="GDataLink*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_authors"
              c:identifier="gdata_entry_get_authors"
              version="0.7.0">
        <doc xml:space="preserve">Gets a list of the #GDataAuthor&lt;!-- --&gt;s for this entry.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataAuthor&lt;!-- --&gt;s</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="Author"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_categories"
              c:identifier="gdata_entry_get_categories"
              version="0.2.0">
        <doc xml:space="preserve">Gets a list of the #GDataCategory&lt;!-- --&gt;s containing this entry.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataCategory&lt;!-- --&gt;s</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="Category"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_content" c:identifier="gdata_entry_get_content">
        <doc xml:space="preserve">Returns the textual content in this entry. If the content in this entry is pointed to by a URI, %NULL will be returned; the content URI will be
returned by gdata_entry_get_content_uri().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the entry's content, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_content_uri"
              c:identifier="gdata_entry_get_content_uri"
              version="0.7.0">
        <doc xml:space="preserve">Returns a URI pointing to the content of this entry. If the content in this entry is stored directly, %NULL will be returned; the content will be
returned by gdata_entry_get_content().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a URI pointing to the entry's content, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_etag"
              c:identifier="gdata_entry_get_etag"
              version="0.2.0">
        <doc xml:space="preserve">Returns the ETag of the entry; a unique identifier for each version of the entry. For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/reference.html#ResourceVersioning"&gt;online documentation&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the entry's ETag</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_id" c:identifier="gdata_entry_get_id">
        <doc xml:space="preserve">Returns the URN ID of the entry; a unique and permanent identifier for the object the entry represents.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the entry's ID</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_published" c:identifier="gdata_entry_get_published">
        <doc xml:space="preserve">Gets the time the entry was originally published.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the original publish time of the entry</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_rights"
              c:identifier="gdata_entry_get_rights"
              version="0.5.0">
        <doc xml:space="preserve">Returns the rights pertaining to the entry, or %NULL if not set.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the entry's rights information</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_summary"
              c:identifier="gdata_entry_get_summary"
              version="0.4.0">
        <doc xml:space="preserve">Returns the summary of the entry.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the entry's summary, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_title" c:identifier="gdata_entry_get_title">
        <doc xml:space="preserve">Returns the title of the entry.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the entry's title</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_updated" c:identifier="gdata_entry_get_updated">
        <doc xml:space="preserve">Gets the time the entry was last updated.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the last update of the entry</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_inserted" c:identifier="gdata_entry_is_inserted">
        <doc xml:space="preserve">Returns whether the entry is marked as having been inserted on (uploaded to) the server already.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the entry has been inserted already, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="look_up_link"
              c:identifier="gdata_entry_look_up_link"
              version="0.1.1">
        <doc xml:space="preserve">Looks up a link by relation type from the list of links in the entry. If the link has one of the standard Atom relation types,
use one of the defined @rel values, instead of a static string. e.g. %GDATA_LINK_EDIT or %GDATA_LINK_SELF.

In the rare event of requiring a list of links with the same @rel value, use gdata_entry_look_up_links().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataLink, or %NULL if one was not found</doc>
          <type name="Link" c:type="GDataLink*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
          <parameter name="rel" transfer-ownership="none">
            <doc xml:space="preserve">the value of the &lt;structfield&gt;rel&lt;/structfield&gt; attribute of the desired link</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="look_up_links"
              c:identifier="gdata_entry_look_up_links"
              version="0.4.0">
        <doc xml:space="preserve">Looks up a list of links by relation type from the list of links in the entry. If the links have one of the standard Atom
relation types, use one of the defined @rel values, instead of a static string. e.g. %GDATA_LINK_EDIT or %GDATA_LINK_SELF.

If you will only use the first link found, consider calling gdata_entry_look_up_link() instead.</doc>
        <return-value transfer-ownership="container">
          <doc xml:space="preserve">a #GList of #GDataLink&lt;!-- --&gt;s, or %NULL if none were found; free the list with
g_list_free()</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="Link"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
          <parameter name="rel" transfer-ownership="none">
            <doc xml:space="preserve">the value of the &lt;structfield&gt;rel&lt;/structfield&gt; attribute of the desired links</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="remove_link"
              c:identifier="gdata_entry_remove_link"
              version="0.10.0">
        <doc xml:space="preserve">Removes @_link from the list of links in the given #GDataEntry and decrements its reference count (since the #GDataEntry held a reference to it
while it was in the list).</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if @_link was found in the #GDataEntry and removed, %FALSE if it was not found</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
          <parameter name="_link" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink to remove</doc>
            <type name="Link" c:type="GDataLink*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_content" c:identifier="gdata_entry_set_content">
        <doc xml:space="preserve">Sets the entry's content to @content. This unsets #GDataEntry:content-uri.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
          <parameter name="content"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new content for the entry, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_content_uri"
              c:identifier="gdata_entry_set_content_uri"
              version="0.7.0">
        <doc xml:space="preserve">Sets the URI pointing to the entry's content to @content. This unsets #GDataEntry:content.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
          <parameter name="content_uri"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new URI pointing to the content for the entry, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_rights"
              c:identifier="gdata_entry_set_rights"
              version="0.5.0">
        <doc xml:space="preserve">Sets the rights for this entry.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
          <parameter name="rights"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new rights, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_summary"
              c:identifier="gdata_entry_set_summary"
              version="0.4.0">
        <doc xml:space="preserve">Sets the summary of the entry.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
          <parameter name="summary"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new entry summary, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_title" c:identifier="gdata_entry_set_title">
        <doc xml:space="preserve">Sets the title of the entry.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataEntry</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </instance-parameter>
          <parameter name="title"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new entry title, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="content" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">The content of the entry. This is mutually exclusive with #GDataEntry:content.

For more information, see the &lt;ulink type="http"
url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.content"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="content-uri"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A URI pointing to the location of the content of the entry. This is mutually exclusive with #GDataEntry:content.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.content"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="etag"
                version="0.2.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An identifier for a particular version of the entry. This changes every time the entry on the server changes, and can be used
for conditional retrieval and locking.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/reference.html#ResourceVersioning"&gt;
GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="id"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A permanent, universally unique identifier for the entry, in IRI form.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.id"&gt;
Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="is-inserted" transfer-ownership="none">
        <doc xml:space="preserve">Whether the entry has been inserted on the server. This is %FALSE for entries which have just been created using gdata_entry_new() and
%TRUE for entries returned from the server by queries. It is set to %TRUE when an entry is inserted using gdata_service_insert_entry().</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="published" transfer-ownership="none">
        <doc xml:space="preserve">The date and time the entry was first published or made available.

For more information, see the &lt;ulink type="http"
url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.published"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="rights"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The ownership rights pertaining to the entry.

For more information, see the &lt;ulink type="http"
url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.rights"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="summary"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A short summary, abstract, or excerpt of the entry.

For more information, see the &lt;ulink type="http"
url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.summary"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="title" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">A human-readable title for the entry.

For more information, see the &lt;ulink type="http"
url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.title"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="updated" transfer-ownership="none">
        <doc xml:space="preserve">The date and time when the entry was most recently updated significantly.

For more information, see the &lt;ulink type="http"
url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.updated"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="EntryPrivate" c:type="GDataEntryPrivate*"/>
      </field>
    </class>
    <record name="EntryClass"
            c:type="GDataEntryClass"
            glib:is-gtype-struct-for="Entry">
      <doc xml:space="preserve">The class structure for the #GDataEntry type.</doc>
      <field name="parent">
        <doc xml:space="preserve">the parent class</doc>
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="get_entry_uri">
        <callback name="get_entry_uri">
          <return-value transfer-ownership="full">
            <type name="utf8" c:type="gchar*"/>
          </return-value>
          <parameters>
            <parameter name="id" transfer-ownership="none">
              <type name="utf8" c:type="const gchar*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="kind_term">
        <doc xml:space="preserve">the term for this entry's kind category (see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#Introduction"&gt;documentation on kinds&lt;/ulink&gt;)</doc>
        <type name="utf8" c:type="const gchar*"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved6" introspectable="0">
        <callback name="_g_reserved6">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved7" introspectable="0">
        <callback name="_g_reserved7">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="EntryPrivate" c:type="GDataEntryPrivate" disguised="1">
    </record>
    <class name="Feed"
           c:symbol-prefix="feed"
           c:type="GDataFeed"
           parent="Parsable"
           glib:type-name="GDataFeed"
           glib:get-type="gdata_feed_get_type"
           glib:type-struct="FeedClass">
      <doc xml:space="preserve">All the fields in the #GDataFeed structure are private and should never be accessed directly.</doc>
      <method name="get_authors" c:identifier="gdata_feed_get_authors">
        <doc xml:space="preserve">Returns a list of the authors listed in this feed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataAuthor&lt;!-- --&gt;s</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="Author"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_categories" c:identifier="gdata_feed_get_categories">
        <doc xml:space="preserve">Returns a list of the categories listed in this feed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataCategory&lt;!-- --&gt;s</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="Category"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_entries" c:identifier="gdata_feed_get_entries">
        <doc xml:space="preserve">Returns a list of the entries contained in this feed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataEntry&lt;!-- --&gt;s</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="Entry"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_etag"
              c:identifier="gdata_feed_get_etag"
              version="0.2.0">
        <doc xml:space="preserve">Returns the feed's unique ETag for this version.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the feed's ETag</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_generator" c:identifier="gdata_feed_get_generator">
        <doc xml:space="preserve">Returns details about the software which generated the feed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataGenerator, or %NULL</doc>
          <type name="Generator" c:type="GDataGenerator*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_icon"
              c:identifier="gdata_feed_get_icon"
              version="0.6.0">
        <doc xml:space="preserve">Returns the icon URI of the feed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the feed's icon URI, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_id" c:identifier="gdata_feed_get_id">
        <doc xml:space="preserve">Returns the feed's unique and permanent URN ID.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the feed's ID</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_items_per_page"
              c:identifier="gdata_feed_get_items_per_page">
        <doc xml:space="preserve">Returns the number of items per results page feed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the number of items per results page feed, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_links" c:identifier="gdata_feed_get_links">
        <doc xml:space="preserve">Returns a list of the links listed in this feed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataLink&lt;!-- --&gt;s</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="Link"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_logo" c:identifier="gdata_feed_get_logo">
        <doc xml:space="preserve">Returns the logo URI of the feed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the feed's logo URI, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_rights"
              c:identifier="gdata_feed_get_rights"
              version="0.7.0">
        <doc xml:space="preserve">Returns the rights pertaining to the entire feed, or %NULL if not set.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the feed's rights information</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_start_index" c:identifier="gdata_feed_get_start_index">
        <doc xml:space="preserve">Returns the one-based start index of the results feed in the result set.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the one-based start index, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_subtitle" c:identifier="gdata_feed_get_subtitle">
        <doc xml:space="preserve">Returns the subtitle of the feed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the feed's subtitle, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_title" c:identifier="gdata_feed_get_title">
        <doc xml:space="preserve">Returns the title of the feed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the feed's title</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_total_results"
              c:identifier="gdata_feed_get_total_results">
        <doc xml:space="preserve">Returns the total number of results in the result set, including results on other
pages. If this is zero, the total number is unknown.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the total number of results, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_updated" c:identifier="gdata_feed_get_updated">
        <doc xml:space="preserve">Gets the time the feed was last updated.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the time the feed was last updated</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="look_up_entry"
              c:identifier="gdata_feed_look_up_entry"
              version="0.2.0">
        <doc xml:space="preserve">Returns the entry in the feed with the given @id, if found.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #GDataEntry, or %NULL</doc>
          <type name="Entry" c:type="GDataEntry*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
          <parameter name="id" transfer-ownership="none">
            <doc xml:space="preserve">the entry's ID</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="look_up_link"
              c:identifier="gdata_feed_look_up_link"
              version="0.1.1">
        <doc xml:space="preserve">Looks up a link by #GDataLink:relation-type value from the list of links in the feed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataLink, or %NULL if one was not found</doc>
          <type name="Link" c:type="GDataLink*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFeed</doc>
            <type name="Feed" c:type="GDataFeed*"/>
          </instance-parameter>
          <parameter name="rel" transfer-ownership="none">
            <doc xml:space="preserve">the value of the #GDataLink:relation-type property of the desired link</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="etag" version="0.2.0" transfer-ownership="none">
        <doc xml:space="preserve">The unique ETag for this version of the feed. See the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/reference.html#ResourceVersioning"&gt;online documentation&lt;/ulink&gt; for
more information.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="generator" transfer-ownership="none">
        <doc xml:space="preserve">Details of the software used to generate the feed.

API reference: &lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_generator"&gt;
atom:generator&lt;/ulink&gt;</doc>
        <type name="Generator"/>
      </property>
      <property name="icon" version="0.6.0" transfer-ownership="none">
        <doc xml:space="preserve">The URI of an icon for the feed.

API reference:
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.icon"&gt;atom:icon&lt;/ulink&gt;</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="id" transfer-ownership="none">
        <doc xml:space="preserve">The unique and permanent URN ID for the feed.

API reference: &lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_id"&gt;atom:id&lt;/ulink&gt;</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="items-per-page" transfer-ownership="none">
        <doc xml:space="preserve">The number of items per results page feed.

API reference:
&lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_openSearch:itemsPerPage"&gt;
openSearch:itemsPerPage&lt;/ulink&gt;</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="logo" transfer-ownership="none">
        <doc xml:space="preserve">The URI of a logo for the feed.

API reference: &lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_logo"&gt;atom:logo&lt;/ulink&gt;</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="rights" version="0.7.0" transfer-ownership="none">
        <doc xml:space="preserve">The ownership rights pertaining to the entire feed.

For more information, see the &lt;ulink type="http"
url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.rights"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="start-index" transfer-ownership="none">
        <doc xml:space="preserve">The one-based index of the first item in the results feed.

This should &lt;emphasis&gt;not&lt;/emphasis&gt; be used manually for pagination. Instead, use a #GDataQuery and call its gdata_query_next_page()
or gdata_query_previous_page() functions before making the query to the service.

API reference: &lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_openSearch:startIndex"&gt;
openSearch:startIndex&lt;/ulink&gt;</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="subtitle" transfer-ownership="none">
        <doc xml:space="preserve">The subtitle of the feed.

API reference: &lt;ulink type="http" url="http://atomenabled.org/developers/syndication/"&gt;atom:subtitle&lt;/ulink&gt;</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="title" transfer-ownership="none">
        <doc xml:space="preserve">The title of the feed.

API reference:
&lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_title"&gt;atom:title&lt;/ulink&gt;</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="total-results" transfer-ownership="none">
        <doc xml:space="preserve">The number of items in the result set for the feed, including those on other pages. If this is zero, the total number is unknown.

This should &lt;emphasis&gt;not&lt;/emphasis&gt; be used manually for pagination. Instead, use a #GDataQuery and call its gdata_query_next_page()
or gdata_query_previous_page() functions before making the query to the service.

API reference:
&lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_openSearch:totalResults"&gt;
openSearch:totalResults&lt;/ulink&gt;</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="updated" transfer-ownership="none">
        <doc xml:space="preserve">The time the feed was last updated.

API reference: &lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_updated"&gt;
atom:updated&lt;/ulink&gt;</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <field name="parent" readable="0" private="1">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="FeedPrivate" c:type="GDataFeedPrivate*"/>
      </field>
    </class>
    <record name="FeedClass"
            c:type="GDataFeedClass"
            glib:is-gtype-struct-for="Feed">
      <doc xml:space="preserve">All the fields in the #GDataFeedClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="FeedPrivate" c:type="GDataFeedPrivate" disguised="1">
    </record>
    <class name="FreebaseQuery"
           c:symbol-prefix="freebase_query"
           c:type="GDataFreebaseQuery"
           version="0.15.1"
           parent="Query"
           glib:type-name="GDataFreebaseQuery"
           glib:get-type="gdata_freebase_query_get_type"
           glib:type-struct="FreebaseQueryClass">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseQuery structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_freebase_query_new"
                   version="0.15.1">
        <doc xml:space="preserve">Creates a new #GDataFreebaseQuery with the MQL query provided in @mql. MQL
is a JSON-based query language, analogous to SPARQL. To learn more about MQL,
see the &lt;ulink type="http" url="https://developers.google.com/freebase/v1/mql-overview"&gt;
MQL overview&lt;/ulink&gt; and &lt;ulink type="http" url="https://developers.google.com/freebase/v1/mql-cookbook"&gt;
cookbook&lt;/ulink&gt;.

For detailed information on Freebase schemas, The &lt;ulink type="http" url="http://www.freebase.com/schema"&gt;"Schema"
section&lt;/ulink&gt; on the main site allows for natural search and navigation through the multiple data properties and domains.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataFreebaseQuery</doc>
          <type name="FreebaseQuery" c:type="GDataFreebaseQuery*"/>
        </return-value>
        <parameters>
          <parameter name="mql" transfer-ownership="none">
            <doc xml:space="preserve">a MQL query string</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <constructor name="new_from_variant"
                   c:identifier="gdata_freebase_query_new_from_variant"
                   version="0.15.1">
        <doc xml:space="preserve">Creates a new #GDataFreebaseQuery with the MQL query provided in a serialized form as @variant
of type "a{smv}" containing the JSON data tree of a MQL query. One convenient way
to build the variant is using json_gvariant_serialize() from a #JsonNode. For more information
about MQL, see gdata_freebase_query_new().

#GDataFreebaseQuery takes ownership on @variant, if it has a floating reference, it will be sunk.
Otherwise an extra reference will be added.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataFreebaseQuery</doc>
          <type name="FreebaseQuery" c:type="GDataFreebaseQuery*"/>
        </return-value>
        <parameters>
          <parameter name="variant" transfer-ownership="none">
            <doc xml:space="preserve">a variant containing the MQL query structure</doc>
            <type name="GLib.Variant" c:type="GVariant*"/>
          </parameter>
        </parameters>
      </constructor>
      <property name="variant"
                version="0.15.1"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Variant containing the MQL query. The variant is a very generic container of type "a{smv}",
containing (possibly nested) Freebase schema types and values.</doc>
        <type name="GLib.Variant"/>
      </property>
      <field name="parent">
        <type name="Query" c:type="GDataQuery"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="FreebaseQueryPrivate" c:type="GDataFreebaseQueryPrivate*"/>
      </field>
    </class>
    <record name="FreebaseQueryClass"
            c:type="GDataFreebaseQueryClass"
            glib:is-gtype-struct-for="FreebaseQuery"
            version="0.15.1">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseQueryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="QueryClass" c:type="GDataQueryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="FreebaseQueryPrivate"
            c:type="GDataFreebaseQueryPrivate"
            disguised="1">
    </record>
    <class name="FreebaseResult"
           c:symbol-prefix="freebase_result"
           c:type="GDataFreebaseResult"
           version="0.15.1"
           parent="Entry"
           glib:type-name="GDataFreebaseResult"
           glib:get-type="gdata_freebase_result_get_type"
           glib:type-struct="FreebaseResultClass">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseResult structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_freebase_result_new"
                   version="0.15.1">
        <doc xml:space="preserve">Creates a new #GDataFreebaseResult.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataFreebaseResult; unref with g_object_unref()</doc>
          <type name="FreebaseResult" c:type="GDataFreebaseResult*"/>
        </return-value>
      </constructor>
      <method name="dup_variant"
              c:identifier="gdata_freebase_result_dup_variant"
              version="0.15.1">
        <doc xml:space="preserve">Gets the result serialized as a #GVariant of type "a{smv}", containing the JSON
data tree. This variant can be alternatively processed through json_gvariant_serialize().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the serialized result, or %NULL; unref with g_variant_unref()</doc>
          <type name="GLib.Variant" c:type="GVariant*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseResult</doc>
            <type name="FreebaseResult" c:type="GDataFreebaseResult*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="variant" version="0.15.1" transfer-ownership="none">
        <doc xml:space="preserve">Variant containing the MQL result. The variant is a very generic container of type "a{smv}",
containing (possibly nested) Freebase schema types and values.</doc>
        <type name="GLib.Variant"/>
      </property>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="FreebaseResultPrivate"
              c:type="GDataFreebaseResultPrivate*"/>
      </field>
    </class>
    <record name="FreebaseResultClass"
            c:type="GDataFreebaseResultClass"
            glib:is-gtype-struct-for="FreebaseResult"
            version="0.15.1">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseResultClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="FreebaseResultPrivate"
            c:type="GDataFreebaseResultPrivate"
            disguised="1">
    </record>
    <enumeration name="FreebaseSearchFilterType"
                 version="0.15.1"
                 glib:type-name="GDataFreebaseSearchFilterType"
                 glib:get-type="gdata_freebase_search_filter_type_get_type"
                 c:type="GDataFreebaseSearchFilterType">
      <doc xml:space="preserve">Search filter container types.</doc>
      <member name="all"
              value="0"
              c:identifier="GDATA_FREEBASE_SEARCH_FILTER_ALL"
              glib:nick="all">
        <doc xml:space="preserve">all enclosed elements must match, logically an AND</doc>
      </member>
      <member name="any"
              value="1"
              c:identifier="GDATA_FREEBASE_SEARCH_FILTER_ANY"
              glib:nick="any">
        <doc xml:space="preserve">any of the enclosed elements must match, logically an OR</doc>
      </member>
      <member name="not"
              value="2"
              c:identifier="GDATA_FREEBASE_SEARCH_FILTER_NOT"
              glib:nick="not">
        <doc xml:space="preserve">the match is inverted.</doc>
      </member>
    </enumeration>
    <class name="FreebaseSearchQuery"
           c:symbol-prefix="freebase_search_query"
           c:type="GDataFreebaseSearchQuery"
           version="0.15.1"
           parent="Query"
           glib:type-name="GDataFreebaseSearchQuery"
           glib:get-type="gdata_freebase_search_query_get_type"
           glib:type-struct="FreebaseSearchQueryClass">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseSearchQuery structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_freebase_search_query_new"
                   version="0.15.1">
        <doc xml:space="preserve">Creates a new #GDataFreebaseSearchQuery prepared to search for Freebase elements that
match the given @search_terms. Further filters on the query can be set through
gdata_freebase_search_query_add_filter() or gdata_freebase_search_query_add_location().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataFreebaseSearchQuery; unref with g_object_unref()</doc>
          <type name="FreebaseSearchQuery" c:type="GDataFreebaseSearchQuery*"/>
        </return-value>
        <parameters>
          <parameter name="search_terms" transfer-ownership="none">
            <doc xml:space="preserve">string to search for</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="add_filter"
              c:identifier="gdata_freebase_search_query_add_filter"
              version="0.15.1">
        <doc xml:space="preserve">Adds a property filter to the query. property filters are always nested in
containers, opened and closed through gdata_freebase_search_query_open_filter()
and gdata_freebase_search_query_close_filter().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchQuery</doc>
            <type name="FreebaseSearchQuery"
                  c:type="GDataFreebaseSearchQuery*"/>
          </instance-parameter>
          <parameter name="property" transfer-ownership="none">
            <doc xml:space="preserve">Freebase property ID</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">match string</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="add_location"
              c:identifier="gdata_freebase_search_query_add_location"
              version="0.15.1">
        <doc xml:space="preserve">Adds a geolocation filter to the query. location filters are always nested in
containers, opened and closed through gdata_freebase_search_query_open_filter()
and gdata_freebase_search_query_close_filter().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchQuery</doc>
            <type name="FreebaseSearchQuery"
                  c:type="GDataFreebaseSearchQuery*"/>
          </instance-parameter>
          <parameter name="radius" transfer-ownership="none">
            <doc xml:space="preserve">radius in meters</doc>
            <type name="guint64" c:type="guint64"/>
          </parameter>
          <parameter name="lat" transfer-ownership="none">
            <doc xml:space="preserve">latitude</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
          <parameter name="lon" transfer-ownership="none">
            <doc xml:space="preserve">longitude</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
        </parameters>
      </method>
      <method name="close_filter"
              c:identifier="gdata_freebase_search_query_close_filter"
              version="0.15.1">
        <doc xml:space="preserve">Closes a filter level.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchQuery</doc>
            <type name="FreebaseSearchQuery"
                  c:type="GDataFreebaseSearchQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_language"
              c:identifier="gdata_freebase_search_query_get_language"
              version="0.15.1">
        <doc xml:space="preserve">Gets the language set on the search query, or %NULL if unset.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">The language used on the query.</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchQuery</doc>
            <type name="FreebaseSearchQuery"
                  c:type="GDataFreebaseSearchQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_stemmed"
              c:identifier="gdata_freebase_search_query_get_stemmed"
              version="0.15.1">
        <doc xml:space="preserve">Returns whether the #GDataFreebaseSearchQuery will perform stemming on the search terms.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the #GDataFreebaseSearchQuery performs stemming</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchQuery</doc>
            <type name="FreebaseSearchQuery"
                  c:type="GDataFreebaseSearchQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="open_filter"
              c:identifier="gdata_freebase_search_query_open_filter"
              version="0.15.1">
        <doc xml:space="preserve">Opens a container of filter rules, those are applied according to the behavior specified by @filter_type.
Every call to this function must be paired by a call to gdata_freebase_search_query_close_filter().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchQuery</doc>
            <type name="FreebaseSearchQuery"
                  c:type="GDataFreebaseSearchQuery*"/>
          </instance-parameter>
          <parameter name="filter_type" transfer-ownership="none">
            <doc xml:space="preserve">filter type</doc>
            <type name="FreebaseSearchFilterType"
                  c:type="GDataFreebaseSearchFilterType"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_language"
              c:identifier="gdata_freebase_search_query_set_language"
              version="0.15.1">
        <doc xml:space="preserve">Sets the language used, both on the search terms and the results. If unset,
the locale preferences will be respected.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchQuery</doc>
            <type name="FreebaseSearchQuery"
                  c:type="GDataFreebaseSearchQuery*"/>
          </instance-parameter>
          <parameter name="lang"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">Language used on the search terms and results, in ISO-639-1 format, or %NULL to unset.</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_stemmed"
              c:identifier="gdata_freebase_search_query_set_stemmed"
              version="0.15.1">
        <doc xml:space="preserve">Sets whether stemming is performed on the provided search terms. If @stemmed is %TRUE,
words like eg. "natural", "naturally" or "nature" would be all reduced to the root "natur"
for search purposes.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchQuery</doc>
            <type name="FreebaseSearchQuery"
                  c:type="GDataFreebaseSearchQuery*"/>
          </instance-parameter>
          <parameter name="stemmed" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE to perform stemming on the search results</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <property name="language"
                version="0.15.1"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Language used for search results, in ISO-639-1 format.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="stemmed"
                version="0.15.1"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Whether word stemming should happen on the search terms. If this property is enabled,
words like eg. "natural", "naturally" or "nature" would be all reduced to the root "natur"
for search purposes.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <field name="parent">
        <type name="Query" c:type="GDataQuery"/>
      </field>
      <field name="priv">
        <type name="FreebaseSearchQueryPrivate"
              c:type="GDataFreebaseSearchQueryPrivate*"/>
      </field>
    </class>
    <record name="FreebaseSearchQueryClass"
            c:type="GDataFreebaseSearchQueryClass"
            glib:is-gtype-struct-for="FreebaseSearchQuery"
            version="0.15.1">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseSearchQueryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="QueryClass" c:type="GDataQueryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="FreebaseSearchQueryPrivate"
            c:type="GDataFreebaseSearchQueryPrivate"
            disguised="1">
    </record>
    <class name="FreebaseSearchResult"
           c:symbol-prefix="freebase_search_result"
           c:type="GDataFreebaseSearchResult"
           version="0.15.1"
           parent="FreebaseResult"
           glib:type-name="GDataFreebaseSearchResult"
           glib:get-type="gdata_freebase_search_result_get_type"
           glib:type-struct="FreebaseSearchResultClass">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseSearchResult structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_freebase_search_result_new"
                   version="0.15.1">
        <doc xml:space="preserve">Creates a new #GDataFreebaseSearchResult with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataFreebaseSearchResult; unref with g_object_unref()</doc>
          <type name="FreebaseSearchResult"
                c:type="GDataFreebaseSearchResult*"/>
        </return-value>
      </constructor>
      <method name="get_item"
              c:identifier="gdata_freebase_search_result_get_item"
              version="0.15.1">
        <doc xml:space="preserve">Gets an item from the search result.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a search result item, or %NULL on invalid item.</doc>
          <type name="FreebaseSearchResultItem"
                c:type="const GDataFreebaseSearchResultItem*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchResult</doc>
            <type name="FreebaseSearchResult"
                  c:type="GDataFreebaseSearchResult*"/>
          </instance-parameter>
          <parameter name="i" transfer-ownership="none">
            <doc xml:space="preserve">number of item to retrieve</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_num_items"
              c:identifier="gdata_freebase_search_result_get_num_items"
              version="0.15.1">
        <doc xml:space="preserve">Returns the number of items contained in this result.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">The number of items</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchResult</doc>
            <type name="FreebaseSearchResult"
                  c:type="GDataFreebaseSearchResult*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_total_hits"
              c:identifier="gdata_freebase_search_result_get_total_hits"
              version="0.15.1">
        <doc xml:space="preserve">Returns the total number of hits found for the search query.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the total number of hits.</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchResult</doc>
            <type name="FreebaseSearchResult"
                  c:type="GDataFreebaseSearchResult*"/>
          </instance-parameter>
        </parameters>
      </method>
      <field name="parent">
        <type name="FreebaseResult" c:type="GDataFreebaseResult"/>
      </field>
      <field name="priv">
        <type name="FreebaseSearchResultPrivate"
              c:type="GDataFreebaseSearchResultPrivate*"/>
      </field>
    </class>
    <record name="FreebaseSearchResultClass"
            c:type="GDataFreebaseSearchResultClass"
            glib:is-gtype-struct-for="FreebaseSearchResult"
            version="0.15.1">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseSearchResultClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="FreebaseResultClass" c:type="GDataFreebaseResultClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="FreebaseSearchResultItem"
            c:type="GDataFreebaseSearchResultItem"
            version="0.15.1"
            glib:type-name="GDataFreebaseSearchResultItem"
            glib:get-type="gdata_freebase_search_result_item_get_type"
            c:symbol-prefix="freebase_search_result_item">
      <doc xml:space="preserve">Opaque struct holding data for a single search result item.</doc>
      <method name="get_id"
              c:identifier="gdata_freebase_search_result_item_get_id"
              version="0.15.1">
        <doc xml:space="preserve">Returns the Freebase ID of the search result item.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">The search result item Freebase ID.</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="item" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchResultItem</doc>
            <type name="FreebaseSearchResultItem"
                  c:type="const GDataFreebaseSearchResultItem*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_language"
              c:identifier="gdata_freebase_search_result_item_get_language"
              version="0.15.1">
        <doc xml:space="preserve">Gets the language of this search result item, in ISO-639-1 format.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">The language of the search result item.</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="item" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchResultItem</doc>
            <type name="FreebaseSearchResultItem"
                  c:type="const GDataFreebaseSearchResultItem*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_mid"
              c:identifier="gdata_freebase_search_result_item_get_mid"
              version="0.15.1">
        <doc xml:space="preserve">Returns the machine-encoded ID (MID) of the search result item. Elements may
have a single MID, as opposed to the potentially multiple Freebase IDs that
may point to it. MIDs are usable interchangeably with Freebase IDs.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">The result item MID.</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="item" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchResultItem</doc>
            <type name="FreebaseSearchResultItem"
                  c:type="const GDataFreebaseSearchResultItem*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_name"
              c:identifier="gdata_freebase_search_result_item_get_name"
              version="0.15.1">
        <doc xml:space="preserve">Returns the human readable name of the search result item.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">The human readable name of the item.</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="item" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchResultItem</doc>
            <type name="FreebaseSearchResultItem"
                  c:type="const GDataFreebaseSearchResultItem*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_notable_id"
              c:identifier="gdata_freebase_search_result_item_get_notable_id"
              version="0.15.1">
        <doc xml:space="preserve">If this search result item is notable in an specific topic, this function
returns the Freebase ID of this topic.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">The topic the result item is most notable of, or %NULL.</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="item" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchResultItem</doc>
            <type name="FreebaseSearchResultItem"
                  c:type="const GDataFreebaseSearchResultItem*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_notable_name"
              c:identifier="gdata_freebase_search_result_item_get_notable_name"
              version="0.15.1">
        <doc xml:space="preserve">If this search result item is notable in an specific topic, this function
returns the human readable name of this topic.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">The human readable topic name, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="item" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchResultItem</doc>
            <type name="FreebaseSearchResultItem"
                  c:type="const GDataFreebaseSearchResultItem*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_score"
              c:identifier="gdata_freebase_search_result_item_get_score"
              version="0.15.1">
        <doc xml:space="preserve">Returns the score of this search result item. The higher, the more relevant this
item seems, given the search terms.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the result item score.</doc>
          <type name="gdouble" c:type="gdouble"/>
        </return-value>
        <parameters>
          <instance-parameter name="item" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchResultItem</doc>
            <type name="FreebaseSearchResultItem"
                  c:type="const GDataFreebaseSearchResultItem*"/>
          </instance-parameter>
        </parameters>
      </method>
    </record>
    <record name="FreebaseSearchResultPrivate"
            c:type="GDataFreebaseSearchResultPrivate"
            disguised="1">
    </record>
    <class name="FreebaseService"
           c:symbol-prefix="freebase_service"
           c:type="GDataFreebaseService"
           version="0.15.1"
           parent="Service"
           glib:type-name="GDataFreebaseService"
           glib:get-type="gdata_freebase_service_get_type"
           glib:type-struct="FreebaseServiceClass">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseService structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_freebase_service_new"
                   version="0.15.1">
        <doc xml:space="preserve">Creates a new #GDataFreebaseService using the given #GDataAuthorizer. If @authorizer is %NULL, all requests are made as an unauthenticated user.
Having both @developer_key and @authorizer set to %NULL is allowed, but this should be reserved for debugging situations, as there is a certain
key-less quota for those purposes. If this service is used on any code intended to be deployed, one or both of @developer_key and @authorizer
should be non-%NULL and valid.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataFreebaseService; unref with g_object_unref()</doc>
          <type name="FreebaseService" c:type="GDataFreebaseService*"/>
        </return-value>
        <parameters>
          <parameter name="developer_key"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">developer key to use the API, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="authorizer"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataAuthorizer to authorize the service's requests, or %NULL</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </parameter>
        </parameters>
      </constructor>
      <function name="get_primary_authorization_domain"
                c:identifier="gdata_freebase_service_get_primary_authorization_domain"
                version="0.9.0">
        <doc xml:space="preserve">The primary #GDataAuthorizationDomain for interacting with Freebase. This will not normally need to be used, as it's used internally
by the #GDataFreebaseService methods. However, if using the plain #GDataService methods to implement custom queries or requests which libgdata
does not support natively, then this domain may be needed to authorize the requests.

The domain never changes, and is interned so that pointer comparison can be used to differentiate it from other authorization domains.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the service's authorization domain</doc>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
      </function>
      <method name="get_image"
              c:identifier="gdata_freebase_service_get_image"
              version="0.15.1"
              throws="1">
        <doc xml:space="preserve">Creates an input stream to an image object returned in a topic query. If @max_width and @max_height
are unspecified (i.e. set to 0), the image returned will be the smallest available.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GInputStream opened to the image; unref with g_object_unref()</doc>
          <type name="Gio.InputStream" c:type="GInputStream*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseService</doc>
            <type name="FreebaseService" c:type="GDataFreebaseService*"/>
          </instance-parameter>
          <parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue from a topic result</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="max_width" transfer-ownership="none">
            <doc xml:space="preserve">maximum width of the image returned, or 0</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="max_height" transfer-ownership="none">
            <doc xml:space="preserve">maximum height of the image returned, or 0</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_topic"
              c:identifier="gdata_freebase_service_get_topic"
              version="0.15.1"
              throws="1">
        <doc xml:space="preserve">Queries information about a topic, identified through a Freebase ID. You can find out more about topic queries in the
&lt;ulink type="http" url="https://developers.google.com/freebase/v1/topic-response"&gt;online documentation&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFreebaseTopicResult containing information about the topic; unref with g_object_unref()</doc>
          <type name="FreebaseTopicResult" c:type="GDataFreebaseTopicResult*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseService</doc>
            <type name="FreebaseService" c:type="GDataFreebaseService*"/>
          </instance-parameter>
          <parameter name="query" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicQuery containing the topic ID</doc>
            <type name="FreebaseTopicQuery" c:type="GDataFreebaseTopicQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_topic_async"
              c:identifier="gdata_freebase_service_get_topic_async"
              version="0.15.1">
        <doc xml:space="preserve">Queries information about a topic, identified through a Freebase ID. @self and @query are all reffed when this
function is called, so can safely be unreffed after this function returns. When the query is replied, or fails,
@callback will be executed, and the result can be obtained through gdata_service_query_single_entry_finish().

For more details, see gdata_freebase_service_get_topic(), which is the synchronous version of
this function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseService</doc>
            <type name="FreebaseService" c:type="GDataFreebaseService*"/>
          </instance-parameter>
          <parameter name="query" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseQuery with the MQL query</doc>
            <type name="FreebaseTopicQuery" c:type="GDataFreebaseTopicQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authentication is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query"
              c:identifier="gdata_freebase_service_query"
              version="0.15.1"
              throws="1">
        <doc xml:space="preserve">Performs a MQL query on the service, you can find out more about MQL in the &lt;ulink type="http" url="http://mql.freebaseapps.com/index.html"&gt;online MQL documentation&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFreebaseResult containing the query result; unref with g_object_unref()</doc>
          <type name="FreebaseResult" c:type="GDataFreebaseResult*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseService</doc>
            <type name="FreebaseService" c:type="GDataFreebaseService*"/>
          </instance-parameter>
          <parameter name="query" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseQuery with the MQL query</doc>
            <type name="FreebaseQuery" c:type="GDataFreebaseQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_async"
              c:identifier="gdata_freebase_service_query_async"
              version="0.15.1">
        <doc xml:space="preserve">Performs a MQL query on the service. @self and @query are all reffed when this function is called, so can safely
be unreffed after this function returns. When the query is replied, or fails, @callback will be executed, and
the result can be obtained through gdata_service_query_single_entry_finish().

For more details, see gdata_freebase_service_query(), which is the synchronous version of
this function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseService</doc>
            <type name="FreebaseService" c:type="GDataFreebaseService*"/>
          </instance-parameter>
          <parameter name="query" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseQuery with the MQL query</doc>
            <type name="FreebaseQuery" c:type="GDataFreebaseQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authentication is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="search"
              c:identifier="gdata_freebase_service_search"
              version="0.15.1"
              throws="1">
        <doc xml:space="preserve">Performs a search for any given search term, filters can be set on @query to narrow down the results. The results returned
are ordered by relevance. You can find out more about topic queries in the
&lt;ulink type="http" url="https://developers.google.com/freebase/v1/search-cookbook"&gt;online documentation&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFreebaseSearchResult containing the results for the given search query; unref with g_object_unref()</doc>
          <type name="FreebaseSearchResult"
                c:type="GDataFreebaseSearchResult*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseService</doc>
            <type name="FreebaseService" c:type="GDataFreebaseService*"/>
          </instance-parameter>
          <parameter name="query" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseSearchQuery containing the topic ID</doc>
            <type name="FreebaseSearchQuery"
                  c:type="GDataFreebaseSearchQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="search_async"
              c:identifier="gdata_freebase_service_search_async"
              version="0.15.1">
        <doc xml:space="preserve">Performs a search for any given search term. @self and @query are all reffed when this
function is called, so can safely be unreffed after this function returns.

For more details, see gdata_freebase_service_search(), which is the synchronous version of
this function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseService</doc>
            <type name="FreebaseService" c:type="GDataFreebaseService*"/>
          </instance-parameter>
          <parameter name="query" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseQuery with the MQL query</doc>
            <type name="FreebaseSearchQuery"
                  c:type="GDataFreebaseSearchQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authentication is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <property name="developer-key"
                version="0.15.1"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The developer key your application has registered with the Freebase API. For more information, see the &lt;ulink type="http"
url="https://developers.google.com/freebase/v1/how-tos/authorizing"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Service" c:type="GDataService"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="FreebaseServicePrivate"
              c:type="GDataFreebaseServicePrivate*"/>
      </field>
    </class>
    <record name="FreebaseServiceClass"
            c:type="GDataFreebaseServiceClass"
            glib:is-gtype-struct-for="FreebaseService"
            version="0.15.1">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseServiceClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ServiceClass" c:type="GDataServiceClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="FreebaseServicePrivate"
            c:type="GDataFreebaseServicePrivate"
            disguised="1">
    </record>
    <record name="FreebaseTopicObject"
            c:type="GDataFreebaseTopicObject"
            version="0.15.1"
            glib:type-name="GDataFreebaseTopicObject"
            glib:get-type="gdata_freebase_topic_object_get_type"
            c:symbol-prefix="freebase_topic_object">
      <doc xml:space="preserve">Opaque struct containing a Freebase topic object. This object may contain one or more
#GDataFreebaseTopicValue structs, which may in turn contain nested #GDataFreebaseTopicObject
structs to express complex data.</doc>
      <method name="get_id"
              c:identifier="gdata_freebase_topic_object_get_id"
              version="0.15.1">
        <doc xml:space="preserve">Gets the Freebase ID for this specific object.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the Freebase ID of this object</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="object" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicObject</doc>
            <type name="FreebaseTopicObject"
                  c:type="const GDataFreebaseTopicObject*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_property_count"
              c:identifier="gdata_freebase_topic_object_get_property_count"
              version="0.15.1">
        <doc xml:space="preserve">Returns the number of values that @object holds for the given @property. If @object
contains no information about @property, 0 is returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">The number of values contained for @property</doc>
          <type name="guint64" c:type="guint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="object" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicObject</doc>
            <type name="FreebaseTopicObject"
                  c:type="const GDataFreebaseTopicObject*"/>
          </instance-parameter>
          <parameter name="property" transfer-ownership="none">
            <doc xml:space="preserve">a property name contained in @object</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_property_hits"
              c:identifier="gdata_freebase_topic_object_get_property_hits"
              version="0.15.1">
        <doc xml:space="preserve">Returns the total number of hits that the Freebase database stores
for this object, this number either equals or is greater than
gdata_freebase_topic_object_get_property_count(), the query limit
can be controlled through gdata_query_set_max_results() on the topic
query.

If @object contains no information about @property, 0 is returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the total number of hits for this property</doc>
          <type name="guint64" c:type="guint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="object" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicObject</doc>
            <type name="FreebaseTopicObject"
                  c:type="const GDataFreebaseTopicObject*"/>
          </instance-parameter>
          <parameter name="property" transfer-ownership="none">
            <doc xml:space="preserve">a property name contained in @object</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_property_value"
              c:identifier="gdata_freebase_topic_object_get_property_value"
              version="0.15.1">
        <doc xml:space="preserve">Gets the value that @object stores for this @property/@item pair, as a generic
#GDataFreebaseTopicValue. If @object contains no information about @property,
or @item is outside the [0..gdata_freebase_topic_object_get_property_count() - 1]
range, %NULL is returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the value for this property/item</doc>
          <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
        </return-value>
        <parameters>
          <instance-parameter name="object" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicObject</doc>
            <type name="FreebaseTopicObject"
                  c:type="const GDataFreebaseTopicObject*"/>
          </instance-parameter>
          <parameter name="property" transfer-ownership="none">
            <doc xml:space="preserve">a property name contained in @object</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="item" transfer-ownership="none">
            <doc xml:space="preserve">item number to retrieve from @property</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="list_properties"
              c:identifier="gdata_freebase_topic_object_list_properties"
              version="0.15.1">
        <doc xml:space="preserve">Returns the list of Freebase properties described by @object.</doc>
        <return-value transfer-ownership="container">
          <doc xml:space="preserve">An array of property names, free with g_ptr_array_unref().</doc>
          <array name="GLib.PtrArray" c:type="GPtrArray*">
            <type name="utf8"/>
          </array>
        </return-value>
        <parameters>
          <instance-parameter name="object" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicObject</doc>
            <type name="FreebaseTopicObject"
                  c:type="const GDataFreebaseTopicObject*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="ref"
              c:identifier="gdata_freebase_topic_object_ref"
              version="0.15.1">
        <doc xml:space="preserve">Creates and returns a new reference on @object.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">@object, with an extra reference.</doc>
          <type name="FreebaseTopicObject" c:type="GDataFreebaseTopicObject*"/>
        </return-value>
        <parameters>
          <instance-parameter name="object" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicObject</doc>
            <type name="FreebaseTopicObject"
                  c:type="GDataFreebaseTopicObject*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="unref"
              c:identifier="gdata_freebase_topic_object_unref"
              version="0.15.1">
        <doc xml:space="preserve">Removes a reference from @object. If the reference count drops to 0,
the object is freed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="object" transfer-ownership="full">
            <doc xml:space="preserve">a #GDataFreebaseTopicResult</doc>
            <type name="FreebaseTopicObject"
                  c:type="GDataFreebaseTopicObject*"/>
          </instance-parameter>
        </parameters>
      </method>
    </record>
    <class name="FreebaseTopicQuery"
           c:symbol-prefix="freebase_topic_query"
           c:type="GDataFreebaseTopicQuery"
           version="0.15.1"
           parent="Query"
           glib:type-name="GDataFreebaseTopicQuery"
           glib:get-type="gdata_freebase_topic_query_get_type"
           glib:type-struct="FreebaseTopicQueryClass">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseTopicQuery structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_freebase_topic_query_new"
                   version="0.15.1">
        <doc xml:space="preserve">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.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataFreebaseTopicQuery</doc>
          <type name="FreebaseTopicQuery" c:type="GDataFreebaseTopicQuery*"/>
        </return-value>
        <parameters>
          <parameter name="id" transfer-ownership="none">
            <doc xml:space="preserve">a Freebase ID or MID</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_filter"
              c:identifier="gdata_freebase_topic_query_get_filter"
              version="0.15.1">
        <doc xml:space="preserve">Gets the filter set on the topic query, or %NULL if unset.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">The filter used on the query.</doc>
          <array c:type="gchar**">
            <type name="utf8"/>
          </array>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicQuery</doc>
            <type name="FreebaseTopicQuery" c:type="GDataFreebaseTopicQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_language"
              c:identifier="gdata_freebase_topic_query_get_language"
              version="0.15.1">
        <doc xml:space="preserve">Gets the language set on the topic query, or %NULL if unset.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">The language used on the query.</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicQuery</doc>
            <type name="FreebaseTopicQuery" c:type="GDataFreebaseTopicQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_filter"
              c:identifier="gdata_freebase_topic_query_set_filter"
              version="0.15.1">
        <doc xml:space="preserve">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 &lt;ulink type="http" url="https://developers.google.com/freebase/v1/topic-overview#filter"&gt;Topic API overview&lt;/ulink&gt;

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.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicQuery</doc>
            <type name="FreebaseTopicQuery" c:type="GDataFreebaseTopicQuery*"/>
          </instance-parameter>
          <parameter name="filter"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">%NULL-terminated array of filter strings, or %NULL to unset</doc>
            <array c:type="gchar**">
              <type name="utf8" c:type="gchar*"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="set_language"
              c:identifier="gdata_freebase_topic_query_set_language"
              version="0.15.1">
        <doc xml:space="preserve">Sets the language used in the topic query. If unset,
the locale preferences will be respected.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicQuery</doc>
            <type name="FreebaseTopicQuery" c:type="GDataFreebaseTopicQuery*"/>
          </instance-parameter>
          <parameter name="lang"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">language used on the topic query, in ISO-639-1 format, or %NULL to unset the language</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="filter"
                version="0.15.1"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">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.</doc>
        <array>
          <type name="utf8"/>
        </array>
      </property>
      <property name="language"
                version="0.15.1"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Language used for topic values in the result, in ISO-639-1 format.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Query" c:type="GDataQuery"/>
      </field>
      <field name="priv">
        <type name="FreebaseTopicQueryPrivate"
              c:type="GDataFreebaseTopicQueryPrivate*"/>
      </field>
    </class>
    <record name="FreebaseTopicQueryClass"
            c:type="GDataFreebaseTopicQueryClass"
            glib:is-gtype-struct-for="FreebaseTopicQuery"
            version="0.15.1">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseTopicQueryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="QueryClass" c:type="GDataQueryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="FreebaseTopicQueryPrivate"
            c:type="GDataFreebaseTopicQueryPrivate"
            disguised="1">
    </record>
    <class name="FreebaseTopicResult"
           c:symbol-prefix="freebase_topic_result"
           c:type="GDataFreebaseTopicResult"
           version="0.15.1"
           parent="FreebaseResult"
           glib:type-name="GDataFreebaseTopicResult"
           glib:get-type="gdata_freebase_topic_result_get_type"
           glib:type-struct="FreebaseTopicResultClass">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseTopicResult structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_freebase_topic_result_new"
                   version="0.15.1">
        <doc xml:space="preserve">Creates a new #GDataFreebaseTopicResult with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataFreebaseTopicResult; unref with g_object_unref()</doc>
          <type name="FreebaseTopicResult" c:type="GDataFreebaseTopicResult*"/>
        </return-value>
      </constructor>
      <method name="dup_object"
              c:identifier="gdata_freebase_topic_result_dup_object"
              version="0.15.1">
        <doc xml:space="preserve">Returns a reference to the root #GDataFreebaseTopicObject containing the
topic query results.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">A new reference on the result object, unref with
  gdata_freebase_topic_object_unref()</doc>
          <type name="FreebaseTopicObject" c:type="GDataFreebaseTopicObject*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicResult</doc>
            <type name="FreebaseTopicResult"
                  c:type="GDataFreebaseTopicResult*"/>
          </instance-parameter>
        </parameters>
      </method>
      <field name="parent">
        <type name="FreebaseResult" c:type="GDataFreebaseResult"/>
      </field>
      <field name="priv">
        <type name="FreebaseTopicResultPrivate"
              c:type="GDataFreebaseTopicResultPrivate*"/>
      </field>
    </class>
    <record name="FreebaseTopicResultClass"
            c:type="GDataFreebaseTopicResultClass"
            glib:is-gtype-struct-for="FreebaseTopicResult"
            version="0.15.1">
      <doc xml:space="preserve">All the fields in the #GDataFreebaseTopicResultClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="FreebaseResultClass" c:type="GDataFreebaseResultClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="FreebaseTopicResultPrivate"
            c:type="GDataFreebaseTopicResultPrivate"
            disguised="1">
    </record>
    <record name="FreebaseTopicValue"
            c:type="GDataFreebaseTopicValue"
            version="0.15.1"
            glib:type-name="GDataFreebaseTopicValue"
            glib:get-type="gdata_freebase_topic_value_get_type"
            c:symbol-prefix="freebase_topic_value">
      <doc xml:space="preserve">Opaque struct containing a value of a Freebase topic object. This struct may contain a simple
value (integers, doubles, strings...) or complex values, expressed through a #GDataFreebaseTopicObject.</doc>
      <method name="copy_value"
              c:identifier="gdata_freebase_topic_value_copy_value"
              version="0.15.1">
        <doc xml:space="preserve">Copies in @gvalue the value held in @value. the #GValue must be later freed through g_value_unset()</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
          <parameter name="gvalue"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="full">
            <doc xml:space="preserve">an empty #GValue</doc>
            <type name="GObject.Value" c:type="GValue*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_creator"
              c:identifier="gdata_freebase_topic_value_get_creator"
              version="0.15.1">
        <doc xml:space="preserve">Returns the Freebase ID of the user that created this value.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the creator of this value, as a Freebase ID</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_double"
              c:identifier="gdata_freebase_topic_value_get_double"
              version="0.15.1">
        <doc xml:space="preserve">Returns a #gdouble value held in @value. It is only valid to call this if the #GType is a %G_TYPE_DOUBLE</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #gdouble value</doc>
          <type name="gdouble" c:type="gdouble"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_int"
              c:identifier="gdata_freebase_topic_value_get_int"
              version="0.15.1">
        <doc xml:space="preserve">Returns a #gint64 value held in @value. It is only valid to call this if the #GType is a %G_TYPE_INT64</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #gint64 value</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_language"
              c:identifier="gdata_freebase_topic_value_get_language"
              version="0.15.1">
        <doc xml:space="preserve">Returns the language used in the content of @value</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the language @value is written in</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_object"
              c:identifier="gdata_freebase_topic_value_get_object"
              version="0.15.1">
        <doc xml:space="preserve">Returns a compound/complex object held in @value. It is only valid to call this if the #GType is a
%GDATA_TYPE_FREEBASE_TOPIC_OBJECT.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the compound value as a #GDataFreebaseTopicObject</doc>
          <type name="FreebaseTopicObject"
                c:type="const GDataFreebaseTopicObject*"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_property"
              c:identifier="gdata_freebase_topic_value_get_property"
              version="0.15.1">
        <doc xml:space="preserve">Returns the property name that this value describes</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the property name of @value</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_string"
              c:identifier="gdata_freebase_topic_value_get_string"
              version="0.15.1">
        <doc xml:space="preserve">Returns a string value held in @value. It is only valid to call this if the #GType is a %G_TYPE_STRING</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the string value</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_text"
              c:identifier="gdata_freebase_topic_value_get_text"
              version="0.15.1">
        <doc xml:space="preserve">Returns a textual representation of this value, this is either
the value contained transformed to a string, or a concatenation
of subvalues for compound types.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a textual representation of @value</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_timestamp"
              c:identifier="gdata_freebase_topic_value_get_timestamp"
              version="0.15.1">
        <doc xml:space="preserve">Returns the time at which this value was created in the Freebase database.
It's a UNIX timestamp in seconds since the epoch. If @value has no timestamp,
-1 will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">The creation time of @value, or -1</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">#GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_value_type"
              c:identifier="gdata_freebase_topic_value_get_value_type"
              version="0.15.1">
        <doc xml:space="preserve">Returns the #GType of the real value held in @value.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #GType of the contained value</doc>
          <type name="GType" c:type="GType"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_image"
              c:identifier="gdata_freebase_topic_value_is_image"
              version="0.15.1">
        <doc xml:space="preserve">Returns true if @value holds a freebase image object, on such values it
will be valid to call gdata_freebase_service_get_image() to get a stream
to the image itself.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">Whether @value holds a Freebase image object</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="ref"
              c:identifier="gdata_freebase_topic_value_ref"
              version="0.15.1">
        <doc xml:space="preserve">Creates and returns a new reference on @value.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">@value, with an extra reference.</doc>
          <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="unref"
              c:identifier="gdata_freebase_topic_value_unref"
              version="0.15.1">
        <doc xml:space="preserve">Removes a reference from @value. If the reference count drops to 0,
the object is freed.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="value" transfer-ownership="full">
            <doc xml:space="preserve">a #GDataFreebaseTopicValue</doc>
            <type name="FreebaseTopicValue" c:type="GDataFreebaseTopicValue*"/>
          </instance-parameter>
        </parameters>
      </method>
    </record>
    <constant name="GCONTACT_CALENDAR_FREE_BUSY"
              value="free-busy"
              c:type="GDATA_GCONTACT_CALENDAR_FREE_BUSY"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's free/busy calendar.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcCalendarLink"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_CALENDAR_HOME"
              value="home"
              c:type="GDATA_GCONTACT_CALENDAR_HOME"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's home calendar.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcCalendarLink"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_CALENDAR_WORK"
              value="work"
              c:type="GDATA_GCONTACT_CALENDAR_WORK"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's work calendar.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcCalendarLink"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_EVENT_ANNIVERSARY"
              value="anniversary"
              c:type="GDATA_GCONTACT_EVENT_ANNIVERSARY"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for an anniversary event.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcEvent"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_EVENT_OTHER"
              value="other"
              c:type="GDATA_GCONTACT_EVENT_OTHER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a miscellaneous event.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcEvent"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_EXTERNAL_ID_ACCOUNT"
              value="account"
              c:type="GDATA_GCONTACT_EXTERNAL_ID_ACCOUNT"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for an account number identifier.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcExternalId"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_EXTERNAL_ID_CUSTOMER"
              value="customer"
              c:type="GDATA_GCONTACT_EXTERNAL_ID_CUSTOMER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a customer identifier.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcExternalId"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_EXTERNAL_ID_NETWORK"
              value="network"
              c:type="GDATA_GCONTACT_EXTERNAL_ID_NETWORK"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a network identifier.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcExternalId"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_EXTERNAL_ID_ORGANIZATION"
              value="organization"
              c:type="GDATA_GCONTACT_EXTERNAL_ID_ORGANIZATION"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for an identifier related to an organization the contact is associated with.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcExternalId"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_JOT_HOME"
              value="home"
              c:type="GDATA_GCONTACT_JOT_HOME"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a jot about a contact's home.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcJot"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_JOT_KEYWORDS"
              value="keywords"
              c:type="GDATA_GCONTACT_JOT_KEYWORDS"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a jot with keywords about a contact.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcJot"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_JOT_OTHER"
              value="other"
              c:type="GDATA_GCONTACT_JOT_OTHER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a jot about an other facet of a contact.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcJot"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_JOT_USER"
              value="user"
              c:type="GDATA_GCONTACT_JOT_USER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a jot about the relationship between a contact and the user.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcJot"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_JOT_WORK"
              value="work"
              c:type="GDATA_GCONTACT_JOT_WORK"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a jot about a contact's work.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcJot"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_ASSISTANT"
              value="assistant"
              c:type="GDATA_GCONTACT_RELATION_ASSISTANT"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's assistant.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_BROTHER"
              value="brother"
              c:type="GDATA_GCONTACT_RELATION_BROTHER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's brother.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_CHILD"
              value="child"
              c:type="GDATA_GCONTACT_RELATION_CHILD"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's child.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_DOMESTIC_PARTNER"
              value="domestic-partner"
              c:type="GDATA_GCONTACT_RELATION_DOMESTIC_PARTNER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's domestic partner.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_FATHER"
              value="father"
              c:type="GDATA_GCONTACT_RELATION_FATHER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's father.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_FRIEND"
              value="friend"
              c:type="GDATA_GCONTACT_RELATION_FRIEND"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's friend.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_MANAGER"
              value="manager"
              c:type="GDATA_GCONTACT_RELATION_MANAGER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's manager.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_MOTHER"
              value="mother"
              c:type="GDATA_GCONTACT_RELATION_MOTHER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's mother.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_PARENT"
              value="parent"
              c:type="GDATA_GCONTACT_RELATION_PARENT"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's parent.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_PARTNER"
              value="partner"
              c:type="GDATA_GCONTACT_RELATION_PARTNER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's business partner.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_REFERRER"
              value="referred-by"
              c:type="GDATA_GCONTACT_RELATION_REFERRER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's referrer.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_RELATIVE"
              value="relative"
              c:type="GDATA_GCONTACT_RELATION_RELATIVE"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's (general) family relative.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_SISTER"
              value="sister"
              c:type="GDATA_GCONTACT_RELATION_SISTER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's sister.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_RELATION_SPOUSE"
              value="spouse"
              c:type="GDATA_GCONTACT_RELATION_SPOUSE"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's spouse.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_WEBSITE_BLOG"
              value="blog"
              c:type="GDATA_GCONTACT_WEBSITE_BLOG"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's blog.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcWebsite"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_WEBSITE_FTP"
              value="ftp"
              c:type="GDATA_GCONTACT_WEBSITE_FTP"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's FTP site.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcWebsite"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_WEBSITE_HOME"
              value="home"
              c:type="GDATA_GCONTACT_WEBSITE_HOME"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's home website.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcWebsite"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_WEBSITE_HOME_PAGE"
              value="home-page"
              c:type="GDATA_GCONTACT_WEBSITE_HOME_PAGE"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's home page.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcWebsite"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_WEBSITE_OTHER"
              value="other"
              c:type="GDATA_GCONTACT_WEBSITE_OTHER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a miscellaneous website of the contact.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcWebsite"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_WEBSITE_PROFILE"
              value="profile"
              c:type="GDATA_GCONTACT_WEBSITE_PROFILE"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's online profile.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcWebsite"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GCONTACT_WEBSITE_WORK"
              value="work"
              c:type="GDATA_GCONTACT_WEBSITE_WORK"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a contact's work website.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcWebsite"&gt;
gContact specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <class name="GContactCalendar"
           c:symbol-prefix="gcontact_calendar"
           c:type="GDataGContactCalendar"
           version="0.7.0"
           parent="Parsable"
           glib:type-name="GDataGContactCalendar"
           glib:get-type="gdata_gcontact_calendar_get_type"
           glib:type-struct="GContactCalendarClass">
      <doc xml:space="preserve">All the fields in the #GDataGContactCalendar structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new"
                   c:identifier="gdata_gcontact_calendar_new"
                   version="0.7.0">
        <doc xml:space="preserve">Creates a new #GDataGContactCalendar. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcCalendarLink"&gt;gContact specification&lt;/ulink&gt;.

Exactly one of @relation_type and @label should be provided; the other must be %NULL.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGContactCalendar; unref with g_object_unref()</doc>
          <type name="GContactCalendar" c:type="GDataGContactCalendar*"/>
        </return-value>
        <parameters>
          <parameter name="uri" transfer-ownership="none">
            <doc xml:space="preserve">the URI of the calendar</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the type of calendar, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a free-form label for the calendar, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this calendar is its owner's primary calendar, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_label"
              c:identifier="gdata_gcontact_calendar_get_label"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactCalendar:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a free-form label for the calendar, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactCalendar</doc>
            <type name="GContactCalendar" c:type="GDataGContactCalendar*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gcontact_calendar_get_relation_type"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactCalendar:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the type of the relation, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactCalendar</doc>
            <type name="GContactCalendar" c:type="GDataGContactCalendar*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_uri"
              c:identifier="gdata_gcontact_calendar_get_uri"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactCalendar:uri property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the calendar's URI</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactCalendar</doc>
            <type name="GContactCalendar" c:type="GDataGContactCalendar*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_primary"
              c:identifier="gdata_gcontact_calendar_is_primary"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactCalendar:is-primary property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if this is the contact's primary calendar, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactCalendar</doc>
            <type name="GContactCalendar" c:type="GDataGContactCalendar*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_is_primary"
              c:identifier="gdata_gcontact_calendar_set_is_primary"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactCalendar:is-primary property to @is_primary.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactCalendar</doc>
            <type name="GContactCalendar" c:type="GDataGContactCalendar*"/>
          </instance-parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this is the contact's primary calendar, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_gcontact_calendar_set_label"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactCalendar:label property to @label.

If @label is %NULL, the label will be unset. When the #GDataGContactCalendar is used in a query, however,
exactly one of #GDataGContactCalendar:relation-type and #GDataGContactCalendar:label must be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactCalendar</doc>
            <type name="GContactCalendar" c:type="GDataGContactCalendar*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new free-form label for the calendar, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gcontact_calendar_set_relation_type"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactCalendar:relation-type property to @relation_type,
such as %GDATA_GCONTACT_CALENDAR_HOME or %GDATA_GCONTACT_CALENDAR_FREE_BUSY.

If @relation_type is %NULL, the relation type will be unset. When the #GDataGContactCalendar is used in a query, however,
exactly one of #GDataGContactCalendar:relation-type and #GDataGContactCalendar:label must be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactCalendar</doc>
            <type name="GContactCalendar" c:type="GDataGContactCalendar*"/>
          </instance-parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new type for the calendar, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_uri"
              c:identifier="gdata_gcontact_calendar_set_uri"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactCalendar:uri property to @uri.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactCalendar</doc>
            <type name="GContactCalendar" c:type="GDataGContactCalendar*"/>
          </instance-parameter>
          <parameter name="uri" transfer-ownership="none">
            <doc xml:space="preserve">the new URI for the calendar</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="is-primary"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates which calendar out of a group is primary.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcCalendarLink"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="label"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A free-form string that identifies the type of calendar. It is mutually exclusive with #GDataGContactCalendar:relation-type.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcCalendarLink"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A programmatic value that identifies the type of calendar. It is mutually exclusive with #GDataGContactCalendar:label.
Examples are %GDATA_GCONTACT_CALENDAR_HOME or %GDATA_GCONTACT_CALENDAR_FREE_BUSY.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcCalendarLink"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="uri"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The URI of the calendar.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcCalendarLink"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GContactCalendarPrivate"
              c:type="GDataGContactCalendarPrivate*"/>
      </field>
    </class>
    <record name="GContactCalendarClass"
            c:type="GDataGContactCalendarClass"
            glib:is-gtype-struct-for="GContactCalendar"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataGContactCalendarClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GContactCalendarPrivate"
            c:type="GDataGContactCalendarPrivate"
            disguised="1">
    </record>
    <class name="GContactEvent"
           c:symbol-prefix="gcontact_event"
           c:type="GDataGContactEvent"
           version="0.7.0"
           parent="Parsable"
           glib:type-name="GDataGContactEvent"
           glib:get-type="gdata_gcontact_event_get_type"
           glib:type-struct="GContactEventClass">
      <doc xml:space="preserve">All the fields in the #GDataGContactEvent structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_gcontact_event_new"
                   version="0.7.0">
        <doc xml:space="preserve">Creates a new #GDataGContactEvent. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcEvent"&gt;gContact specification&lt;/ulink&gt;.

Exactly one of @relation_type and @label should be provided; the other must be %NULL.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGContactEvent; unref with g_object_unref()</doc>
          <type name="GContactEvent" c:type="GDataGContactEvent*"/>
        </return-value>
        <parameters>
          <parameter name="date" transfer-ownership="none">
            <doc xml:space="preserve">the date of the event</doc>
            <type name="GLib.Date" c:type="const GDate*"/>
          </parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the relationship between the event and its owner, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a human-readable label for the event, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_date"
              c:identifier="gdata_gcontact_event_get_date"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactEvent:date property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactEvent</doc>
            <type name="GContactEvent" c:type="GDataGContactEvent*"/>
          </instance-parameter>
          <parameter name="date"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none">
            <doc xml:space="preserve">return location for the date of the event</doc>
            <type name="GLib.Date" c:type="GDate*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_label"
              c:identifier="gdata_gcontact_event_get_label"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactEvent:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the event's label, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactEvent</doc>
            <type name="GContactEvent" c:type="GDataGContactEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gcontact_event_get_relation_type"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactEvent:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the event's relation type, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactEvent</doc>
            <type name="GContactEvent" c:type="GDataGContactEvent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_date"
              c:identifier="gdata_gcontact_event_set_date"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactEvent:date property to @date.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactEvent</doc>
            <type name="GContactEvent" c:type="GDataGContactEvent*"/>
          </instance-parameter>
          <parameter name="date" transfer-ownership="none">
            <doc xml:space="preserve">the new date for the event</doc>
            <type name="GLib.Date" c:type="const GDate*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_gcontact_event_set_label"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactEvent:label property to @label.

If @label is %NULL, the label will be unset. When the #GDataGContactEvent is used in a query, however,
exactly one of #GDataGContactEvent:relation-type and #GDataGContactEvent:label must be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactEvent</doc>
            <type name="GContactEvent" c:type="GDataGContactEvent*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new label for the event, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gcontact_event_set_relation_type"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactEvent:relation-type property to @relation_type
such as %GDATA_GCONTACT_EVENT_ANNIVERSARY or %GDATA_GCONTACT_EVENT_OTHER.

If @relation_type is %NULL, the relation type will be unset. When the #GDataGContactEvent is used in a query, however,
exactly one of #GDataGContactEvent:relation-type and #GDataGContactEvent:label must be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactEvent</doc>
            <type name="GContactEvent" c:type="GDataGContactEvent*"/>
          </instance-parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new relation type for the event, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="date"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The date of the event.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcEvent"&gt;GContact specification&lt;/ulink&gt;.</doc>
        <type name="GLib.Date"/>
      </property>
      <property name="label"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A simple string value used to name this event. It is mutually exclusive with #GDataGContactEvent:relation-type.
It allows UIs to display a label such as "Wedding anniversary".

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcEvent"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A programmatic value that identifies the type of event. It is mutually exclusive with #GDataGContactEvent:label.
Examples are %GDATA_GCONTACT_EVENT_ANNIVERSARY or %GDATA_GCONTACT_EVENT_OTHER.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcEvent"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GContactEventPrivate" c:type="GDataGContactEventPrivate*"/>
      </field>
    </class>
    <record name="GContactEventClass"
            c:type="GDataGContactEventClass"
            glib:is-gtype-struct-for="GContactEvent"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataGContactEventClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GContactEventPrivate"
            c:type="GDataGContactEventPrivate"
            disguised="1">
    </record>
    <class name="GContactExternalID"
           c:symbol-prefix="gcontact_external_id"
           c:type="GDataGContactExternalID"
           version="0.7.0"
           parent="Parsable"
           glib:type-name="GDataGContactExternalID"
           glib:get-type="gdata_gcontact_external_id_get_type"
           glib:type-struct="GContactExternalIDClass">
      <doc xml:space="preserve">All the fields in the #GDataGContactExternalID structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new"
                   c:identifier="gdata_gcontact_external_id_new"
                   version="0.7.0">
        <doc xml:space="preserve">Creates a new #GDataGContactExternalID. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcExternalId"&gt;gContact specification&lt;/ulink&gt;.

Exactly one of @relation_type and @label should be provided; the other must be %NULL.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGContactExternalID; unref with g_object_unref()</doc>
          <type name="GContactExternalID" c:type="GDataGContactExternalID*"/>
        </return-value>
        <parameters>
          <parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">the value of the external ID</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the type of external ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a free-form label for the external ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_label"
              c:identifier="gdata_gcontact_external_id_get_label"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactExternalID:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a free-form label for the external ID, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactExternalID</doc>
            <type name="GContactExternalID" c:type="GDataGContactExternalID*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gcontact_external_id_get_relation_type"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactExternalID:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the type of the relation, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactExternalID</doc>
            <type name="GContactExternalID" c:type="GDataGContactExternalID*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_value"
              c:identifier="gdata_gcontact_external_id_get_value"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactExternalID:value property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the external ID's value</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactExternalID</doc>
            <type name="GContactExternalID" c:type="GDataGContactExternalID*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_gcontact_external_id_set_label"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactExternalID:label property to @label.

If @label is %NULL, the label will be unset. When the #GDataGContactExternalID is used in a query, however,
exactly one of #GDataGContactExternalID:relation-type and #GDataGContactExternalID:label must be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactExternalID</doc>
            <type name="GContactExternalID" c:type="GDataGContactExternalID*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new free-form label for the external ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gcontact_external_id_set_relation_type"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactExternalID:relation-type property to @relation_type,
such as %GDATA_GCONTACT_EXTERNAL_ID_NETWORK or %GDATA_GCONTACT_EXTERNAL_ID_ACCOUNT.

If @relation_type is %NULL, the relation type will be unset. When the #GDataGContactExternalID is used in a query, however,
exactly one of #GDataGContactExternalID:relation-type and #GDataGContactExternalID:label must be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactExternalID</doc>
            <type name="GContactExternalID" c:type="GDataGContactExternalID*"/>
          </instance-parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new type for the external ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_value"
              c:identifier="gdata_gcontact_external_id_set_value"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactExternalID:value property to @value.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactExternalID</doc>
            <type name="GContactExternalID" c:type="GDataGContactExternalID*"/>
          </instance-parameter>
          <parameter name="value" transfer-ownership="none">
            <doc xml:space="preserve">the new value for the external ID</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="label"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A free-form string that identifies the type of external ID. It is mutually exclusive with #GDataGContactExternalID:relation-type.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcExternalId"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A programmatic value that identifies the type of external ID. It is mutually exclusive with #GDataGContactExternalID:label.
Examples are %GDATA_GCONTACT_EXTERNAL_ID_NETWORK or %GDATA_GCONTACT_EXTERNAL_ID_ACCOUNT.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcExternalId"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="value"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The value of the external ID.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcExternalId"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GContactExternalIDPrivate"
              c:type="GDataGContactExternalIDPrivate*"/>
      </field>
    </class>
    <record name="GContactExternalIDClass"
            c:type="GDataGContactExternalIDClass"
            glib:is-gtype-struct-for="GContactExternalID"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataGContactExternalIDClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GContactExternalIDPrivate"
            c:type="GDataGContactExternalIDPrivate"
            disguised="1">
    </record>
    <class name="GContactJot"
           c:symbol-prefix="gcontact_jot"
           c:type="GDataGContactJot"
           version="0.7.0"
           parent="Parsable"
           glib:type-name="GDataGContactJot"
           glib:get-type="gdata_gcontact_jot_get_type"
           glib:type-struct="GContactJotClass">
      <doc xml:space="preserve">All the fields in the #GDataGContactJot structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_gcontact_jot_new"
                   version="0.7.0">
        <doc xml:space="preserve">Creates a new #GDataGContactJot. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcJot"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGContactJot; unref with g_object_unref()</doc>
          <type name="GContactJot" c:type="GDataGContactJot*"/>
        </return-value>
        <parameters>
          <parameter name="content" transfer-ownership="none">
            <doc xml:space="preserve">the content of the jot</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="relation_type" transfer-ownership="none">
            <doc xml:space="preserve">the relationship between the jot and its owner</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_content"
              c:identifier="gdata_gcontact_jot_get_content"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactJot:content property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the jot's content</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactJot</doc>
            <type name="GContactJot" c:type="GDataGContactJot*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gcontact_jot_get_relation_type"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactJot:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the jot's relation type</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactJot</doc>
            <type name="GContactJot" c:type="GDataGContactJot*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_content"
              c:identifier="gdata_gcontact_jot_set_content"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactJot:content property to @content.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactJot</doc>
            <type name="GContactJot" c:type="GDataGContactJot*"/>
          </instance-parameter>
          <parameter name="content" transfer-ownership="none">
            <doc xml:space="preserve">the new content</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gcontact_jot_set_relation_type"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactJot:relation-type property to @relation_type
such as %GDATA_GCONTACT_JOT_HOME or %GDATA_GCONTACT_JOT_OTHER.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactJot</doc>
            <type name="GContactJot" c:type="GDataGContactJot*"/>
          </instance-parameter>
          <parameter name="relation_type" transfer-ownership="none">
            <doc xml:space="preserve">the new relation type for the jot, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="content"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The content of the jot.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcJot"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A programmatic value that identifies the type of jot. Examples are %GDATA_GCONTACT_JOT_HOME or %GDATA_GCONTACT_JOT_OTHER.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcJot"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GContactJotPrivate" c:type="GDataGContactJotPrivate*"/>
      </field>
    </class>
    <record name="GContactJotClass"
            c:type="GDataGContactJotClass"
            glib:is-gtype-struct-for="GContactJot"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataGContactJotClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GContactJotPrivate"
            c:type="GDataGContactJotPrivate"
            disguised="1">
    </record>
    <class name="GContactLanguage"
           c:symbol-prefix="gcontact_language"
           c:type="GDataGContactLanguage"
           version="0.7.0"
           parent="Parsable"
           glib:type-name="GDataGContactLanguage"
           glib:get-type="gdata_gcontact_language_get_type"
           glib:type-struct="GContactLanguageClass">
      <doc xml:space="preserve">All the fields in the #GDataGContactLanguage structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new"
                   c:identifier="gdata_gcontact_language_new"
                   version="0.7.0">
        <doc xml:space="preserve">Creates a new #GDataGContactLanguage. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcLanguage"&gt;gContact specification&lt;/ulink&gt;.

Exactly one of @code and @label should be provided; the other must be %NULL.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGContactLanguage; unref with g_object_unref()</doc>
          <type name="GContactLanguage" c:type="GDataGContactLanguage*"/>
        </return-value>
        <parameters>
          <parameter name="code"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the language code, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a free-form label for the language, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_code"
              c:identifier="gdata_gcontact_language_get_code"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactLanguage:code property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the language's code, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactLanguage</doc>
            <type name="GContactLanguage" c:type="GDataGContactLanguage*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_label"
              c:identifier="gdata_gcontact_language_get_label"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactLanguage:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a free-form label for the language, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactLanguage</doc>
            <type name="GContactLanguage" c:type="GDataGContactLanguage*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_code"
              c:identifier="gdata_gcontact_language_set_code"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactLanguage:code property to @code.

If @code is %NULL, the code will be unset. When the #GDataGContactLanguage is used in a query, however,
exactly one of #GDataGContactLanguage:code and #GDataGContactLanguage:label must be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactLanguage</doc>
            <type name="GContactLanguage" c:type="GDataGContactLanguage*"/>
          </instance-parameter>
          <parameter name="code"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new code for the language, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_gcontact_language_set_label"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactLanguage:label property to @label.

If @label is %NULL, the label will be unset. When the #GDataGContactLanguage is used in a query, however,
exactly one of #GDataGContactLanguage:code and #GDataGContactLanguage:label must be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactLanguage</doc>
            <type name="GContactLanguage" c:type="GDataGContactLanguage*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new free-form label for the language, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="code"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A code identifying the language, conforming to the IETF BCP 47 specification. It is mutually exclusive with #GDataGContactLanguage:label.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcLanguage"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="label"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A free-form string that identifies the language. It is mutually exclusive with #GDataGContactLanguage:code.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcLanguage"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GContactLanguagePrivate"
              c:type="GDataGContactLanguagePrivate*"/>
      </field>
    </class>
    <record name="GContactLanguageClass"
            c:type="GDataGContactLanguageClass"
            glib:is-gtype-struct-for="GContactLanguage"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataGContactLanguageClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GContactLanguagePrivate"
            c:type="GDataGContactLanguagePrivate"
            disguised="1">
    </record>
    <class name="GContactRelation"
           c:symbol-prefix="gcontact_relation"
           c:type="GDataGContactRelation"
           version="0.7.0"
           parent="Parsable"
           glib:type-name="GDataGContactRelation"
           glib:get-type="gdata_gcontact_relation_get_type"
           glib:type-struct="GContactRelationClass">
      <doc xml:space="preserve">All the fields in the #GDataGContactRelation structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_gcontact_relation_new"
                   version="0.7.0">
        <doc xml:space="preserve">Creates a new #GDataGContactRelation. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;gContact specification&lt;/ulink&gt;.

Exactly one of @relation_type and @label should be provided; the other must be %NULL.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGContactRelation; unref with g_object_unref()</doc>
          <type name="GContactRelation" c:type="GDataGContactRelation*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">the name of the relation</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the type of relation, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a free-form label for the type of relation, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_label"
              c:identifier="gdata_gcontact_relation_get_label"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactRelation:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a free-form label for the type of the relation, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactRelation</doc>
            <type name="GContactRelation" c:type="GDataGContactRelation*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_name"
              c:identifier="gdata_gcontact_relation_get_name"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactRelation:name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the relation's name</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactRelation</doc>
            <type name="GContactRelation" c:type="GDataGContactRelation*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gcontact_relation_get_relation_type"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactRelation:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the type of the relation, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactRelation</doc>
            <type name="GContactRelation" c:type="GDataGContactRelation*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_gcontact_relation_set_label"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactRelation:label property to @label.

If @label is %NULL, the label will be unset. When the #GDataGContactRelation is used in a query, however,
exactly one of #GDataGContactRelation:relation-type and #GDataGContactRelation:label must be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactRelation</doc>
            <type name="GContactRelation" c:type="GDataGContactRelation*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new free-form type for the relation, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_name"
              c:identifier="gdata_gcontact_relation_set_name"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactRelation:name property to @name.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactRelation</doc>
            <type name="GContactRelation" c:type="GDataGContactRelation*"/>
          </instance-parameter>
          <parameter name="name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new name for the relation</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gcontact_relation_set_relation_type"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactRelation:relation-type property to @relation_type,
such as %GDATA_GCONTACT_RELATION_MANAGER or %GDATA_GCONTACT_RELATION_CHILD.

If @relation_type is %NULL, the relation type will be unset. When the #GDataGContactRelation is used in a query, however,
exactly one of #GDataGContactRelation:relation-type and #GDataGContactRelation:label must be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactRelation</doc>
            <type name="GContactRelation" c:type="GDataGContactRelation*"/>
          </instance-parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new type for the relation, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="label"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A free-form string that identifies the type of relation. It is mutually exclusive with #GDataGContactRelation:relation-type.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="name"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The name of the relation. It need not be a full name, and there need not be a contact representing the name.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A programmatic value that identifies the type of relation. It is mutually exclusive with #GDataGContactRelation:label.
Examples are %GDATA_GCONTACT_RELATION_MANAGER or %GDATA_GCONTACT_RELATION_CHILD.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcRelation"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GContactRelationPrivate"
              c:type="GDataGContactRelationPrivate*"/>
      </field>
    </class>
    <record name="GContactRelationClass"
            c:type="GDataGContactRelationClass"
            glib:is-gtype-struct-for="GContactRelation"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataGContactRelationClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GContactRelationPrivate"
            c:type="GDataGContactRelationPrivate"
            disguised="1">
    </record>
    <class name="GContactWebsite"
           c:symbol-prefix="gcontact_website"
           c:type="GDataGContactWebsite"
           version="0.7.0"
           parent="Parsable"
           glib:type-name="GDataGContactWebsite"
           glib:get-type="gdata_gcontact_website_get_type"
           glib:type-struct="GContactWebsiteClass">
      <doc xml:space="preserve">All the fields in the #GDataGContactWebsite structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new"
                   c:identifier="gdata_gcontact_website_new"
                   version="0.7.0">
        <doc xml:space="preserve">Creates a new #GDataGContactWebsite. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcWebsite"&gt;gContact specification&lt;/ulink&gt;.

Exactly one of @relation_type and @label should be provided; the other must be %NULL.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGContactWebsite; unref with g_object_unref()</doc>
          <type name="GContactWebsite" c:type="GDataGContactWebsite*"/>
        </return-value>
        <parameters>
          <parameter name="uri" transfer-ownership="none">
            <doc xml:space="preserve">the website URI</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="relation_type" transfer-ownership="none">
            <doc xml:space="preserve">the relationship between the website and its owner, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a human-readable label for the website, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this website is its owner's primary website, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_label"
              c:identifier="gdata_gcontact_website_get_label"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactWebsite:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the website's label, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactWebsite</doc>
            <type name="GContactWebsite" c:type="GDataGContactWebsite*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gcontact_website_get_relation_type"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactWebsite:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the website's relation type</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactWebsite</doc>
            <type name="GContactWebsite" c:type="GDataGContactWebsite*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_uri"
              c:identifier="gdata_gcontact_website_get_uri"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactWebsite:uri property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the URI of the website</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactWebsite</doc>
            <type name="GContactWebsite" c:type="GDataGContactWebsite*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_primary"
              c:identifier="gdata_gcontact_website_is_primary"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataGContactWebsite:is-primary property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if this is the primary website, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactWebsite</doc>
            <type name="GContactWebsite" c:type="GDataGContactWebsite*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_is_primary"
              c:identifier="gdata_gcontact_website_set_is_primary"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactWebsite:is-primary property to @is_primary.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactWebsite</doc>
            <type name="GContactWebsite" c:type="GDataGContactWebsite*"/>
          </instance-parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this is the primary website, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_gcontact_website_set_label"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactWebsite:label property to @label.

If @label is %NULL, the label will be unset. When the #GDataGContactWebsite is used in a query, however,
exactly one of #GDataGContactWebsite:relation-type and #GDataGContactWebsite:label must be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactWebsite</doc>
            <type name="GContactWebsite" c:type="GDataGContactWebsite*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new label for the website, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gcontact_website_set_relation_type"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactWebsite:relation-type property to @relation_type
such as %GDATA_GCONTACT_WEBSITE_HOME_PAGE or %GDATA_GCONTACT_WEBSITE_FTP.

If @relation_type is %NULL, the relation type will be unset. When the #GDataGContactWebsite is used in a query, however,
exactly one of #GDataGContactWebsite:relation-type and #GDataGContactWebsite:label must be %NULL.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactWebsite</doc>
            <type name="GContactWebsite" c:type="GDataGContactWebsite*"/>
          </instance-parameter>
          <parameter name="relation_type" transfer-ownership="none">
            <doc xml:space="preserve">the new relation type for the website</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_uri"
              c:identifier="gdata_gcontact_website_set_uri"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataGContactWebsite:uri property to @uri.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGContactWebsite</doc>
            <type name="GContactWebsite" c:type="GDataGContactWebsite*"/>
          </instance-parameter>
          <parameter name="uri" transfer-ownership="none">
            <doc xml:space="preserve">the new website URI</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="is-primary"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates which website out of a group is primary.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcWebsite"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="label"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A simple string value used to name this website. It allows UIs to display a label such as "Work", "Travel blog", "Personal blog", etc.
It is mutually exclusive with #GDataGContactWebsite:relation-type.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcWebsite"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A programmatic value that identifies the type of website. Examples are %GDATA_GCONTACT_WEBSITE_HOME_PAGE or %GDATA_GCONTACT_WEBSITE_FTP.
It is mutually exclusive with #GDataGContactWebsite:label.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcWebsite"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="uri"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The URI of the website.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/contacts/docs/3.0/reference.html#gcWebsite"&gt;gContact specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GContactWebsitePrivate"
              c:type="GDataGContactWebsitePrivate*"/>
      </field>
    </class>
    <record name="GContactWebsiteClass"
            c:type="GDataGContactWebsiteClass"
            glib:is-gtype-struct-for="GContactWebsite"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataGContactWebsiteClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GContactWebsitePrivate"
            c:type="GDataGContactWebsitePrivate"
            disguised="1">
    </record>
    <class name="GDEmailAddress"
           c:symbol-prefix="gd_email_address"
           c:type="GDataGDEmailAddress"
           version="0.2.0"
           parent="Parsable"
           glib:type-name="GDataGDEmailAddress"
           glib:get-type="gdata_gd_email_address_get_type"
           glib:type-struct="GDEmailAddressClass">
      <doc xml:space="preserve">All the fields in the #GDataGDEmailAddress structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new"
                   c:identifier="gdata_gd_email_address_new"
                   version="0.2.0">
        <doc xml:space="preserve">Creates a new #GDataGDEmailAddress. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdEmail"&gt;GData specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGDEmailAddress, or %NULL; unref with g_object_unref()</doc>
          <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
        </return-value>
        <parameters>
          <parameter name="address" transfer-ownership="none">
            <doc xml:space="preserve">the e-mail address</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the relationship between the e-mail address and its owner, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a human-readable label for the e-mail address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this e-mail address is its owner's primary address, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_address"
              c:identifier="gdata_gd_email_address_get_address"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDEmailAddress:address property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the e-mail address itself, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDEmailAddress</doc>
            <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_display_name"
              c:identifier="gdata_gd_email_address_get_display_name"
              version="0.6.0">
        <doc xml:space="preserve">Gets the #GDataGDEmailAddress:display-name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a display name for the e-mail address, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDEmailAddress</doc>
            <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_label"
              c:identifier="gdata_gd_email_address_get_label"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDEmailAddress:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the e-mail address' label, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDEmailAddress</doc>
            <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gd_email_address_get_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDEmailAddress:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the e-mail address' relation type, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDEmailAddress</doc>
            <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_primary"
              c:identifier="gdata_gd_email_address_is_primary"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDEmailAddress:is-primary property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if this is the primary e-mail address, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDEmailAddress</doc>
            <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_address"
              c:identifier="gdata_gd_email_address_set_address"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDEmailAddress:address property to @address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDEmailAddress</doc>
            <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
          </instance-parameter>
          <parameter name="address" transfer-ownership="none">
            <doc xml:space="preserve">the new e-mail address</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_display_name"
              c:identifier="gdata_gd_email_address_set_display_name"
              version="0.6.0">
        <doc xml:space="preserve">Sets the #GDataGDEmailAddress:display-name property to @display_name.

Set @display_name to %NULL to unset the property in the e-mail address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDEmailAddress</doc>
            <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
          </instance-parameter>
          <parameter name="display_name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new display name, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_primary"
              c:identifier="gdata_gd_email_address_set_is_primary"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDEmailAddress:is-primary property to @is_primary.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDEmailAddress</doc>
            <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
          </instance-parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this is the primary e-mail address, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_gd_email_address_set_label"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDEmailAddress:label property to @label.

Set @label to %NULL to unset the property in the e-mail address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDEmailAddress</doc>
            <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new label for the e-mail address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gd_email_address_set_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDEmailAddress:relation-type property to @relation_type.

Set @relation_type to %NULL to unset the property in the e-mail address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDEmailAddress</doc>
            <type name="GDEmailAddress" c:type="GDataGDEmailAddress*"/>
          </instance-parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new relation type for the email_address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="address"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The e-mail address itself.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdEmail"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="display-name"
                version="0.6.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A display name of the entity (e.g. a person) the e-mail address belongs to.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdEmail"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="is-primary"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates which e-mail address out of a group is primary.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdEmail"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="label"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A simple string value used to name this e-mail address. It allows UIs to display a label such as "Work", "Personal", "Preferred", etc.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdEmail"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A programmatic value that identifies the type of e-mail address. For example: %GDATA_GD_EMAIL_ADDRESS_HOME or %GDATA_GD_EMAIL_ADDRESS_WORK.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdEmail"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GDEmailAddressPrivate"
              c:type="GDataGDEmailAddressPrivate*"/>
      </field>
    </class>
    <record name="GDEmailAddressClass"
            c:type="GDataGDEmailAddressClass"
            glib:is-gtype-struct-for="GDEmailAddress"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataGDEmailAddressClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GDEmailAddressPrivate"
            c:type="GDataGDEmailAddressPrivate"
            disguised="1">
    </record>
    <class name="GDIMAddress"
           c:symbol-prefix="gd_im_address"
           c:type="GDataGDIMAddress"
           version="0.2.0"
           parent="Parsable"
           glib:type-name="GDataGDIMAddress"
           glib:get-type="gdata_gd_im_address_get_type"
           glib:type-struct="GDIMAddressClass">
      <doc xml:space="preserve">All the fields in the #GDataGDIMAddress structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new"
                   c:identifier="gdata_gd_im_address_new"
                   version="0.2.0">
        <doc xml:space="preserve">Creates a new #GDataGDIMAddress. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdIm"&gt;GData specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGDIMAddress, or %NULL; unref with g_object_unref()</doc>
          <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
        </return-value>
        <parameters>
          <parameter name="address" transfer-ownership="none">
            <doc xml:space="preserve">the IM address</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="protocol"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a URI identifying the IM protocol, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the relationship between the IM address and its owner, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a human-readable label for the IM address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this IM address is its owner's primary address, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_address"
              c:identifier="gdata_gd_im_address_get_address"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDIMAddress:address property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the IM address itself, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDIMAddress</doc>
            <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_label"
              c:identifier="gdata_gd_im_address_get_label"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDIMAddress:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the IM address' label, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDIMAddress</doc>
            <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_protocol"
              c:identifier="gdata_gd_im_address_get_protocol"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDIMAddress:protocol property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the IM address' protocol, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDIMAddress</doc>
            <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gd_im_address_get_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDIMAddress:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the IM address' relation type, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDIMAddress</doc>
            <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_primary"
              c:identifier="gdata_gd_im_address_is_primary"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDIMAddress:is-primary property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if this is the primary IM address, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDIMAddress</doc>
            <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_address"
              c:identifier="gdata_gd_im_address_set_address"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDIMAddress:address property to @address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDIMAddress</doc>
            <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
          </instance-parameter>
          <parameter name="address" transfer-ownership="none">
            <doc xml:space="preserve">the new IM address</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_primary"
              c:identifier="gdata_gd_im_address_set_is_primary"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDIMAddress:is-primary property to @is_primary.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDIMAddress</doc>
            <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
          </instance-parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this is the primary IM address, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_gd_im_address_set_label"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDIMAddress:label property to @label.

Set @label to %NULL to unset the property in the IM address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDIMAddress</doc>
            <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new label for the IM address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_protocol"
              c:identifier="gdata_gd_im_address_set_protocol"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDIMAddress:protocol property to @protocol.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDIMAddress</doc>
            <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
          </instance-parameter>
          <parameter name="protocol"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new IM protocol, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gd_im_address_set_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDIMAddress:relation-type property to @relation_type.

Set @relation_type to %NULL to unset the property in the IM address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDIMAddress</doc>
            <type name="GDIMAddress" c:type="GDataGDIMAddress*"/>
          </instance-parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new relation type for the im_address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="address"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The IM address itself.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdIm"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="is-primary"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates which IM address out of a group is primary.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdIm"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="label"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A simple string value used to name this IM address. It allows UIs to display a label such as "Work", "Personal", "Preferred", etc.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdIm"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="protocol"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Identifies the IM network. For example: %GDATA_GD_IM_PROTOCOL_JABBER or %GDATA_GD_IM_PROTOCOL_GOOGLE_TALK.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdIm"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A programmatic value that identifies the type of IM address. For example: %GDATA_GD_IM_ADDRESS_HOME or %GDATA_GD_IM_ADDRESS_WORK.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdIm"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GDIMAddressPrivate" c:type="GDataGDIMAddressPrivate*"/>
      </field>
    </class>
    <record name="GDIMAddressClass"
            c:type="GDataGDIMAddressClass"
            glib:is-gtype-struct-for="GDIMAddress"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataGDIMAddressClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GDIMAddressPrivate"
            c:type="GDataGDIMAddressPrivate"
            disguised="1">
    </record>
    <class name="GDName"
           c:symbol-prefix="gd_name"
           c:type="GDataGDName"
           version="0.5.0"
           parent="Parsable"
           glib:type-name="GDataGDName"
           glib:get-type="gdata_gd_name_get_type"
           glib:type-struct="GDNameClass">
      <doc xml:space="preserve">All the fields in the #GDataGDName structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new" c:identifier="gdata_gd_name_new" version="0.5.0">
        <doc xml:space="preserve">Creates a new #GDataGDName. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdName"&gt;GData specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGDName, or %NULL; unref with g_object_unref()</doc>
          <type name="GDName" c:type="GDataGDName*"/>
        </return-value>
        <parameters>
          <parameter name="given_name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the person's given name, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="family_name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the person's family name, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_additional_name"
              c:identifier="gdata_gd_name_get_additional_name"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDName:additional-name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the person's additional name, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_family_name"
              c:identifier="gdata_gd_name_get_family_name"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDName:family-name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the person's family name, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_full_name"
              c:identifier="gdata_gd_name_get_full_name"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDName:full-name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the person's full name, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_given_name"
              c:identifier="gdata_gd_name_get_given_name"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDName:given-name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the person's given name, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_prefix"
              c:identifier="gdata_gd_name_get_prefix"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDName:prefix property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the person's name prefix, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_suffix"
              c:identifier="gdata_gd_name_get_suffix"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDName:suffix property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the person's name suffix, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_additional_name"
              c:identifier="gdata_gd_name_set_additional_name"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDName:additional-name property to @additional_name.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </instance-parameter>
          <parameter name="additional_name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new additional name, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_family_name"
              c:identifier="gdata_gd_name_set_family_name"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDName:family-name property to @family_name.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </instance-parameter>
          <parameter name="family_name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new family name, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_full_name"
              c:identifier="gdata_gd_name_set_full_name"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDName:full-name property to @full_name.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </instance-parameter>
          <parameter name="full_name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new full name, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_given_name"
              c:identifier="gdata_gd_name_set_given_name"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDName:given-name property to @given_name.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </instance-parameter>
          <parameter name="given_name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new given name, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_prefix"
              c:identifier="gdata_gd_name_set_prefix"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDName:prefix property to @prefix.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </instance-parameter>
          <parameter name="prefix"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new prefix, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_suffix"
              c:identifier="gdata_gd_name_set_suffix"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDName:suffix property to @suffix.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDName</doc>
            <type name="GDName" c:type="GDataGDName*"/>
          </instance-parameter>
          <parameter name="suffix"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new suffix, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="additional-name"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An additional name for the person (e.g. a middle name).

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdName"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="family-name"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The person's family name.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdName"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="full-name"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An unstructured representation of the person's full name. It's generally advised to use the other individual properties in preference
to this one, which can fall out of synchronisation with the other properties.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdName"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="given-name"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The person's given name.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdName"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="prefix"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An honorific prefix (e.g. &lt;literal&gt;Mr&lt;/literal&gt; or &lt;literal&gt;Mrs&lt;/literal&gt;).

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdName"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="suffix"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An honorific suffix (e.g. &lt;literal&gt;san&lt;/literal&gt; or &lt;literal&gt;III&lt;/literal&gt;).

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdName"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GDNamePrivate" c:type="GDataGDNamePrivate*"/>
      </field>
    </class>
    <record name="GDNameClass"
            c:type="GDataGDNameClass"
            glib:is-gtype-struct-for="GDName"
            version="0.5.0">
      <doc xml:space="preserve">All the fields in the #GDataGDNameClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GDNamePrivate" c:type="GDataGDNamePrivate" disguised="1">
    </record>
    <class name="GDOrganization"
           c:symbol-prefix="gd_organization"
           c:type="GDataGDOrganization"
           version="0.2.0"
           parent="Parsable"
           glib:type-name="GDataGDOrganization"
           glib:get-type="gdata_gd_organization_get_type"
           glib:type-struct="GDOrganizationClass">
      <doc xml:space="preserve">All the fields in the #GDataGDOrganization structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new"
                   c:identifier="gdata_gd_organization_new"
                   version="0.2.0">
        <doc xml:space="preserve">Creates a new #GDataGDOrganization. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdOrganization"&gt;GData specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGDOrganization, or %NULL; unref with g_object_unref()</doc>
          <type name="GDOrganization" c:type="GDataGDOrganization*"/>
        </return-value>
        <parameters>
          <parameter name="name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the name of the organization, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="title"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the owner's title within the organization, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the relationship between the organization and its owner, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a human-readable label for the organization, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this organization is its owner's primary organization, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_department"
              c:identifier="gdata_gd_organization_get_department"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDOrganization:department property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the department in which the person works in this organization, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_job_description"
              c:identifier="gdata_gd_organization_get_job_description"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDOrganization:job-description property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the job description of the person in the organization, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_label"
              c:identifier="gdata_gd_organization_get_label"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDOrganization:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the organization's label, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_location"
              c:identifier="gdata_gd_organization_get_location"
              version="0.6.0">
        <doc xml:space="preserve">Gets the #GDataGDOrganization:location property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the organization's location, or %NULL</doc>
          <type name="GDWhere" c:type="GDataGDWhere*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_name"
              c:identifier="gdata_gd_organization_get_name"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDOrganization:name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the organization's name, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gd_organization_get_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDOrganization:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the organization's relation type, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_symbol"
              c:identifier="gdata_gd_organization_get_symbol"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDOrganization:symbol property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the organization's stock symbol, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_title"
              c:identifier="gdata_gd_organization_get_title"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDOrganization:title property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the organization's title, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_primary"
              c:identifier="gdata_gd_organization_is_primary"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDOrganization:is-primary property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if this is the primary organization, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_department"
              c:identifier="gdata_gd_organization_set_department"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDOrganization:department property to @department.

Set @department to %NULL to unset the property in the organization.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
          <parameter name="department"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new department for the person working in the organization, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_primary"
              c:identifier="gdata_gd_organization_set_is_primary"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDOrganization:is-primary property to @is_primary.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this is the primary organization, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_job_description"
              c:identifier="gdata_gd_organization_set_job_description"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDOrganization:job-description property to @job_description.

Set @job_description to %NULL to unset the property in the organization.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
          <parameter name="job_description"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new job description for the person in the organization, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_gd_organization_set_label"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDOrganization:label property to @label.

Set @label to %NULL to unset the property in the organization.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new label for the organization, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_location"
              c:identifier="gdata_gd_organization_set_location"
              version="0.6.0">
        <doc xml:space="preserve">Sets the #GDataGDOrganization:location property to @location.

Set @location to %NULL to unset the property in the organization.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
          <parameter name="location"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new location for the organization, or %NULL</doc>
            <type name="GDWhere" c:type="GDataGDWhere*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_name"
              c:identifier="gdata_gd_organization_set_name"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDOrganization:name property to @name.

Set @name to %NULL to unset the property in the organization.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
          <parameter name="name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new name for the organization, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gd_organization_set_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDOrganization:relation-type property to @relation_type.

Set @relation_type to %NULL to unset the property in the organization.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new relation type for the organization, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_symbol"
              c:identifier="gdata_gd_organization_set_symbol"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDOrganization:symbol property to @symbol.

Set @symbol to %NULL to unset the property in the organization.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
          <parameter name="symbol"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new stock symbol for the organization, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_title"
              c:identifier="gdata_gd_organization_set_title"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDOrganization:title property to @title.

Set @title to %NULL to unset the property in the organization.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDOrganization</doc>
            <type name="GDOrganization" c:type="GDataGDOrganization*"/>
          </instance-parameter>
          <parameter name="title"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new title for the organization, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="department"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies a department within the organization.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdOrganization"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="is-primary"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates which organization out of a group is primary.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdOrganization"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="job-description"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Description of a job within the organization.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdOrganization"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="label"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A simple string value used to name this organization. It allows UIs to display a label such as "Work", "Volunteer",
"Professional Society", etc.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdOrganization"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="location"
                version="0.6.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A place associated with the organization, e.g. office location.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdOrganization"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="GDWhere"/>
      </property>
      <property name="name"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The name of the organization.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdOrganization"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A programmatic value that identifies the type of organization. For example: %GDATA_GD_ORGANIZATION_WORK or %GDATA_GD_ORGANIZATION_OTHER.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdOrganization"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="symbol"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Stock symbol of the organization.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdOrganization"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="title"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The title of a person within the organization.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdOrganization"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GDOrganizationPrivate"
              c:type="GDataGDOrganizationPrivate*"/>
      </field>
    </class>
    <record name="GDOrganizationClass"
            c:type="GDataGDOrganizationClass"
            glib:is-gtype-struct-for="GDOrganization"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataGDOrganizationClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GDOrganizationPrivate"
            c:type="GDataGDOrganizationPrivate"
            disguised="1">
    </record>
    <class name="GDPhoneNumber"
           c:symbol-prefix="gd_phone_number"
           c:type="GDataGDPhoneNumber"
           version="0.2.0"
           parent="Parsable"
           glib:type-name="GDataGDPhoneNumber"
           glib:get-type="gdata_gd_phone_number_get_type"
           glib:type-struct="GDPhoneNumberClass">
      <doc xml:space="preserve">All the fields in the #GDataGDPhoneNumber structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new"
                   c:identifier="gdata_gd_phone_number_new"
                   version="0.2.0">
        <doc xml:space="preserve">Creates a new #GDataGDPhoneNumber. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdPhoneNumber"&gt;GData specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGDPhoneNumber, or %NULL; unref with g_object_unref()</doc>
          <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
        </return-value>
        <parameters>
          <parameter name="number" transfer-ownership="none">
            <doc xml:space="preserve">the phone number, in human-readable format</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the relationship between the phone number and its owner, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a human-readable label for the phone number, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="uri"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a "tel URI" to represent the number formally (see
&lt;ulink type="http" url="http://www.ietf.org/rfc/rfc3966.txt"&gt;RFC 3966&lt;/ulink&gt;), or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this phone number is its owner's primary number, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_label"
              c:identifier="gdata_gd_phone_number_get_label"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDPhoneNumber:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the phone number's label, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPhoneNumber</doc>
            <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_number"
              c:identifier="gdata_gd_phone_number_get_number"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDPhoneNumber:number property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the phone number itself</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPhoneNumber</doc>
            <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gd_phone_number_get_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDPhoneNumber:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the phone number's relation type, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPhoneNumber</doc>
            <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_uri"
              c:identifier="gdata_gd_phone_number_get_uri"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDPhoneNumber:uri property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the phone number's URI, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPhoneNumber</doc>
            <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_primary"
              c:identifier="gdata_gd_phone_number_is_primary"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDPhoneNumber:is-primary property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if this is the primary phone number, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPhoneNumber</doc>
            <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_is_primary"
              c:identifier="gdata_gd_phone_number_set_is_primary"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDPhoneNumber:is-primary property to @is_primary.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPhoneNumber</doc>
            <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
          </instance-parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this is the primary phone number, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_gd_phone_number_set_label"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDPhoneNumber:label property to @label.

Set @label to %NULL to unset the property in the phone number.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPhoneNumber</doc>
            <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new label for the phone number, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_number"
              c:identifier="gdata_gd_phone_number_set_number"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDPhoneNumber:number property to @number.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPhoneNumber</doc>
            <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
          </instance-parameter>
          <parameter name="number" transfer-ownership="none">
            <doc xml:space="preserve">the new phone number</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gd_phone_number_set_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDPhoneNumber:relation-type property to @relation_type.

Set @relation_type to %NULL to unset the property in the phone number.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPhoneNumber</doc>
            <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
          </instance-parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new relation type for the phone number, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_uri"
              c:identifier="gdata_gd_phone_number_set_uri"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDPhoneNumber:uri property to @uri.

Set @uri to %NULL to unset the property in the phone number.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPhoneNumber</doc>
            <type name="GDPhoneNumber" c:type="GDataGDPhoneNumber*"/>
          </instance-parameter>
          <parameter name="uri"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new URI for the phone number, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="is-primary"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates which phone number out of a group is primary.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdPhoneNumber"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="label"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A simple string value used to name this phone number. It allows UIs to display a label such as "Mobile", "Home", "Work", etc.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdPhoneNumber"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="number"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Human-readable phone number; may be in any telephone number format.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdPhoneNumber"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A programmatic value that identifies the type of phone number. For example: %GDATA_GD_PHONE_NUMBER_WORK or %GDATA_GD_PHONE_NUMBER_PAGER.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdPhoneNumber"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="uri"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An optional "tel URI" used to represent the number in a formal way. Useful for programmatic access, such as a VoIP/PSTN bridge.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdPhoneNumber"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GDPhoneNumberPrivate" c:type="GDataGDPhoneNumberPrivate*"/>
      </field>
    </class>
    <record name="GDPhoneNumberClass"
            c:type="GDataGDPhoneNumberClass"
            glib:is-gtype-struct-for="GDPhoneNumber"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataGDPhoneNumberClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GDPhoneNumberPrivate"
            c:type="GDataGDPhoneNumberPrivate"
            disguised="1">
    </record>
    <class name="GDPostalAddress"
           c:symbol-prefix="gd_postal_address"
           c:type="GDataGDPostalAddress"
           version="0.2.0"
           parent="Parsable"
           glib:type-name="GDataGDPostalAddress"
           glib:get-type="gdata_gd_postal_address_get_type"
           glib:type-struct="GDPostalAddressClass">
      <doc xml:space="preserve">All the fields in the #GDataGDPostalAddress structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new"
                   c:identifier="gdata_gd_postal_address_new"
                   version="0.2.0">
        <doc xml:space="preserve">Creates a new #GDataGDPostalAddress. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGDPostalAddress, or %NULL; unref with g_object_unref()</doc>
          <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
        </return-value>
        <parameters>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the relationship between the address and its owner, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a human-readable label for the address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this phone number is its owner's primary number, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_address"
              c:identifier="gdata_gd_postal_address_get_address"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:address property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address itself, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_agent"
              c:identifier="gdata_gd_postal_address_get_agent"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:agent property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' agent, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_city"
              c:identifier="gdata_gd_postal_address_get_city"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:city property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' city, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_country"
              c:identifier="gdata_gd_postal_address_get_country"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:country property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' country, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_country_code"
              c:identifier="gdata_gd_postal_address_get_country_code"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:country-code property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' ISO 3166-1 alpha-2 country code, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_house_name"
              c:identifier="gdata_gd_postal_address_get_house_name"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:house-name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' house name, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_label"
              c:identifier="gdata_gd_postal_address_get_label"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' label, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_mail_class"
              c:identifier="gdata_gd_postal_address_get_mail_class"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:mail-class property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' mail class, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_neighborhood"
              c:identifier="gdata_gd_postal_address_get_neighborhood"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:neighborhood property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' neighborhood, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_po_box"
              c:identifier="gdata_gd_postal_address_get_po_box"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:po-box property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' P.O. box, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_postcode"
              c:identifier="gdata_gd_postal_address_get_postcode"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:postcode property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' postcode, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_region"
              c:identifier="gdata_gd_postal_address_get_region"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:region property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' region, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gd_postal_address_get_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' relation type, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_street"
              c:identifier="gdata_gd_postal_address_get_street"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:street property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' street, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_subregion"
              c:identifier="gdata_gd_postal_address_get_subregion"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:subregion property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' subregion, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_usage"
              c:identifier="gdata_gd_postal_address_get_usage"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:usage property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the postal address' usage, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_primary"
              c:identifier="gdata_gd_postal_address_is_primary"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDPostalAddress:is-primary property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if this is the primary postal address, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_address"
              c:identifier="gdata_gd_postal_address_set_address"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:address property to @address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="address"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_agent"
              c:identifier="gdata_gd_postal_address_set_agent"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:agent property to @agent.

Set @agent to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="agent"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new agent for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_city"
              c:identifier="gdata_gd_postal_address_set_city"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:city property to @city.

Set @city to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="city"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new city for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_country"
              c:identifier="gdata_gd_postal_address_set_country"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:country property to @country, and #GDataGDPostalAddress:country-code to @country_code.

Set @country or @country_code to %NULL to unset the relevant property in the postal address. If a @country_code is provided, a @country must
also be provided.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="country"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new country for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="country_code"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new country code for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_house_name"
              c:identifier="gdata_gd_postal_address_set_house_name"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:house-name property to @house_name.

Set @house_name to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="house_name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new house name for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_primary"
              c:identifier="gdata_gd_postal_address_set_is_primary"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:is-primary property to @is_primary.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="is_primary" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if this is the primary postal address, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_gd_postal_address_set_label"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:label property to @label.

Set @label to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new label for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_mail_class"
              c:identifier="gdata_gd_postal_address_set_mail_class"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:mail-class property to @mail_class.

Set @mail_class to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="mail_class"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new mail class for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_neighborhood"
              c:identifier="gdata_gd_postal_address_set_neighborhood"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:neighborhood property to @neighborhood.

Set @neighborhood to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="neighborhood"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new neighborhood for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_po_box"
              c:identifier="gdata_gd_postal_address_set_po_box"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:po-box property to @po_box.

Set @po_box to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="po_box"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new P.O. box for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_postcode"
              c:identifier="gdata_gd_postal_address_set_postcode"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:postcode property to @postcode.

Set @postcode to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="postcode"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new postcode for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_region"
              c:identifier="gdata_gd_postal_address_set_region"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:region property to @region.

Set @region to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="region"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new region for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gd_postal_address_set_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:relation-type property to @relation_type.

Set @relation_type to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new relation type for the postal_address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_street"
              c:identifier="gdata_gd_postal_address_set_street"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:street property to @street.

Set @street to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="street"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new street for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_subregion"
              c:identifier="gdata_gd_postal_address_set_subregion"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:subregion property to @subregion.

Set @subregion to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="subregion"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new subregion for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_usage"
              c:identifier="gdata_gd_postal_address_set_usage"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataGDPostalAddress:usage property to @usage.

Set @usage to %NULL to unset the property in the postal address.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDPostalAddress</doc>
            <type name="GDPostalAddress" c:type="GDataGDPostalAddress*"/>
          </instance-parameter>
          <parameter name="usage"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new usage for the postal address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="address"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The postal address itself, formatted and unstructured. It is preferred to use the other, structured properties rather than this one.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="agent"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The agent who actually receives the mail. Used in work addresses. Also for "in care of" or "c/o".

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="city"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Can be city, village, town, borough, etc. This is the postal town and not necessarily the place of residence or place of business.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="country" version="0.5.0" transfer-ownership="none">
        <doc xml:space="preserve">The name of the country. Since this is paired with #GDataGDPostalAddress:country-code, they must both be set with
gdata_gd_postal_address_set_country().

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="country-code" version="0.5.0" transfer-ownership="none">
        <doc xml:space="preserve">The ISO 3166-1 alpha-2 country code for the country in #GDataGDPostalAddress:country. Since this is paired with
#GDataGDPostalAddress:country, they must both be set with gdata_gd_postal_address_set_country().

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;
or &lt;ulink type="http" url="http://www.iso.org/iso/iso-3166-1_decoding_table"&gt;ISO 3166-1 alpha-2&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="house-name"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Used in places where houses or buildings have names (and not necessarily numbers).

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="is-primary"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates which postal address out of a group is primary.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="label"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A simple string value used to name this postal address. It allows UIs to display a label such as "Work", "Personal", "Preferred", etc.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="mail-class"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Classes of mail accepted at this address. For example: %GDATA_GD_MAIL_CLASS_LETTERS or %GDATA_GD_MAIL_CLASS_BOTH.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="neighborhood"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">This is used to disambiguate a street address when a city contains more than one street with the same name, or to specify a small place
whose mail is routed through a larger postal town. In China it could be a county or a minor city.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="po-box"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Covers actual P.O. boxes, drawers, locked bags, etc. This is usually but not always mutually exclusive with #GDataGDPostalAddress:street.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="postcode"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Postal code. Usually country-wide, but sometimes specific to the city (e.g. "2" in "Dublin 2, Ireland" addresses).

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="region"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A state, province, county (in Ireland), Land (in Germany), departement (in France), etc.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A programmatic value that identifies the type of postal address. For example: %GDATA_GD_POSTAL_ADDRESS_WORK or
%GDATA_GD_POSTAL_ADDRESS_OTHER.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="street"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Can be street, avenue, road, etc. This element also includes the house number and room/apartment/flat/floor number.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="subregion"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Handles administrative districts such as U.S. or U.K. counties that are not used for mail addressing purposes.
Subregion is not intended for delivery addresses.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="usage"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The context in which this addess can be used. For example: %GDATA_GD_ADDRESS_USAGE_GENERAL or %GDATA_GD_ADDRESS_USAGE_LOCAL.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdStructuredPostalAddress"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GDPostalAddressPrivate"
              c:type="GDataGDPostalAddressPrivate*"/>
      </field>
    </class>
    <record name="GDPostalAddressClass"
            c:type="GDataGDPostalAddressClass"
            glib:is-gtype-struct-for="GDPostalAddress"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataGDPostalAddressClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GDPostalAddressPrivate"
            c:type="GDataGDPostalAddressPrivate"
            disguised="1">
    </record>
    <class name="GDReminder"
           c:symbol-prefix="gd_reminder"
           c:type="GDataGDReminder"
           version="0.2.0"
           parent="Parsable"
           glib:type-name="GDataGDReminder"
           glib:get-type="gdata_gd_reminder_get_type"
           glib:type-struct="GDReminderClass">
      <doc xml:space="preserve">All the fields in the #GDataGDReminder structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new"
                   c:identifier="gdata_gd_reminder_new"
                   version="0.2.0">
        <doc xml:space="preserve">Creates a new #GDataGDReminder. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdReminder"&gt;GData specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGDReminder, or %NULL; unref with g_object_unref()</doc>
          <type name="GDReminder" c:type="GDataGDReminder*"/>
        </return-value>
        <parameters>
          <parameter name="method"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the notification method the reminder should use, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="absolute_time" transfer-ownership="none">
            <doc xml:space="preserve">the absolute time for the reminder, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
          <parameter name="relative_time" transfer-ownership="none">
            <doc xml:space="preserve">the relative time for the reminder, in minutes, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_absolute_time"
              c:identifier="gdata_gd_reminder_get_absolute_time"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDReminder:absolute-time property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp of the absolute time for the reminder, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDReminder</doc>
            <type name="GDReminder" c:type="GDataGDReminder*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_method"
              c:identifier="gdata_gd_reminder_get_method"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDReminder:method property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the method, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDReminder</doc>
            <type name="GDReminder" c:type="GDataGDReminder*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relative_time"
              c:identifier="gdata_gd_reminder_get_relative_time"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDReminder:relative-time property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the relative time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDReminder</doc>
            <type name="GDReminder" c:type="GDataGDReminder*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_absolute_time"
              c:identifier="gdata_gd_reminder_is_absolute_time"
              version="0.4.0">
        <doc xml:space="preserve">Returns whether the reminder is specified as an absolute time, or as a number of minutes after
the corresponding event's start time.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the reminder is absolute, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDReminder</doc>
            <type name="GDReminder" c:type="GDataGDReminder*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_absolute_time"
              c:identifier="gdata_gd_reminder_set_absolute_time"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDReminder:absolute-time property to @absolute_time.

Set @absolute_time to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDReminder</doc>
            <type name="GDReminder" c:type="GDataGDReminder*"/>
          </instance-parameter>
          <parameter name="absolute_time" transfer-ownership="none">
            <doc xml:space="preserve">the new absolute time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_method"
              c:identifier="gdata_gd_reminder_set_method"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDReminder:method property to @method.

Set @method to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDReminder</doc>
            <type name="GDReminder" c:type="GDataGDReminder*"/>
          </instance-parameter>
          <parameter name="method"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new method, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relative_time"
              c:identifier="gdata_gd_reminder_set_relative_time"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDReminder:relative-time property to @relative_time.

Set @relative_time to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDReminder</doc>
            <type name="GDReminder" c:type="GDataGDReminder*"/>
          </instance-parameter>
          <parameter name="relative_time" transfer-ownership="none">
            <doc xml:space="preserve">the new relative time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </method>
      <property name="absolute-time"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Absolute time at which the reminder should be issued.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdReminder"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="is-absolute-time"
                version="0.4.0"
                transfer-ownership="none">
        <doc xml:space="preserve">Whether the reminder is specified as an absolute or relative time.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdReminder"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="method"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The notification method the reminder should use. For example: %GDATA_GD_REMINDER_ALERT or %GDATA_GD_REMINDER_EMAIL.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdReminder"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relative-time"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Time at which the reminder should be issued, in minutes relative to the start time of the corresponding event.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdReminder"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="gint" c:type="gint"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GDReminderPrivate" c:type="GDataGDReminderPrivate*"/>
      </field>
    </class>
    <record name="GDReminderClass"
            c:type="GDataGDReminderClass"
            glib:is-gtype-struct-for="GDReminder"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataGDReminderClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GDReminderPrivate"
            c:type="GDataGDReminderPrivate"
            disguised="1">
    </record>
    <class name="GDWhen"
           c:symbol-prefix="gd_when"
           c:type="GDataGDWhen"
           version="0.2.0"
           parent="Parsable"
           glib:type-name="GDataGDWhen"
           glib:get-type="gdata_gd_when_get_type"
           glib:type-struct="GDWhenClass">
      <doc xml:space="preserve">All the fields in the #GDataGDWhen structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new" c:identifier="gdata_gd_when_new" version="0.2.0">
        <doc xml:space="preserve">Creates a new #GDataGDWhen. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWhen"&gt;GData specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGDWhen, or %NULL; unref with g_object_unref()</doc>
          <type name="GDWhen" c:type="GDataGDWhen*"/>
        </return-value>
        <parameters>
          <parameter name="start_time" transfer-ownership="none">
            <doc xml:space="preserve">when the event starts or (for zero-duration events) when it occurs</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
          <parameter name="end_time" transfer-ownership="none">
            <doc xml:space="preserve">when the event ends, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
          <parameter name="is_date" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if @start_time and @end_time specify dates rather than times, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="add_reminder"
              c:identifier="gdata_gd_when_add_reminder"
              version="0.7.0">
        <doc xml:space="preserve">Adds a reminder to the #GDataGDWhen's list of reminders and increments its reference count.

Duplicate reminders will not be added to the list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhen</doc>
            <type name="GDWhen" c:type="GDataGDWhen*"/>
          </instance-parameter>
          <parameter name="reminder" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDReminder to add</doc>
            <type name="GDReminder" c:type="GDataGDReminder*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_end_time"
              c:identifier="gdata_gd_when_get_end_time"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDWhen:end-time property.

If the end time is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the end time of the event, or
&lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhen</doc>
            <type name="GDWhen" c:type="GDataGDWhen*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_reminders"
              c:identifier="gdata_gd_when_get_reminders"
              version="0.4.0">
        <doc xml:space="preserve">Returns a list of the #GDataGDReminder&lt;!-- --&gt;s which are associated with this #GDataGDWhen.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataGDReminder&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="GDReminder"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhen</doc>
            <type name="GDWhen" c:type="GDataGDWhen*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_start_time"
              c:identifier="gdata_gd_when_get_start_time"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDWhen:start-time property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the start time of the event</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhen</doc>
            <type name="GDWhen" c:type="GDataGDWhen*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_value_string"
              c:identifier="gdata_gd_when_get_value_string"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDWhen:value-string property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the value string, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhen</doc>
            <type name="GDWhen" c:type="GDataGDWhen*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_date"
              c:identifier="gdata_gd_when_is_date"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDWhen:is-date property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if #GDataGDWhen:start-time and #GDataGDWhen:end-time are dates rather than times, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhen</doc>
            <type name="GDWhen" c:type="GDataGDWhen*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_end_time"
              c:identifier="gdata_gd_when_set_end_time"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDWhen:end-time property to @end_time.

Set @end_time to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhen</doc>
            <type name="GDWhen" c:type="GDataGDWhen*"/>
          </instance-parameter>
          <parameter name="end_time" transfer-ownership="none">
            <doc xml:space="preserve">the new end time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_date"
              c:identifier="gdata_gd_when_set_is_date"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDWhen:is-date property to @is_date.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhen</doc>
            <type name="GDWhen" c:type="GDataGDWhen*"/>
          </instance-parameter>
          <parameter name="is_date" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if #GDataGDWhen:start-time and #GDataGDWhen:end-time should be dates rather than times, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_start_time"
              c:identifier="gdata_gd_when_set_start_time"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDWhen:start-time property to @start_time.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhen</doc>
            <type name="GDWhen" c:type="GDataGDWhen*"/>
          </instance-parameter>
          <parameter name="start_time" transfer-ownership="none">
            <doc xml:space="preserve">the new start time</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_value_string"
              c:identifier="gdata_gd_when_set_value_string"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDWhen:value-string property to @value_string.

Set @value_string to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhen</doc>
            <type name="GDWhen" c:type="GDataGDWhen*"/>
          </instance-parameter>
          <parameter name="value_string"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new value string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="end-time"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The title of a person within the when.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWhen"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="is-date"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A programmatic value that identifies the type of when.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWhen"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="start-time"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The name of the when.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWhen"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="value-string"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A simple string value used to name this when. It allows UIs to display a label such as "Work", "Volunteer",
"Professional Society", etc.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWhen"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GDWhenPrivate" c:type="GDataGDWhenPrivate*"/>
      </field>
    </class>
    <record name="GDWhenClass"
            c:type="GDataGDWhenClass"
            glib:is-gtype-struct-for="GDWhen"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataGDWhenClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GDWhenPrivate" c:type="GDataGDWhenPrivate" disguised="1">
    </record>
    <class name="GDWhere"
           c:symbol-prefix="gd_where"
           c:type="GDataGDWhere"
           version="0.2.0"
           parent="Parsable"
           glib:type-name="GDataGDWhere"
           glib:get-type="gdata_gd_where_get_type"
           glib:type-struct="GDWhereClass">
      <doc xml:space="preserve">All the fields in the #GDataGDWhere structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new"
                   c:identifier="gdata_gd_where_new"
                   version="0.2.0">
        <doc xml:space="preserve">Creates a new #GDataGDWhere. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWhere"&gt;GData specification&lt;/ulink&gt;.

Currently, entryLink functionality is not implemented in #GDataGDWhere.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGDWhere; unref with g_object_unref()</doc>
          <type name="GDWhere" c:type="GDataGDWhere*"/>
        </return-value>
        <parameters>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the relationship between the item and this place, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="value_string"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a string to represent the place, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a human-readable label for the place, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_label"
              c:identifier="gdata_gd_where_get_label"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDWhere:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the label, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhere</doc>
            <type name="GDWhere" c:type="GDataGDWhere*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gd_where_get_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDWhere:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the relation type, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhere</doc>
            <type name="GDWhere" c:type="GDataGDWhere*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_value_string"
              c:identifier="gdata_gd_where_get_value_string"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDWhere:value-string property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the value string, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhere</doc>
            <type name="GDWhere" c:type="GDataGDWhere*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_gd_where_set_label"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDWhere:label property to @label.

Set @label to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhere</doc>
            <type name="GDWhere" c:type="GDataGDWhere*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new label, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gd_where_set_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDWhere:relation-type property to @relation_type.

Set @relation_type to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhere</doc>
            <type name="GDWhere" c:type="GDataGDWhere*"/>
          </instance-parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new relation type, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_value_string"
              c:identifier="gdata_gd_where_set_value_string"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDWhere:value-string property to @value_string.

Set @value_string to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWhere</doc>
            <type name="GDWhere" c:type="GDataGDWhere*"/>
          </instance-parameter>
          <parameter name="value_string"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new value string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="label"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies a user-readable label to distinguish this location from others.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWhere"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies the relationship between the containing entity and the contained location. For example: %GDATA_GD_WHERE_EVENT or
%GDATA_GD_WHERE_EVENT_PARKING.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWhere"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="value-string"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A simple string representation of this location.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWhere"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GDWherePrivate" c:type="GDataGDWherePrivate*"/>
      </field>
    </class>
    <record name="GDWhereClass"
            c:type="GDataGDWhereClass"
            glib:is-gtype-struct-for="GDWhere"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataGDWhereClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GDWherePrivate" c:type="GDataGDWherePrivate" disguised="1">
    </record>
    <class name="GDWho"
           c:symbol-prefix="gd_who"
           c:type="GDataGDWho"
           version="0.2.0"
           parent="Parsable"
           glib:type-name="GDataGDWho"
           glib:get-type="gdata_gd_who_get_type"
           glib:type-struct="GDWhoClass">
      <doc xml:space="preserve">All the fields in the #GDataGDWho structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new" c:identifier="gdata_gd_who_new" version="0.2.0">
        <doc xml:space="preserve">Creates a new #GDataGDWho. More information is available in the &lt;ulink type="http"
url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWho"&gt;GData specification&lt;/ulink&gt;.

Currently, entryLink functionality is not implemented in #GDataGDWho.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGDWho; unref with g_object_unref()</doc>
          <type name="GDWho" c:type="GDataGDWho*"/>
        </return-value>
        <parameters>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the relationship between the item and this person, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="value_string"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a string to represent the person, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="email_address"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the person's e-mail address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_email_address"
              c:identifier="gdata_gd_who_get_email_address"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDWho:email-address property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the e-mail address, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWho</doc>
            <type name="GDWho" c:type="GDataGDWho*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_gd_who_get_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDWho:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the relation type, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWho</doc>
            <type name="GDWho" c:type="GDataGDWho*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_value_string"
              c:identifier="gdata_gd_who_get_value_string"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGDWho:value-string property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the value string, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWho</doc>
            <type name="GDWho" c:type="GDataGDWho*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_email_address"
              c:identifier="gdata_gd_who_set_email_address"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDWho:email-address property to @email_address.

Set @email_address to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWho</doc>
            <type name="GDWho" c:type="GDataGDWho*"/>
          </instance-parameter>
          <parameter name="email_address"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new e-mail address, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_gd_who_set_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDWho:relation-type property to @relation_type.

Set @relation_type to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWho</doc>
            <type name="GDWho" c:type="GDataGDWho*"/>
          </instance-parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new relation type, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_value_string"
              c:identifier="gdata_gd_who_set_value_string"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataGDWho:value-string property to @value_string.

Set @value_string to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGDWho</doc>
            <type name="GDWho" c:type="GDataGDWho*"/>
          </instance-parameter>
          <parameter name="value_string"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new value string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="email-address"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The e-mail address of the person represented by the #GDataGDWho.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWho"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="relation-type"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies the relationship between the containing entity and the contained person. For example: %GDATA_GD_WHO_EVENT_PERFORMER or
%GDATA_GD_WHO_EVENT_ATTENDEE.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWho"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="value-string"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A simple string representation of this person.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/elements.html#gdWho"&gt;GData specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GDWhoPrivate" c:type="GDataGDWhoPrivate*"/>
      </field>
    </class>
    <record name="GDWhoClass"
            c:type="GDataGDWhoClass"
            glib:is-gtype-struct-for="GDWho"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataGDWhoClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GDWhoPrivate" c:type="GDataGDWhoPrivate" disguised="1">
    </record>
    <constant name="GD_ADDRESS_USAGE_GENERAL"
              value="http://schemas.google.com/g/2005#general"
              c:type="GDATA_GD_ADDRESS_USAGE_GENERAL"
              version="0.5.0">
      <doc xml:space="preserve">The address is for general usage. Value for #GDataGDPostalAddress:usage.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_ADDRESS_USAGE_LOCAL"
              value="http://schemas.google.com/g/2005#local"
              c:type="GDATA_GD_ADDRESS_USAGE_LOCAL"
              version="0.5.0">
      <doc xml:space="preserve">The address is for local usage. Value for #GDataGDPostalAddress:usage.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_EMAIL_ADDRESS_HOME"
              value="http://schemas.google.com/g/2005#home"
              c:type="GDATA_GD_EMAIL_ADDRESS_HOME"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a home e-mail address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_EMAIL_ADDRESS_OTHER"
              value="http://schemas.google.com/g/2005#other"
              c:type="GDATA_GD_EMAIL_ADDRESS_OTHER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a miscellaneous e-mail address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_EMAIL_ADDRESS_WORK"
              value="http://schemas.google.com/g/2005#work"
              c:type="GDATA_GD_EMAIL_ADDRESS_WORK"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a work e-mail address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_EVENT_STATUS_CANCELED"
              value="http://schemas.google.com/g/2005#event.canceled"
              c:type="GDATA_GD_EVENT_STATUS_CANCELED"
              version="0.7.0">
      <doc xml:space="preserve">The event has been canceled.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_EVENT_STATUS_CONFIRMED"
              value="http://schemas.google.com/g/2005#event.confirmed"
              c:type="GDATA_GD_EVENT_STATUS_CONFIRMED"
              version="0.7.0">
      <doc xml:space="preserve">The event has been planned and confirmed.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_EVENT_STATUS_TENTATIVE"
              value="http://schemas.google.com/g/2005#event.tentative"
              c:type="GDATA_GD_EVENT_STATUS_TENTATIVE"
              version="0.7.0">
      <doc xml:space="preserve">The event has been planned, but only tentatively scheduled.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_EVENT_TRANSPARENCY_OPAQUE"
              value="http://schemas.google.com/g/2005#event.opaque"
              c:type="GDATA_GD_EVENT_TRANSPARENCY_OPAQUE"
              version="0.7.0">
      <doc xml:space="preserve">The event consumes time in calendars; its time will be marked as busy in a free/busy search.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_EVENT_TRANSPARENCY_TRANSPARENT"
              value="http://schemas.google.com/g/2005#event.transparent"
              c:type="GDATA_GD_EVENT_TRANSPARENCY_TRANSPARENT"
              version="0.7.0">
      <doc xml:space="preserve">The event does not consume time in calendars; its time will be not marked as busy in a free/busy search.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_EVENT_VISIBILITY_CONFIDENTIAL"
              value="http://schemas.google.com/g/2005#event.confidential"
              c:type="GDATA_GD_EVENT_VISIBILITY_CONFIDENTIAL"
              version="0.7.0">
      <doc xml:space="preserve">The event is visible to only certain people.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_EVENT_VISIBILITY_DEFAULT"
              value="http://schemas.google.com/g/2005#event.default"
              c:type="GDATA_GD_EVENT_VISIBILITY_DEFAULT"
              version="0.7.0">
      <doc xml:space="preserve">The event's visibility is inherited from the preferences of its owner.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_EVENT_VISIBILITY_PRIVATE"
              value="http://schemas.google.com/g/2005#event.private"
              c:type="GDATA_GD_EVENT_VISIBILITY_PRIVATE"
              version="0.7.0">
      <doc xml:space="preserve">The event is visible to very few people.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_EVENT_VISIBILITY_PUBLIC"
              value="http://schemas.google.com/g/2005#event.public"
              c:type="GDATA_GD_EVENT_VISIBILITY_PUBLIC"
              version="0.7.0">
      <doc xml:space="preserve">The event is visible to most people.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_IM_ADDRESS_HOME"
              value="http://schemas.google.com/g/2005#home"
              c:type="GDATA_GD_IM_ADDRESS_HOME"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a home IM address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_IM_ADDRESS_NETMEETING"
              value="http://schemas.google.com/g/2005#netmeeting"
              c:type="GDATA_GD_IM_ADDRESS_NETMEETING"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a Microsoft NetMeeting IM address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_IM_ADDRESS_OTHER"
              value="http://schemas.google.com/g/2005#other"
              c:type="GDATA_GD_IM_ADDRESS_OTHER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a miscellaneous IM address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_IM_ADDRESS_WORK"
              value="http://schemas.google.com/g/2005#work"
              c:type="GDATA_GD_IM_ADDRESS_WORK"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a work IM address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_IM_PROTOCOL_AIM"
              value="http://schemas.google.com/g/2005#AIM"
              c:type="GDATA_GD_IM_PROTOCOL_AIM"
              version="0.7.0">
      <doc xml:space="preserve">The protocol type URI for an AIM IM address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_IM_PROTOCOL_GOOGLE_TALK"
              value="http://schemas.google.com/g/2005#GOOGLE_TALK"
              c:type="GDATA_GD_IM_PROTOCOL_GOOGLE_TALK"
              version="0.7.0">
      <doc xml:space="preserve">The protocol type URI for a Google Talk IM address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_IM_PROTOCOL_ICQ"
              value="http://schemas.google.com/g/2005#ICQ"
              c:type="GDATA_GD_IM_PROTOCOL_ICQ"
              version="0.7.0">
      <doc xml:space="preserve">The protocol type URI for an ICQ IM address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_IM_PROTOCOL_JABBER"
              value="http://schemas.google.com/g/2005#JABBER"
              c:type="GDATA_GD_IM_PROTOCOL_JABBER"
              version="0.7.0">
      <doc xml:space="preserve">The protocol type URI for a Jabber IM address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_IM_PROTOCOL_LIVE_MESSENGER"
              value="http://schemas.google.com/g/2005#MSN"
              c:type="GDATA_GD_IM_PROTOCOL_LIVE_MESSENGER"
              version="0.7.0">
      <doc xml:space="preserve">The protocol type URI for an Windows Live Messenger IM address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_IM_PROTOCOL_QQ"
              value="http://schemas.google.com/g/2005#QQ"
              c:type="GDATA_GD_IM_PROTOCOL_QQ"
              version="0.7.0">
      <doc xml:space="preserve">The protocol type URI for a QQ IM address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_IM_PROTOCOL_SKYPE"
              value="http://schemas.google.com/g/2005#SKYPE"
              c:type="GDATA_GD_IM_PROTOCOL_SKYPE"
              version="0.7.0">
      <doc xml:space="preserve">The protocol type URI for a Skype IM address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_IM_PROTOCOL_YAHOO_MESSENGER"
              value="http://schemas.google.com/g/2005#YAHOO"
              c:type="GDATA_GD_IM_PROTOCOL_YAHOO_MESSENGER"
              version="0.7.0">
      <doc xml:space="preserve">The protocol type URI for a Yahoo! Messenger IM address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_MAIL_CLASS_BOTH"
              value="http://schemas.google.com/g/2005#both"
              c:type="GDATA_GD_MAIL_CLASS_BOTH"
              version="0.5.0">
      <doc xml:space="preserve">Parcels and letters can be sent to the address. Value for #GDataGDPostalAddress:mail-class.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_MAIL_CLASS_LETTERS"
              value="http://schemas.google.com/g/2005#letters"
              c:type="GDATA_GD_MAIL_CLASS_LETTERS"
              version="0.5.0">
      <doc xml:space="preserve">Only letters can be sent to the address. Value for #GDataGDPostalAddress:mail-class.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_MAIL_CLASS_NEITHER"
              value="http://schemas.google.com/g/2005#neither"
              c:type="GDATA_GD_MAIL_CLASS_NEITHER"
              version="0.5.0">
      <doc xml:space="preserve">Address is purely locational and cannot be used for mail. Value for #GDataGDPostalAddress:mail-class.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_MAIL_CLASS_PARCELS"
              value="http://schemas.google.com/g/2005#parcels"
              c:type="GDATA_GD_MAIL_CLASS_PARCELS"
              version="0.5.0">
      <doc xml:space="preserve">Only parcels can be sent to the address. Value for #GDataGDPostalAddress:mail-class.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_ORGANIZATION_OTHER"
              value="http://schemas.google.com/g/2005#other"
              c:type="GDATA_GD_ORGANIZATION_OTHER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a miscellaneous organization.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_ORGANIZATION_WORK"
              value="http://schemas.google.com/g/2005#work"
              c:type="GDATA_GD_ORGANIZATION_WORK"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a work organization.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_ASSISTANT"
              value="http://schemas.google.com/g/2005#assistant"
              c:type="GDATA_GD_PHONE_NUMBER_ASSISTANT"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of an assistant.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_CALLBACK"
              value="http://schemas.google.com/g/2005#callback"
              c:type="GDATA_GD_PHONE_NUMBER_CALLBACK"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a callback service.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_CAR"
              value="http://schemas.google.com/g/2005#car"
              c:type="GDATA_GD_PHONE_NUMBER_CAR"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a car phone.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_COMPANY_MAIN"
              value="http://schemas.google.com/g/2005#company_main"
              c:type="GDATA_GD_PHONE_NUMBER_COMPANY_MAIN"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the main phone number of a company.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_FAX"
              value="http://schemas.google.com/g/2005#fax"
              c:type="GDATA_GD_PHONE_NUMBER_FAX"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a fax machine.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_HOME"
              value="http://schemas.google.com/g/2005#home"
              c:type="GDATA_GD_PHONE_NUMBER_HOME"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a home phone number.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_HOME_FAX"
              value="http://schemas.google.com/g/2005#home_fax"
              c:type="GDATA_GD_PHONE_NUMBER_HOME_FAX"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a home fax machine.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_ISDN"
              value="http://schemas.google.com/g/2005#isdn"
              c:type="GDATA_GD_PHONE_NUMBER_ISDN"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of an ISDN phone.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_MAIN"
              value="http://schemas.google.com/g/2005#main"
              c:type="GDATA_GD_PHONE_NUMBER_MAIN"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the main phone number of a person.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_MOBILE"
              value="http://schemas.google.com/g/2005#mobile"
              c:type="GDATA_GD_PHONE_NUMBER_MOBILE"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a mobile phone.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_OTHER"
              value="http://schemas.google.com/g/2005#other"
              c:type="GDATA_GD_PHONE_NUMBER_OTHER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a miscellaneous phone number.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_OTHER_FAX"
              value="http://schemas.google.com/g/2005#other_fax"
              c:type="GDATA_GD_PHONE_NUMBER_OTHER_FAX"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a miscellaneous fax machine's phone number.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_PAGER"
              value="http://schemas.google.com/g/2005#pager"
              c:type="GDATA_GD_PHONE_NUMBER_PAGER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a pager.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_RADIO"
              value="http://schemas.google.com/g/2005#radio"
              c:type="GDATA_GD_PHONE_NUMBER_RADIO"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a radio phone.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_TELEX"
              value="http://schemas.google.com/g/2005#telex"
              c:type="GDATA_GD_PHONE_NUMBER_TELEX"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a telex machine.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_TTY_TDD"
              value="http://schemas.google.com/g/2005#tty_tdd"
              c:type="GDATA_GD_PHONE_NUMBER_TTY_TDD"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a TTY TTD.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_WORK"
              value="http://schemas.google.com/g/2005#work"
              c:type="GDATA_GD_PHONE_NUMBER_WORK"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a work place.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_WORK_FAX"
              value="http://schemas.google.com/g/2005#work_fax"
              c:type="GDATA_GD_PHONE_NUMBER_WORK_FAX"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a work fax machine.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_WORK_MOBILE"
              value="http://schemas.google.com/g/2005#work_mobile"
              c:type="GDATA_GD_PHONE_NUMBER_WORK_MOBILE"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a work mobile phone.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_PHONE_NUMBER_WORK_PAGER"
              value="http://schemas.google.com/g/2005#work_pager"
              c:type="GDATA_GD_PHONE_NUMBER_WORK_PAGER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the phone number of a work pager.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_POSTAL_ADDRESS_HOME"
              value="http://schemas.google.com/g/2005#home"
              c:type="GDATA_GD_POSTAL_ADDRESS_HOME"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the postal address of a home.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_POSTAL_ADDRESS_OTHER"
              value="http://schemas.google.com/g/2005#other"
              c:type="GDATA_GD_POSTAL_ADDRESS_OTHER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a miscellaneous postal address.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_POSTAL_ADDRESS_WORK"
              value="http://schemas.google.com/g/2005#work"
              c:type="GDATA_GD_POSTAL_ADDRESS_WORK"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the postal address of a workplace.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_REMINDER_ALERT"
              value="alert"
              c:type="GDATA_GD_REMINDER_ALERT"
              version="0.7.0">
      <doc xml:space="preserve">The #GDataGDReminder:method for an alert to appear in the user's browser.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_REMINDER_EMAIL"
              value="email"
              c:type="GDATA_GD_REMINDER_EMAIL"
              version="0.7.0">
      <doc xml:space="preserve">The #GDataGDReminder:method for an alert to be sent to the user by e-mail.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_REMINDER_SMS"
              value="sms"
              c:type="GDATA_GD_REMINDER_SMS"
              version="0.7.0">
      <doc xml:space="preserve">The #GDataGDReminder:method for an alert to be sent to the user by SMS.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_WHERE_EVENT"
              value="http://schemas.google.com/g/2005#event"
              c:type="GDATA_GD_WHERE_EVENT"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for an event location.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_WHERE_EVENT_ALTERNATE"
              value="http://schemas.google.com/g/2005#event.alternate"
              c:type="GDATA_GD_WHERE_EVENT_ALTERNATE"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for an alternate event location, such as a video conference site.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_WHERE_EVENT_PARKING"
              value="http://schemas.google.com/g/2005#event.parking"
              c:type="GDATA_GD_WHERE_EVENT_PARKING"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for an event's parking lot.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_WHO_EVENT_ATTENDEE"
              value="http://schemas.google.com/g/2005#event.attendee"
              c:type="GDATA_GD_WHO_EVENT_ATTENDEE"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a general meeting or event attendee.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_WHO_EVENT_ORGANIZER"
              value="http://schemas.google.com/g/2005#event.organizer"
              c:type="GDATA_GD_WHO_EVENT_ORGANIZER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for an event organizer (not necessarily an attendee).</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_WHO_EVENT_PERFORMER"
              value="http://schemas.google.com/g/2005#event.performer"
              c:type="GDATA_GD_WHO_EVENT_PERFORMER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for an event performer, which is similar to %GDATA_GD_WHO_EVENT_SPEAKER, but with more emphasis on art rather than speaking.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="GD_WHO_EVENT_SPEAKER"
              value="http://schemas.google.com/g/2005#event.speaker"
              c:type="GDATA_GD_WHO_EVENT_SPEAKER"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for a speaker at an event.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <class name="Generator"
           c:symbol-prefix="generator"
           c:type="GDataGenerator"
           parent="Parsable"
           glib:type-name="GDataGenerator"
           glib:get-type="gdata_generator_get_type"
           glib:type-struct="GeneratorClass">
      <doc xml:space="preserve">All the fields in the #GDataGenerator structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <method name="get_name"
              c:identifier="gdata_generator_get_name"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGenerator:name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the generator's name</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGenerator</doc>
            <type name="Generator" c:type="GDataGenerator*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_uri"
              c:identifier="gdata_generator_get_uri"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGenerator:uri property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the generator's URI, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGenerator</doc>
            <type name="Generator" c:type="GDataGenerator*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_version"
              c:identifier="gdata_generator_get_version"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataGenerator:version property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the generator's version, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGenerator</doc>
            <type name="Generator" c:type="GDataGenerator*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="name" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">A human-readable name for the generating agent.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.generator"&gt;
Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="uri" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">An IRI reference that is relevant to the agent.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.generator"&gt;
Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="version" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">Indicates the version of the generating agent.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.generator"&gt;
Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="GeneratorPrivate" c:type="GDataGeneratorPrivate*"/>
      </field>
    </class>
    <record name="GeneratorClass"
            c:type="GDataGeneratorClass"
            glib:is-gtype-struct-for="Generator"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataGeneratorClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GeneratorPrivate"
            c:type="GDataGeneratorPrivate"
            disguised="1">
    </record>
    <class name="GoaAuthorizer"
           c:symbol-prefix="goa_authorizer"
           c:type="GDataGoaAuthorizer"
           version="0.13.1"
           parent="GObject.Object"
           glib:type-name="GDataGoaAuthorizer"
           glib:get-type="gdata_goa_authorizer_get_type"
           glib:type-struct="GoaAuthorizerClass">
      <doc xml:space="preserve">All the fields in the #GDataGoaAuthorizer structure are private and should never be accessed directly.</doc>
      <implements name="Authorizer"/>
      <constructor name="new"
                   c:identifier="gdata_goa_authorizer_new"
                   version="0.13.1">
        <doc xml:space="preserve">Create a new #GDataGoaAuthorizer using the authentication token from the given @goa_object.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataGoaAuthorizer; unref with g_object_unref()</doc>
          <type name="GoaAuthorizer" c:type="GDataGoaAuthorizer*"/>
        </return-value>
        <parameters>
          <parameter name="goa_object" transfer-ownership="none">
            <doc xml:space="preserve">the GOA account providing authentication</doc>
            <type name="Goa.Object" c:type="GoaObject*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_goa_object"
              c:identifier="gdata_goa_authorizer_get_goa_object"
              version="0.13.1">
        <doc xml:space="preserve">The GOA account providing authentication. This is the same as #GDataGoaAuthorizer:goa-object.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the GOA account providing authentication</doc>
          <type name="Goa.Object" c:type="GoaObject*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataGoaAuthorizer</doc>
            <type name="GoaAuthorizer" c:type="GDataGoaAuthorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="goa-object"
                version="0.13.1"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The GOA account providing authentication. This should have all the necessary services enabled on it.</doc>
        <type name="Goa.Object"/>
      </property>
      <field name="parent" readable="0" private="1">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="GoaAuthorizerPrivate" c:type="GDataGoaAuthorizerPrivate*"/>
      </field>
    </class>
    <record name="GoaAuthorizerClass"
            c:type="GDataGoaAuthorizerClass"
            glib:is-gtype-struct-for="GoaAuthorizer"
            version="0.13.1">
      <doc xml:space="preserve">All the fields in the #GDataGoaAuthorizerClass structure are private and should never be accessed directly.</doc>
      <field name="parent_class" readable="0" private="1">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="GoaAuthorizerPrivate"
            c:type="GDataGoaAuthorizerPrivate"
            disguised="1">
    </record>
    <constant name="LINK_ACCESS_CONTROL_LIST"
              value="http://schemas.google.com/acl/2007#accessControlList"
              c:type="GDATA_LINK_ACCESS_CONTROL_LIST"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI of the access control list location for this resource.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/calendar/data/2.0/developers_guide_protocol.html#SharingACalendar"&gt;ACL specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="LINK_ALTERNATE"
              value="http://www.iana.org/assignments/relation/alternate"
              c:type="GDATA_LINK_ALTERNATE"
              version="0.4.0">
      <doc xml:space="preserve">The relation type URI for alternate resources to the current one.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rel_attribute"&gt;
Atom specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="LINK_BATCH"
              value="http://schemas.google.com/g/2005#batch"
              c:type="GDATA_LINK_BATCH"
              version="0.7.0">
      <doc xml:space="preserve">The relation type URI for the batch operation URI for a given #GDataFeed.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/batch.html#Submit_HTTP"&gt;GData specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="LINK_EDIT"
              value="http://www.iana.org/assignments/relation/edit"
              c:type="GDATA_LINK_EDIT"
              version="0.4.0">
      <doc xml:space="preserve">The relation type URI of the edit location for this resource.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/protocol/atom-protocol-spec.php#new-link-relation"&gt;
Atom Publishing Protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="LINK_EDIT_MEDIA"
              value="http://www.iana.org/assignments/relation/edit-media"
              c:type="GDATA_LINK_EDIT_MEDIA"
              version="0.4.0">
      <doc xml:space="preserve">The relation type URI of the edit location for media resources attached to this resource.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/protocol/atom-protocol-spec.php#new-media-link-relation"&gt;
Atom Publishing Protocol specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="LINK_ENCLOSURE"
              value="http://www.iana.org/assignments/relation/enclosure"
              c:type="GDATA_LINK_ENCLOSURE"
              version="0.4.0">
      <doc xml:space="preserve">The relation type URI for attached objects which may be large in size.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rel_attribute"&gt;
Atom specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="LINK_PARENT"
              value="http://schemas.google.com/docs/2007#parent"
              c:type="GDATA_LINK_PARENT"
              version="0.15.1">
      <doc xml:space="preserve">The relation type URI of the of the location of the parent resource in a
hierarchy of entries.

This is an undocumented GData-specific addition to the Atom specification,
and is not included in the GData documentation except in examples and in the
&lt;ulink type="http" url="https://developers.google.com/google-apps/documents-list/v2/schema/document_list_atom.rnc"&gt;
RelaxNG schema&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="LINK_RELATED"
              value="http://www.iana.org/assignments/relation/related"
              c:type="GDATA_LINK_RELATED"
              version="0.4.0">
      <doc xml:space="preserve">The relation type URI for resources related to the current one.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rel_attribute"&gt;
Atom specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="LINK_RESUMABLE_CREATE_MEDIA"
              value="http://schemas.google.com/g/2005#resumable-create-media"
              c:type="GDATA_LINK_RESUMABLE_CREATE_MEDIA"
              version="0.13.0">
      <doc xml:space="preserve">The relation type URI of the resumable upload location for resources attached to this resource.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/resumable_upload.html#ResumableUploadInitiate"&gt;GData resumable upload protocol
specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="LINK_RESUMABLE_EDIT_MEDIA"
              value="http://schemas.google.com/g/2005#resumable-edit-media"
              c:type="GDATA_LINK_RESUMABLE_EDIT_MEDIA"
              version="0.13.0">
      <doc xml:space="preserve">The relation type URI of the resumable update location for resources attached to this resource.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/resumable_upload.html#ResumableUploadInitiate"&gt;GData resumable upload protocol
specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="LINK_SELF"
              value="http://www.iana.org/assignments/relation/self"
              c:type="GDATA_LINK_SELF"
              version="0.4.0">
      <doc xml:space="preserve">The relation type URI for the current resource.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rel_attribute"&gt;
Atom specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="LINK_VIA"
              value="http://www.iana.org/assignments/relation/via"
              c:type="GDATA_LINK_VIA"
              version="0.4.0">
      <doc xml:space="preserve">The relation type URI for the source document of the current resource.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rel_attribute"&gt;
Atom specification&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <class name="Link"
           c:symbol-prefix="link"
           c:type="GDataLink"
           parent="Parsable"
           glib:type-name="GDataLink"
           glib:get-type="gdata_link_get_type"
           glib:type-struct="LinkClass">
      <doc xml:space="preserve">All the fields in the #GDataLink structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <constructor name="new" c:identifier="gdata_link_new">
        <doc xml:space="preserve">Creates a new #GDataLink. More information is available in the &lt;ulink type="http"
url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.link"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataLink, or %NULL; unref with g_object_unref()</doc>
          <type name="Link" c:type="GDataLink*"/>
        </return-value>
        <parameters>
          <parameter name="uri" transfer-ownership="none">
            <doc xml:space="preserve">the link's IRI</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the relationship of the link to the current document, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_content_type"
              c:identifier="gdata_link_get_content_type"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataLink:content-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the link's content type, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink</doc>
            <type name="Link" c:type="GDataLink*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_language"
              c:identifier="gdata_link_get_language"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataLink:language property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the link's language, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink</doc>
            <type name="Link" c:type="GDataLink*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_length"
              c:identifier="gdata_link_get_length"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataLink:length property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the link's length, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink</doc>
            <type name="Link" c:type="GDataLink*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_relation_type"
              c:identifier="gdata_link_get_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataLink:relation-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the link's relation type</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink</doc>
            <type name="Link" c:type="GDataLink*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_title"
              c:identifier="gdata_link_get_title"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataLink:title property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the link's title, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink</doc>
            <type name="Link" c:type="GDataLink*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_uri" c:identifier="gdata_link_get_uri" version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataLink:uri property. The return value is guaranteed to be a valid IRI, as
specified by the Atom protocol. Common relationship values such as &lt;literal&gt;alternate&lt;/literal&gt;
are returned as &lt;literal&gt;http://www.iana.org/assignments/relation/alternate&lt;/literal&gt;.

For more information, see the &lt;ulink type="http" uri="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#rel_attribute"&gt;
Atom specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the link's URI</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink</doc>
            <type name="Link" c:type="GDataLink*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_content_type"
              c:identifier="gdata_link_set_content_type"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataLink:content-type property to @content_type.

Set @content_type to %NULL to unset the property in the link.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink</doc>
            <type name="Link" c:type="GDataLink*"/>
          </instance-parameter>
          <parameter name="content_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new content type for the link, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_language"
              c:identifier="gdata_link_set_language"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataLink:language property to @language.

Set @language to %NULL to unset the property in the link.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink</doc>
            <type name="Link" c:type="GDataLink*"/>
          </instance-parameter>
          <parameter name="language"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new language for the link, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_length"
              c:identifier="gdata_link_set_length"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataLink:length property to @length.

Set @length to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the link.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink</doc>
            <type name="Link" c:type="GDataLink*"/>
          </instance-parameter>
          <parameter name="length" transfer-ownership="none">
            <doc xml:space="preserve">the new length for the link, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_relation_type"
              c:identifier="gdata_link_set_relation_type"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataLink:relation-type property to @relation_type. If @relation_type is one of the standard Atom relation types,
use one of the defined relation type values, instead of a static string. e.g. %GDATA_LINK_EDIT or %GDATA_LINK_SELF.

Set @relation_type to %NULL to unset the property in the link.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink</doc>
            <type name="Link" c:type="GDataLink*"/>
          </instance-parameter>
          <parameter name="relation_type"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new relation type for the link, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_title"
              c:identifier="gdata_link_set_title"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataLink:title property to @title.

Set @title to %NULL to unset the property in the link.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink</doc>
            <type name="Link" c:type="GDataLink*"/>
          </instance-parameter>
          <parameter name="title"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new title for the link, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_uri" c:identifier="gdata_link_set_uri" version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataLink:uri property to @uri.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataLink</doc>
            <type name="Link" c:type="GDataLink*"/>
          </instance-parameter>
          <parameter name="uri" transfer-ownership="none">
            <doc xml:space="preserve">the new URI for the link</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="content-type"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An advisory media type: it is a hint about the type of the representation that is expected to be returned when the value
of the #GDataLink:uri property is dereferenced.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.link"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="language"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Describes the language of the resource pointed to by the #GDataLink:uri property.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.link"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="length"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates an advisory length of the linked content in octets. &lt;code class="literal"&gt;-1&lt;/code&gt; means the length is unspecified.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.link"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="gint" c:type="gint"/>
      </property>
      <property name="relation-type"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The link relation type.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.link"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="title"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Conveys human-readable information about the link.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.link"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="uri"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The link's IRI.

For more information, see the
&lt;ulink type="http" url="http://www.atomenabled.org/developers/syndication/atom-format-spec.php#element.link"&gt;Atom specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="LinkPrivate" c:type="GDataLinkPrivate*"/>
      </field>
    </class>
    <record name="LinkClass"
            c:type="GDataLinkClass"
            glib:is-gtype-struct-for="Link"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataLinkClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="LinkPrivate" c:type="GDataLinkPrivate" disguised="1">
    </record>
    <constant name="MAJOR_VERSION"
              value="0"
              c:type="GDATA_MAJOR_VERSION"
              version="0.11.0">
      <doc xml:space="preserve">Evaluates to the major version of the GData headers at compile time.
(e.g. in libgdata version 1.2.3 this is 1).</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="MICRO_VERSION"
              value="4"
              c:type="GDATA_MICRO_VERSION"
              version="0.11.0">
      <doc xml:space="preserve">Evaluates to the micro version of the GData headers at compile time.
(e.g. in libgdata version 1.2.3 this is 3).</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <constant name="MINOR_VERSION"
              value="17"
              c:type="GDATA_MINOR_VERSION"
              version="0.11.0">
      <doc xml:space="preserve">Evaluates to the minor version of the GData headers at compile time.
(e.g. in libgdata version 1.2.3 this is 2).</doc>
      <type name="gint" c:type="gint"/>
    </constant>
    <class name="MediaCategory"
           c:symbol-prefix="media_category"
           c:type="GDataMediaCategory"
           parent="Parsable"
           glib:type-name="GDataMediaCategory"
           glib:get-type="gdata_media_category_get_type"
           glib:type-struct="MediaCategoryClass">
      <doc xml:space="preserve">All the fields in the #GDataMediaCategory structure are private and should never be accessed directly.</doc>
      <constructor name="new" c:identifier="gdata_media_category_new">
        <doc xml:space="preserve">Creates a new #GDataMediaCategory. More information is available in the &lt;ulink type="http"
url="http://search.yahoo.com/mrss/"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataMediaCategory, or %NULL; unref with g_object_unref()</doc>
          <type name="MediaCategory" c:type="GDataMediaCategory*"/>
        </return-value>
        <parameters>
          <parameter name="category" transfer-ownership="none">
            <doc xml:space="preserve">a category describing the content</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="scheme"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a URI identifying the categorisation scheme, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a human-readable name for the category, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_category"
              c:identifier="gdata_media_category_get_category"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaCategory:category property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the actual category</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaCategory</doc>
            <type name="MediaCategory" c:type="GDataMediaCategory*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_label"
              c:identifier="gdata_media_category_get_label"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaCategory:label property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the category's label, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaCategory</doc>
            <type name="MediaCategory" c:type="GDataMediaCategory*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_scheme"
              c:identifier="gdata_media_category_get_scheme"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaCategory:scheme property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the category's scheme, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaCategory</doc>
            <type name="MediaCategory" c:type="GDataMediaCategory*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_category"
              c:identifier="gdata_media_category_set_category"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataMediaCategory:category property to @category.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaCategory</doc>
            <type name="MediaCategory" c:type="GDataMediaCategory*"/>
          </instance-parameter>
          <parameter name="category" transfer-ownership="none">
            <doc xml:space="preserve">the new category</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_label"
              c:identifier="gdata_media_category_set_label"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataMediaCategory:label property to @label.

Set @label to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaCategory</doc>
            <type name="MediaCategory" c:type="GDataMediaCategory*"/>
          </instance-parameter>
          <parameter name="label"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the category's new label, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_scheme"
              c:identifier="gdata_media_category_set_scheme"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataMediaCategory:scheme property to @scheme.

Set @scheme to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaCategory</doc>
            <type name="MediaCategory" c:type="GDataMediaCategory*"/>
          </instance-parameter>
          <parameter name="scheme"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the category's new scheme, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="category"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The category name.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="label"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A human-readable label that can be displayed in end-user applications.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="scheme"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A URI that identifies the categorization scheme.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="MediaCategoryPrivate" c:type="GDataMediaCategoryPrivate*"/>
      </field>
    </class>
    <record name="MediaCategoryClass"
            c:type="GDataMediaCategoryClass"
            glib:is-gtype-struct-for="MediaCategory"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataMediaCategoryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="MediaCategoryPrivate"
            c:type="GDataMediaCategoryPrivate"
            disguised="1">
    </record>
    <class name="MediaContent"
           c:symbol-prefix="media_content"
           c:type="GDataMediaContent"
           parent="Parsable"
           glib:type-name="GDataMediaContent"
           glib:get-type="gdata_media_content_get_type"
           glib:type-struct="MediaContentClass">
      <doc xml:space="preserve">All the fields in the #GDataMediaContent structure are private and should never be accessed directly.</doc>
      <method name="download"
              c:identifier="gdata_media_content_download"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Downloads and returns a #GDataDownloadStream allowing the content represented by @self to be read.

To get the content type of the downloaded data, gdata_download_stream_get_content_type() can be called on the returned #GDataDownloadStream.
Calling gdata_download_stream_get_content_length() on the stream will not return a meaningful result, however, as the stream is encoded in chunks,
rather than by content length.

In order to cancel the download, a #GCancellable passed in to @cancellable must be cancelled using g_cancellable_cancel(). Cancelling the individual
#GInputStream operations on the #GDataDownloadStream will not cancel the entire download; merely the read or close operation in question. See the
#GDataDownloadStream:cancellable for more details.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataDownloadStream to download the content with, or %NULL; unref with g_object_unref()</doc>
          <type name="DownloadStream" c:type="GDataDownloadStream*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaContent</doc>
            <type name="MediaContent" c:type="GDataMediaContent*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable for the entire download stream, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_content_type"
              c:identifier="gdata_media_content_get_content_type"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaContent:content-type property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the content's content (MIME) type, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaContent</doc>
            <type name="MediaContent" c:type="GDataMediaContent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_duration"
              c:identifier="gdata_media_content_get_duration"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaContent:duration property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the content's duration in seconds, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaContent</doc>
            <type name="MediaContent" c:type="GDataMediaContent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_expression"
              c:identifier="gdata_media_content_get_expression"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaContent:expression property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the content's expression, or %GDATA_MEDIA_EXPRESSION_FULL</doc>
          <type name="MediaExpression" c:type="GDataMediaExpression"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaContent</doc>
            <type name="MediaContent" c:type="GDataMediaContent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_filesize"
              c:identifier="gdata_media_content_get_filesize"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaContent:filesize property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the number of bytes in the content, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="gsize" c:type="gsize"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaContent</doc>
            <type name="MediaContent" c:type="GDataMediaContent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_height"
              c:identifier="gdata_media_content_get_height"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaContent:height property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the content's height in pixels, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaContent</doc>
            <type name="MediaContent" c:type="GDataMediaContent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_medium"
              c:identifier="gdata_media_content_get_medium"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaContent:medium property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the type of the content, or %GDATA_MEDIA_UNKNOWN</doc>
          <type name="MediaMedium" c:type="GDataMediaMedium"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaContent</doc>
            <type name="MediaContent" c:type="GDataMediaContent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_uri"
              c:identifier="gdata_media_content_get_uri"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaContent:uri property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the content's URI</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaContent</doc>
            <type name="MediaContent" c:type="GDataMediaContent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_width"
              c:identifier="gdata_media_content_get_width"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaContent:width property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the content's width in pixels, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaContent</doc>
            <type name="MediaContent" c:type="GDataMediaContent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_default"
              c:identifier="gdata_media_content_is_default"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaContent:is-default property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the #GDataMediaContent is the default content for the media group, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaContent</doc>
            <type name="MediaContent" c:type="GDataMediaContent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="content-type" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The standard MIME type of the object.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="duration" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The number of seconds for which the media object plays.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="expression" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">Determines if the object is a sample or the full version of the object, or even if it is a continuous stream.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="MediaExpression"/>
      </property>
      <property name="filesize" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The number of bytes of the media object.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="gulong" c:type="gulong"/>
      </property>
      <property name="height" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The height of the media object.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="is-default" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">Determines if this is the default content for the media group. There should only be one default object per media group.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="medium" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The type of object, complementing #GDataMediaContent:content-type. It allows the consuming application to make simpler decisions between
different content objects, based on whether they're a video or audio stream, for example.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="MediaMedium"/>
      </property>
      <property name="uri" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The direct URI to the media object.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="width" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The width of the media object.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="MediaContentPrivate" c:type="GDataMediaContentPrivate*"/>
      </field>
    </class>
    <record name="MediaContentClass"
            c:type="GDataMediaContentClass"
            glib:is-gtype-struct-for="MediaContent"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataMediaContentClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="MediaContentPrivate"
            c:type="GDataMediaContentPrivate"
            disguised="1">
    </record>
    <class name="MediaCredit"
           c:symbol-prefix="media_credit"
           c:type="GDataMediaCredit"
           parent="Parsable"
           glib:type-name="GDataMediaCredit"
           glib:get-type="gdata_media_credit_get_type"
           glib:type-struct="MediaCreditClass">
      <doc xml:space="preserve">All the fields in the #GDataMediaCredit structure are private and should never be accessed directly.</doc>
      <method name="get_credit"
              c:identifier="gdata_media_credit_get_credit"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaCredit:credit property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the name of the credited entity</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaCredit</doc>
            <type name="MediaCredit" c:type="GDataMediaCredit*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_role"
              c:identifier="gdata_media_credit_get_role"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaCredit:role property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the credited entity's role, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaCredit</doc>
            <type name="MediaCredit" c:type="GDataMediaCredit*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_scheme"
              c:identifier="gdata_media_credit_get_scheme"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaCredit:scheme property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the credit's role scheme, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaCredit</doc>
            <type name="MediaCredit" c:type="GDataMediaCredit*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="credit" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The credited entity's name.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="role" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The role the credited entity played in the production of the media.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="scheme" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">A URI that identifies the role scheme.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="MediaCreditPrivate" c:type="GDataMediaCreditPrivate*"/>
      </field>
    </class>
    <record name="MediaCreditClass"
            c:type="GDataMediaCreditClass"
            glib:is-gtype-struct-for="MediaCredit"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataMediaCreditClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="MediaCreditPrivate"
            c:type="GDataMediaCreditPrivate"
            disguised="1">
    </record>
    <enumeration name="MediaExpression"
                 glib:type-name="GDataMediaExpression"
                 glib:get-type="gdata_media_expression_get_type"
                 c:type="GDataMediaExpression">
      <doc xml:space="preserve">An enum representing the possible values of #GDataMediaContent:expression.</doc>
      <member name="sample"
              value="0"
              c:identifier="GDATA_MEDIA_EXPRESSION_SAMPLE"
              glib:nick="sample">
        <doc xml:space="preserve">the media is a sample of a larger video</doc>
      </member>
      <member name="full"
              value="1"
              c:identifier="GDATA_MEDIA_EXPRESSION_FULL"
              glib:nick="full">
        <doc xml:space="preserve">the media is the full version</doc>
      </member>
      <member name="nonstop"
              value="2"
              c:identifier="GDATA_MEDIA_EXPRESSION_NONSTOP"
              glib:nick="nonstop">
        <doc xml:space="preserve">the media is a continuous stream</doc>
      </member>
    </enumeration>
    <enumeration name="MediaMedium"
                 version="0.4.0"
                 glib:type-name="GDataMediaMedium"
                 glib:get-type="gdata_media_medium_get_type"
                 c:type="GDataMediaMedium">
      <doc xml:space="preserve">An enum representing the possible values of #GDataMediaContent:medium.</doc>
      <member name="unknown"
              value="0"
              c:identifier="GDATA_MEDIA_UNKNOWN"
              glib:nick="unknown">
        <doc xml:space="preserve">the type of the media is unknown</doc>
      </member>
      <member name="image"
              value="1"
              c:identifier="GDATA_MEDIA_IMAGE"
              glib:nick="image">
        <doc xml:space="preserve">the media is an image</doc>
      </member>
      <member name="audio"
              value="2"
              c:identifier="GDATA_MEDIA_AUDIO"
              glib:nick="audio">
        <doc xml:space="preserve">the media is an audio stream</doc>
      </member>
      <member name="video"
              value="3"
              c:identifier="GDATA_MEDIA_VIDEO"
              glib:nick="video">
        <doc xml:space="preserve">the media is a video</doc>
      </member>
      <member name="document"
              value="4"
              c:identifier="GDATA_MEDIA_DOCUMENT"
              glib:nick="document">
        <doc xml:space="preserve">the media is another type of document</doc>
      </member>
      <member name="executable"
              value="5"
              c:identifier="GDATA_MEDIA_EXECUTABLE"
              glib:nick="executable">
        <doc xml:space="preserve">the media is an executable file</doc>
      </member>
    </enumeration>
    <class name="MediaThumbnail"
           c:symbol-prefix="media_thumbnail"
           c:type="GDataMediaThumbnail"
           parent="Parsable"
           glib:type-name="GDataMediaThumbnail"
           glib:get-type="gdata_media_thumbnail_get_type"
           glib:type-struct="MediaThumbnailClass">
      <doc xml:space="preserve">All the fields in the #GDataMediaThumbnail structure are private and should never be accessed directly.</doc>
      <method name="download"
              c:identifier="gdata_media_thumbnail_download"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Downloads and returns a #GDataDownloadStream allowing the thumbnail data represented by @self to be read.

To get the content type of the downloaded data, gdata_download_stream_get_content_type() can be called on the returned #GDataDownloadStream.
Calling gdata_download_stream_get_content_length() on the stream will not return a meaningful result, however, as the stream is encoded in chunks,
rather than by content length.

In order to cancel the download, a #GCancellable passed in to @cancellable must be cancelled using g_cancellable_cancel(). Cancelling the individual
#GInputStream operations on the #GDataDownloadStream will not cancel the entire download; merely the read or close operation in question. See the
#GDataDownloadStream:cancellable for more details.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataDownloadStream to download the thumbnail with, or %NULL; unref with g_object_unref()</doc>
          <type name="DownloadStream" c:type="GDataDownloadStream*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaThumbnail</doc>
            <type name="MediaThumbnail" c:type="GDataMediaThumbnail*"/>
          </instance-parameter>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable for the entire download stream, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_height"
              c:identifier="gdata_media_thumbnail_get_height"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaThumbnail:height property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the thumbnail's height in pixels, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaThumbnail</doc>
            <type name="MediaThumbnail" c:type="GDataMediaThumbnail*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_time"
              c:identifier="gdata_media_thumbnail_get_time"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaThumbnail:time property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the thumbnail's time offset in the media, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaThumbnail</doc>
            <type name="MediaThumbnail" c:type="GDataMediaThumbnail*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_uri"
              c:identifier="gdata_media_thumbnail_get_uri"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaThumbnail:uri property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the thumbnail's URI</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaThumbnail</doc>
            <type name="MediaThumbnail" c:type="GDataMediaThumbnail*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_width"
              c:identifier="gdata_media_thumbnail_get_width"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataMediaThumbnail:width property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the thumbnail's width in pixels, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataMediaThumbnail</doc>
            <type name="MediaThumbnail" c:type="GDataMediaThumbnail*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="height" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The height of the thumbnail, in pixels.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="time" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The time offset of the thumbnail in relation to the media object, in milliseconds.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="uri" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The URI of the thumbnail.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="width" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The width of the thumbnail, in pixels.

For more information, see the &lt;ulink type="http" url="http://video.search.yahoo.com/mrss"&gt;Media RSS specification&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="MediaThumbnailPrivate"
              c:type="GDataMediaThumbnailPrivate*"/>
      </field>
    </class>
    <record name="MediaThumbnailClass"
            c:type="GDataMediaThumbnailClass"
            glib:is-gtype-struct-for="MediaThumbnail"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataMediaThumbnailClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="MediaThumbnailPrivate"
            c:type="GDataMediaThumbnailPrivate"
            disguised="1">
    </record>
    <constant name="OAUTH2_REDIRECT_URI_OOB"
              value="urn:ietf:wg:oauth:2.0:oob"
              c:type="GDATA_OAUTH2_REDIRECT_URI_OOB"
              version="0.17.0">
      <doc xml:space="preserve">OAuth 2 redirect URI for out-of-band authorisation code transfer, where the
user is shown the authorisation code and asked to copy it.

See
&lt;ulink type="http" url="https://developers.google.com/accounts/docs/OAuth2InstalledApp#choosingredirecturi"&gt;reference
documentation&lt;/ulink&gt; for details.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="OAUTH2_REDIRECT_URI_OOB_AUTO"
              value="urn:ietf:wg:oauth:2.0:oob:auto"
              c:type="GDATA_OAUTH2_REDIRECT_URI_OOB_AUTO"
              version="0.17.0">
      <doc xml:space="preserve">OAuth 2 redirect URI for out-of-band authorisation code transfer, where the
user is not shown the authorisation code or asked to copy it.

See
&lt;ulink type="http" url="https://developers.google.com/accounts/docs/OAuth2InstalledApp#choosingredirecturi"&gt;reference
documentation&lt;/ulink&gt; for details.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <class name="OAuth1Authorizer"
           c:symbol-prefix="oauth1_authorizer"
           c:type="GDataOAuth1Authorizer"
           version="0.9.0"
           parent="GObject.Object"
           glib:type-name="GDataOAuth1Authorizer"
           glib:get-type="gdata_oauth1_authorizer_get_type"
           glib:type-struct="OAuth1AuthorizerClass">
      <doc xml:space="preserve">All the fields in the #GDataOAuth1Authorizer structure are private and should never be accessed directly.</doc>
      <implements name="Authorizer"/>
      <constructor name="new"
                   c:identifier="gdata_oauth1_authorizer_new"
                   version="0.9.0">
        <doc xml:space="preserve">Creates a new #GDataOAuth1Authorizer.

The #GDataAuthorizationDomain&lt;!-- --&gt;s for the given @service_type (i.e. as returned by gdata_service_get_authorization_domains()) are the ones the
user will be requested to authorize access to on the page at the URI returned by gdata_oauth1_authorizer_request_authentication_uri().

The given @application_name will set the value of #GDataOAuth1Authorizer:application-name and will be displayed to the user on authentication pages
returned by Google. If %NULL is provided, the value of g_get_application_name() will be used as a fallback.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataOAuth1Authorizer; unref with g_object_unref()</doc>
          <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
        </return-value>
        <parameters>
          <parameter name="application_name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a human-readable, translated application name to use on authentication pages, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="service_type" transfer-ownership="none">
            <doc xml:space="preserve">the #GType of a #GDataService subclass which the #GDataOAuth1Authorizer will be used with</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
        </parameters>
      </constructor>
      <constructor name="new_for_authorization_domains"
                   c:identifier="gdata_oauth1_authorizer_new_for_authorization_domains"
                   version="0.9.0">
        <doc xml:space="preserve">Creates a new #GDataOAuth1Authorizer. This function is intended to be used only when the default authorization domain list for a single
#GDataService, as used by gdata_oauth1_authorizer_new(), isn't suitable. For example, this could be because the #GDataOAuth1Authorizer will be used
with multiple #GDataService subclasses, or because the client requires a specific set of authorization domains.

The specified #GDataAuthorizationDomain&lt;!-- --&gt;s are the ones the user will be requested to authorize access to on the page at the URI returned by
gdata_oauth1_authorizer_request_authentication_uri().

The given @application_name will set the value of #GDataOAuth1Authorizer:application-name and will be displayed to the user on authentication pages
returned by Google. If %NULL is provided, the value of g_get_application_name() will be used as a fallback.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataOAuth1Authorizer; unref with g_object_unref()</doc>
          <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
        </return-value>
        <parameters>
          <parameter name="application_name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a human-readable, translated application name to use on authentication pages, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="authorization_domains" transfer-ownership="none">
            <doc xml:space="preserve">a non-empty list of #GDataAuthorizationDomain&lt;!-- --&gt;s to be
authorized against by the #GDataOAuth1Authorizer</doc>
            <type name="GLib.List" c:type="GList*">
              <type name="AuthorizationDomain"/>
            </type>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_application_name"
              c:identifier="gdata_oauth1_authorizer_get_application_name"
              version="0.9.0">
        <doc xml:space="preserve">Returns the application name being used on the authentication page at the URI returned by gdata_oauth1_authorizer_request_authentication_uri();
i.e. the value of #GDataOAuth1Authorizer:application-name.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the application name, or %NULL if one isn't set</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_locale"
              c:identifier="gdata_oauth1_authorizer_get_locale"
              version="0.9.0">
        <doc xml:space="preserve">Returns the locale currently being used for network requests, or %NULL if the locale is the default.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the current locale</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_proxy_resolver"
              c:identifier="gdata_oauth1_authorizer_get_proxy_resolver"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GProxyResolver on the #GDataOAuth1Authorizer's #SoupSession.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GProxyResolver, or %NULL</doc>
          <type name="Gio.ProxyResolver" c:type="GProxyResolver*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_proxy_uri"
              c:identifier="gdata_oauth1_authorizer_get_proxy_uri"
              version="0.9.0"
              deprecated="1"
              deprecated-version="0.15.0">
        <doc xml:space="preserve">Gets the proxy URI on the #GDataOAuth1Authorizer's #SoupSession.</doc>
        <doc-deprecated xml:space="preserve">Use gdata_oauth1_authorizer_get_proxy_resolver() instead, which gives more flexibility over the proxy used.</doc-deprecated>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the proxy URI, or %NULL; free with soup_uri_free()</doc>
          <type name="Soup.URI" c:type="SoupURI*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_timeout"
              c:identifier="gdata_oauth1_authorizer_get_timeout"
              version="0.9.0">
        <doc xml:space="preserve">Gets the #GDataOAuth1Authorizer:timeout property; the network timeout, in seconds.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the timeout, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="request_authentication_uri"
              c:identifier="gdata_oauth1_authorizer_request_authentication_uri"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Requests a fresh unauthenticated token from the Google accounts service and builds and returns the URI of an authentication page for that token.
This should then be presented to the user (e.g. in an embedded or stand alone web browser). The authentication page will ask the user to log in
using their Google account, then ask them to grant access to the #GDataAuthorizationDomain&lt;!-- --&gt;s passed to the constructor of the
#GDataOAuth1Authorizer. If the user grants access, they will be given a verifier, which can then be passed to
gdata_oauth1_authorizer_request_authorization() (along with the @token and @token_secret values returned by this method) to authorize the token.

This method can fail if the server returns an error, but this is unlikely. If it does happen, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR will be
raised, @token and @token_secret will be set to %NULL and %NULL will be returned.

This method implements &lt;ulink type="http" url="http://tools.ietf.org/html/rfc5849#section-2.1"&gt;Section 2.1&lt;/ulink&gt; and
&lt;ulink type="http" url="http://tools.ietf.org/html/rfc5849#section-2.2"&gt;Section 2.2&lt;/ulink&gt; of the
&lt;ulink type="http" url="http://tools.ietf.org/html/rfc5849"&gt;OAuth 1.0 protocol&lt;/ulink&gt;.

When freeing @token_secret, it's advisable to set it to all zeros first, to reduce the chance of the sensitive token being recoverable from the
free memory pool and (accidentally) leaked by a different part of the process. This can be achieved with the following code:
|[
if (token_secret != NULL) {
	memset (token_secret, 0, strlen (token_secret));
	g_free (token_secret);
}
]|</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the URI of an authentication page for the user to use; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
          <parameter name="token"
                     direction="out"
                     caller-allocates="0"
                     transfer-ownership="full">
            <doc xml:space="preserve">return location for the temporary credentials token returned by the authentication service; free with g_free()</doc>
            <type name="utf8" c:type="gchar**"/>
          </parameter>
          <parameter name="token_secret"
                     direction="out"
                     caller-allocates="0"
                     transfer-ownership="full">
            <doc xml:space="preserve">return location for the temporary credentials token secret returned by the authentication service; free with
g_free()</doc>
            <type name="utf8" c:type="gchar**"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="request_authentication_uri_async"
              c:identifier="gdata_oauth1_authorizer_request_authentication_uri_async"
              version="0.9.0">
        <doc xml:space="preserve">Requests a fresh unauthenticated token from the Google accounts service and builds and returns the URI of an authentication page for that token.
@self is reffed when this method is called, so can safely be unreffed after this method returns.

For more details, see gdata_oauth1_authorizer_request_authentication_uri(), which is the synchronous version of this method.

When the operation is finished, @callback will be called. You can then call gdata_oauth1_authorizer_request_authentication_uri_finish() to get the
results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="2">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when building the URI is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="request_authentication_uri_finish"
              c:identifier="gdata_oauth1_authorizer_request_authentication_uri_finish"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous authentication URI building operation started with gdata_oauth1_authorizer_request_authentication_uri_async().

This method can fail if the server has returned an error, but this is unlikely. If it does happen, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR will be
raised, @token and @token_secret will be set to %NULL and %NULL will be returned.

When freeing @token_secret, it's advisable to set it to all zeros first, to reduce the chance of the sensitive token being recoverable from the
free memory pool and (accidentally) leaked by a different part of the process. This can be achieved with the following code:
|[
if (token_secret != NULL) {
	memset (token_secret, 0, strlen (token_secret));
	g_free (token_secret);
}
]|</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the URI of an authentication page for the user to use; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
          <parameter name="token"
                     direction="out"
                     caller-allocates="0"
                     transfer-ownership="full">
            <doc xml:space="preserve">return location for the temporary credentials token returned by the authentication service; free with g_free()</doc>
            <type name="utf8" c:type="gchar**"/>
          </parameter>
          <parameter name="token_secret"
                     direction="out"
                     caller-allocates="0"
                     transfer-ownership="full">
            <doc xml:space="preserve">return location for the temporary credentials token secret returned by the authentication service; free with
g_free()</doc>
            <type name="utf8" c:type="gchar**"/>
          </parameter>
        </parameters>
      </method>
      <method name="request_authorization"
              c:identifier="gdata_oauth1_authorizer_request_authorization"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Requests authorization of the given request @token from the Google accounts service using the given @verifier as entered by the user from the
authentication page at the URI returned by gdata_oauth1_authorizer_request_authentication_uri(). @token and @token_secret must be the same values
as were returned by gdata_oauth1_authorizer_request_authentication_uri() if it was successful.

If the verifier is valid (i.e. the user granted access to the application and the Google accounts service has no reason to distrust the client),
%TRUE will be returned and any operations performed from that point onwards on #GDataService&lt;!-- --&gt;s using this #GDataAuthorizer will be
authorized.

If the user denies access to the application or the Google accounts service distrusts it, a bogus verifier could be returned. In this case, %FALSE
will be returned and a %GDATA_SERVICE_ERROR_FORBIDDEN error will be raised.

Note that if the user denies access to the application, it may be the case that they have no verifier to enter. In this case, the client can simply
not call this method. The #GDataOAuth1Authorizer stores no state for authentication operations which have succeeded in calling
gdata_oauth1_authorizer_request_authentication_uri() but not yet successfully called gdata_oauth1_authorizer_request_authorization().

This method implements &lt;ulink type="http" url="http://tools.ietf.org/html/rfc5849#section-2.3"&gt;Section 2.3&lt;/ulink&gt; of the
&lt;ulink type="http" url="http://tools.ietf.org/html/rfc5849"&gt;OAuth 1.0 protocol&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if authorization was successful, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
          <parameter name="token" transfer-ownership="none">
            <doc xml:space="preserve">the request token returned by gdata_oauth1_authorizer_request_authentication_uri()</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="token_secret" transfer-ownership="none">
            <doc xml:space="preserve">the request token secret returned by gdata_oauth1_authorizer_request_authentication_uri()</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="verifier" transfer-ownership="none">
            <doc xml:space="preserve">the verifier entered by the user from the authentication page</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="request_authorization_async"
              c:identifier="gdata_oauth1_authorizer_request_authorization_async"
              version="0.9.0">
        <doc xml:space="preserve">Requests authorization of the given request @token from the Google accounts service using the given @verifier as entered by the user.
@self, @token, @token_secret and @verifier are reffed/copied when this method is called, so can safely be freed after this method returns.

For more details, see gdata_oauth1_authorizer_request_authorization(), which is the synchronous version of this method.

When the operation is finished, @callback will be called. You can then call gdata_oauth1_authorizer_request_authorization_finish() to get the
results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
          <parameter name="token" transfer-ownership="none">
            <doc xml:space="preserve">the request token returned by gdata_oauth1_authorizer_request_authentication_uri()</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="token_secret" transfer-ownership="none">
            <doc xml:space="preserve">the request token secret returned by gdata_oauth1_authorizer_request_authentication_uri()</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="verifier" transfer-ownership="none">
            <doc xml:space="preserve">the verifier entered by the user from the authentication page</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">an optional #GCancellable, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="5">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authorization is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="request_authorization_finish"
              c:identifier="gdata_oauth1_authorizer_request_authorization_finish"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous authorization operation started with gdata_oauth1_authorizer_request_authorization_async().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if authorization was successful, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_locale"
              c:identifier="gdata_oauth1_authorizer_set_locale"
              version="0.9.0">
        <doc xml:space="preserve">Set the locale used for network requests to @locale, given in standard Unix locale format. See #GDataOAuth1Authorizer:locale for more details.

Note that while it's possible to change the locale after sending network requests (i.e. calling
gdata_oauth1_authorizer_request_authentication_uri() for the first time), it is unsupported, as the server-side software may behave unexpectedly.
The only supported use of this method is after creation of the authorizer, but before any network requests are made.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
          <parameter name="locale"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new locale in Unix locale format, or %NULL for the default locale</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_proxy_resolver"
              c:identifier="gdata_oauth1_authorizer_set_proxy_resolver"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GProxyResolver on the #SoupSession used internally by the given #GDataOAuth1Authorizer.

Setting this will clear the #GDataOAuth1Authorizer:proxy-uri property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
          <parameter name="proxy_resolver"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GProxyResolver, or %NULL</doc>
            <type name="Gio.ProxyResolver" c:type="GProxyResolver*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_proxy_uri"
              c:identifier="gdata_oauth1_authorizer_set_proxy_uri"
              version="0.9.0"
              deprecated="1"
              deprecated-version="0.15.0">
        <doc xml:space="preserve">Sets the proxy URI on the #SoupSession used internally by the #GDataOAuth1Authorizer. This forces all requests through the given proxy.

If @proxy_uri is %NULL, no proxy will be used.</doc>
        <doc-deprecated xml:space="preserve">Use gdata_oauth1_authorizer_set_proxy_resolver() instead, which gives more flexibility over the proxy used.</doc-deprecated>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
          <parameter name="proxy_uri"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the proxy URI, or %NULL</doc>
            <type name="Soup.URI" c:type="SoupURI*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_timeout"
              c:identifier="gdata_oauth1_authorizer_set_timeout"
              version="0.9.0">
        <doc xml:space="preserve">Sets the #GDataOAuth1Authorizer:timeout property; the network timeout, in seconds.

If @timeout is &lt;code class="literal"&gt;0&lt;/code&gt;, network operations will never time out.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth1Authorizer</doc>
            <type name="OAuth1Authorizer" c:type="GDataOAuth1Authorizer*"/>
          </instance-parameter>
          <parameter name="timeout" transfer-ownership="none">
            <doc xml:space="preserve">the timeout, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <property name="application-name"
                version="0.9.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The human-readable, translated application name for the client, to be presented to the user on the authentication page at the URI
returned by gdata_oauth1_authorizer_request_authentication_uri().

If %NULL is provided in the constructor to #GDataOAuth1Authorizer, the value returned by g_get_application_name() will be used as a
fallback. Note that this may also be %NULL: in this case, the authentication page will use the application name “anonymous”.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="locale"
                version="0.9.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The locale to use for network requests, in Unix locale format. (e.g. "en_GB", "cs", "de_DE".) Use %NULL for the default "C" locale
(typically "en_US").

This locale will be used by the server-side software to localise the authentication and authorization pages at the URI returned by
gdata_oauth1_authorizer_request_authentication_uri().

The server-side behaviour is undefined if it doesn't support a given locale.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="proxy-resolver"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The #GProxyResolver used to determine a proxy URI.  Setting this will clear the #GDataOAuth1Authorizer:proxy-uri property.</doc>
        <type name="Gio.ProxyResolver"/>
      </property>
      <property name="proxy-uri"
                version="0.9.0"
                deprecated="1"
                deprecated-version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The proxy URI used internally for all network requests.</doc>
        <doc-deprecated xml:space="preserve">Use #GDataClientLoginAuthorizer:proxy-resolver instead, which gives more flexibility over the proxy used.</doc-deprecated>
        <type name="Soup.URI"/>
      </property>
      <property name="timeout"
                version="0.9.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A timeout, in seconds, for network operations. If the timeout is exceeded, the operation will be cancelled and
%GDATA_SERVICE_ERROR_NETWORK_ERROR will be returned.

If the timeout is &lt;code class="literal"&gt;0&lt;/code&gt;, operations will never time out.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <field name="parent" readable="0" private="1">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="OAuth1AuthorizerPrivate"
              c:type="GDataOAuth1AuthorizerPrivate*"/>
      </field>
    </class>
    <record name="OAuth1AuthorizerClass"
            c:type="GDataOAuth1AuthorizerClass"
            glib:is-gtype-struct-for="OAuth1Authorizer"
            version="0.9.0">
      <doc xml:space="preserve">All the fields in the #GDataOAuth1AuthorizerClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="OAuth1AuthorizerPrivate"
            c:type="GDataOAuth1AuthorizerPrivate"
            disguised="1">
    </record>
    <class name="OAuth2Authorizer"
           c:symbol-prefix="oauth2_authorizer"
           c:type="GDataOAuth2Authorizer"
           version="0.17.0"
           parent="GObject.Object"
           glib:type-name="GDataOAuth2Authorizer"
           glib:get-type="gdata_oauth2_authorizer_get_type"
           glib:type-struct="OAuth2AuthorizerClass">
      <doc xml:space="preserve">All the fields in the #GDataOAuth2Authorizer structure are private and should never be accessed directly.</doc>
      <implements name="Authorizer"/>
      <constructor name="new"
                   c:identifier="gdata_oauth2_authorizer_new"
                   version="0.17.0">
        <doc xml:space="preserve">Creates a new #GDataOAuth2Authorizer. The @client_id must be unique for your
application, and as registered with Google, and the @client_secret must be
paired with it.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataOAuth2Authorizer; unref with
g_object_unref()</doc>
          <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
        </return-value>
        <parameters>
          <parameter name="client_id" transfer-ownership="none">
            <doc xml:space="preserve">your application’s client ID</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="client_secret" transfer-ownership="none">
            <doc xml:space="preserve">your application’s client secret</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="redirect_uri" transfer-ownership="none">
            <doc xml:space="preserve">authorisation redirect URI</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="service_type" transfer-ownership="none">
            <doc xml:space="preserve">the #GType of a #GDataService subclass which the
#GDataOAuth2Authorizer will be used with</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
        </parameters>
      </constructor>
      <constructor name="new_for_authorization_domains"
                   c:identifier="gdata_oauth2_authorizer_new_for_authorization_domains"
                   version="0.17.0">
        <doc xml:space="preserve">Creates a new #GDataOAuth2Authorizer. The @client_id must be unique for your
application, and as registered with Google, and the @client_secret must be
paired with it.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataOAuth2Authorizer; unref with
g_object_unref()</doc>
          <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
        </return-value>
        <parameters>
          <parameter name="client_id" transfer-ownership="none">
            <doc xml:space="preserve">your application’s client ID</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="client_secret" transfer-ownership="none">
            <doc xml:space="preserve">your application’s client secret</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="redirect_uri" transfer-ownership="none">
            <doc xml:space="preserve">authorisation redirect URI</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="authorization_domains" transfer-ownership="none">
            <doc xml:space="preserve">
a non-empty list of #GDataAuthorizationDomains to be authorized against by
the #GDataOAuth2Authorizer</doc>
            <type name="GLib.List" c:type="GList*">
              <type name="AuthorizationDomain"/>
            </type>
          </parameter>
        </parameters>
      </constructor>
      <method name="build_authentication_uri"
              c:identifier="gdata_oauth2_authorizer_build_authentication_uri"
              version="0.17.0">
        <doc xml:space="preserve">Build an authentication URI to open in the user’s web browser (or an embedded
browser widget). This will display an authentication page from Google,
including an authentication form and confirmation of the authorisation
domains being requested by this #GDataAuthorizer. The user will authenticate
in the browser, then an authorisation code will be returned via the
#GDataOAuth2Authorizer:redirect-uri, ready to be passed to
gdata_oauth2_authorizer_request_authorization().

If @login_hint is non-%NULL, it will be passed to the server as a hint of
which user is attempting to authenticate, which can be used to pre-fill the
e-mail address box in the authentication form.

If @include_granted_scopes is %TRUE, the authentication request will
automatically include all authorisation domains previously granted to this
user/application pair, allowing for incremental authentication — asking for
permissions as needed, rather than all in one large bundle at the first
opportunity. If @include_granted_scopes is %FALSE, incremental authentication
will not be enabled, and only the domains passed to the
#GDataOAuth2Authorizer constructor will eventually be authenticated.
See the
&lt;ulink type="http" url="https://developers.google.com/accounts/docs/OAuth2WebServer#incrementalAuth"&gt;reference
documentation&lt;/ulink&gt; for more details.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the authentication URI to open in a web
browser; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
          <parameter name="login_hint"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional e-mail address or sub identifier for the
user</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="include_granted_scopes" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE to enable incremental authorisation</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="dup_refresh_token"
              c:identifier="gdata_oauth2_authorizer_dup_refresh_token"
              version="0.17.2">
        <doc xml:space="preserve">Returns the authorizer's refresh token, #GDataOAuth2Authorizer:refresh-token,
as set by client code previously on the #GDataOAuth2Authorizer, or as
returned by the most recent authentication operation.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the authorizer's refresh token</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_client_id"
              c:identifier="gdata_oauth2_authorizer_get_client_id"
              version="0.17.0">
        <doc xml:space="preserve">Returns the authorizer's client ID, #GDataOAuth2Authorizer:client-id, as
specified on constructing the #GDataOAuth2Authorizer.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the authorizer's client ID</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_client_secret"
              c:identifier="gdata_oauth2_authorizer_get_client_secret"
              version="0.17.0">
        <doc xml:space="preserve">Returns the authorizer's client secret, #GDataOAuth2Authorizer:client-secret,
as specified on constructing the #GDataOAuth2Authorizer.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the authorizer's client secret</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_locale"
              c:identifier="gdata_oauth2_authorizer_get_locale"
              version="0.17.0">
        <doc xml:space="preserve">Returns the locale currently being used for network requests, or %NULL if the
locale is the default.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the current locale</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_proxy_resolver"
              c:identifier="gdata_oauth2_authorizer_get_proxy_resolver"
              version="0.17.0">
        <doc xml:space="preserve">Gets the #GProxyResolver on the #GDataOAuth2Authorizer's #SoupSession.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GProxyResolver, or %NULL</doc>
          <type name="Gio.ProxyResolver" c:type="GProxyResolver*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_redirect_uri"
              c:identifier="gdata_oauth2_authorizer_get_redirect_uri"
              version="0.17.0">
        <doc xml:space="preserve">Returns the authorizer’s redirect URI, #GDataOAuth2Authorizer:redirect-uri,
as specified on constructing the #GDataOAuth2Authorizer.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the authorizer’s redirect URI</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_timeout"
              c:identifier="gdata_oauth2_authorizer_get_timeout"
              version="0.17.0">
        <doc xml:space="preserve">Gets the #GDataOAuth2Authorizer:timeout property; the network timeout, in
seconds.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the timeout, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="request_authorization"
              c:identifier="gdata_oauth2_authorizer_request_authorization"
              version="0.17.0"
              throws="1">
        <doc xml:space="preserve">Request an authorisation code from the user’s web browser is converted to
authorisation (access and refresh) tokens. This is the final step in the
authentication process; once complete, the #GDataOAuth2Authorizer should be
fully authorised for its domains.

On failure, %GDATA_SERVICE_ERROR_FORBIDDEN will be returned if the user or
server denied the authorisation request. %GDATA_SERVICE_ERROR_PROTOCOL_ERROR
will be returned if the server didn’t follow the expected protocol.
%G_IO_ERROR_CANCELLED will be returned if the operation was cancelled using
@cancellable.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
          <parameter name="authorization_code" transfer-ownership="none">
            <doc xml:space="preserve">code returned from the authentication page</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="request_authorization_async"
              c:identifier="gdata_oauth2_authorizer_request_authorization_async"
              version="0.17.0">
        <doc xml:space="preserve">Asynchronous version of gdata_oauth2_authorizer_request_authorization().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
          <parameter name="authorization_code" transfer-ownership="none">
            <doc xml:space="preserve">code returned from the authentication page</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">an optional #GCancellable, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authorization is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="request_authorization_finish"
              c:identifier="gdata_oauth2_authorizer_request_authorization_finish"
              version="0.17.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous authorization operation started with
gdata_oauth2_authorizer_request_authorization_async().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if authorization was successful, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_locale"
              c:identifier="gdata_oauth2_authorizer_set_locale"
              version="0.17.0">
        <doc xml:space="preserve">Set the locale used for network requests to @locale, given in standard UNIX
locale format. See #GDataOAuth2Authorizer:locale for more details.

Note that while it’s possible to change the locale after sending network
requests (i.e. calling gdata_oauth2_authorizer_build_authentication_uri() for
the first time), it is unsupported, as the server-side software may behave
unexpectedly. The only supported use of this method is after creation of the
authorizer, but before any network requests are made.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
          <parameter name="locale"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new locale in UNIX locale format, or %NULL for the
default locale</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_proxy_resolver"
              c:identifier="gdata_oauth2_authorizer_set_proxy_resolver"
              version="0.17.0">
        <doc xml:space="preserve">Sets the #GProxyResolver on the #SoupSession used internally by the given
#GDataOAuth2Authorizer.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
          <parameter name="proxy_resolver"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GProxyResolver, or %NULL</doc>
            <type name="Gio.ProxyResolver" c:type="GProxyResolver*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_refresh_token"
              c:identifier="gdata_oauth2_authorizer_set_refresh_token"
              version="0.17.2">
        <doc xml:space="preserve">Sets the authorizer's refresh token, #GDataOAuth2Authorizer:refresh-token.
This is used to periodically refresh the access token. Set it to %NULL to
clear the current authentication from the authorizer.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
          <parameter name="refresh_token"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new refresh token, or %NULL to clear
  authorization</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_timeout"
              c:identifier="gdata_oauth2_authorizer_set_timeout"
              version="0.17.0">
        <doc xml:space="preserve">Sets the #GDataOAuth2Authorizer:timeout property; the network timeout, in
seconds.

If @timeout is &lt;code class="literal"&gt;0&lt;/code&gt;, network operations will never
time out.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataOAuth2Authorizer</doc>
            <type name="OAuth2Authorizer" c:type="GDataOAuth2Authorizer*"/>
          </instance-parameter>
          <parameter name="timeout" transfer-ownership="none">
            <doc xml:space="preserve">the timeout, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <property name="client-id"
                version="0.17.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A client ID for your application (see the
&lt;ulink url="https://developers.google.com/accounts/docs/OAuth2InstalledApp#handlingtheresponse" type="http"&gt;reference documentation&lt;/ulink&gt;).

It is recommended that the ID is of the form
&lt;literal&gt;&lt;replaceable&gt;company name&lt;/replaceable&gt;-
&lt;replaceable&gt;application name&lt;/replaceable&gt;-
&lt;replaceable&gt;version ID&lt;/replaceable&gt;&lt;/literal&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="client-secret"
                version="0.17.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Client secret provided by Google. This is unique for each application
and is accessible from Google’s Developer Console when registering
an application. It must be paired with the
#GDataOAuth2Authorizer:client-id.

See the
&lt;ulink url="https://developers.google.com/accounts/docs/OAuth2InstalledApp#handlingtheresponse" type="http"&gt;reference
documentation&lt;/ulink&gt; for details.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="locale"
                version="0.17.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The locale to use for network requests, in UNIX locale format.
(e.g. "en_GB", "cs", "de_DE".) Use %NULL for the default "C" locale
(typically "en_US").

This locale will be used by the server-side software to localise the
authentication and authorization pages at the URI returned by
gdata_oauth2_authorizer_build_authentication_uri().

The server-side behaviour is undefined if it doesn't support a given
locale.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="proxy-resolver"
                version="0.17.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The #GProxyResolver used to determine a proxy URI.</doc>
        <type name="Gio.ProxyResolver"/>
      </property>
      <property name="redirect-uri"
                version="0.17.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Redirect URI to send the response from the authorisation request to.
This must either be %GDATA_OAUTH2_REDIRECT_URI_OOB,
%GDATA_OAUTH2_REDIRECT_URI_OOB_AUTO, or a
&lt;code&gt;http://localhost&lt;/code&gt; URI with any port number (optionally)
specified.

This URI is where the authorisation server will redirect the user
after they have completed interacting with the authentication page
(gdata_oauth2_authorizer_build_authentication_uri()). If it is
%GDATA_OAUTH2_REDIRECT_URI_OOB, a page will be returned in the user’s
browser with the authorisation code in its title and also embedded in
the page for the user to copy if it is not possible to automatically
extract the code from the page title. If it is
%GDATA_OAUTH2_REDIRECT_URI_OOB_AUTO, a similar page will be returned
with the authorisation code in its title, but without displaying the
code to the user — the user will simply be asked to close the page.
If it is a localhost URI, the authentication page will redirect to
that URI with the authorisation code appended as a &lt;code&gt;code&lt;/code&gt;
query parameter. If the user denies the authentication request, the
authentication page will redirect to that URI with
&lt;code&gt;error=access_denied&lt;/code&gt; appended as a query parameter.

Note that the redirect URI used must match that registered in
Google’s Developer Console for your application.

See the &lt;ulink type="http" url="https://developers.google.com/accounts/docs/OAuth2InstalledApp#choosingredirecturi"&gt;reference
documentation&lt;/ulink&gt; for details about choosing a redirect URI.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="refresh-token"
                version="0.17.2"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The server provided refresh token, which can be stored and passed in
to new #GDataOAuth2Authorizer instances before calling
gdata_authorizer_refresh_authorization_async() to create a new
short-lived access token.

The refresh token is opaque data and must not be parsed.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="timeout"
                version="0.17.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A timeout, in seconds, for network operations. If the timeout is
exceeded, the operation will be cancelled and
%GDATA_SERVICE_ERROR_NETWORK_ERROR will be returned.

If the timeout is &lt;code class="literal"&gt;0&lt;/code&gt;, operations will
never time out.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <field name="parent" readable="0" private="1">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="OAuth2AuthorizerPrivate"
              c:type="GDataOAuth2AuthorizerPrivate*"/>
      </field>
    </class>
    <record name="OAuth2AuthorizerClass"
            c:type="GDataOAuth2AuthorizerClass"
            glib:is-gtype-struct-for="OAuth2Authorizer"
            version="0.17.0">
      <doc xml:space="preserve">All the fields in the #GDataOAuth2AuthorizerClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="OAuth2AuthorizerPrivate"
            c:type="GDataOAuth2AuthorizerPrivate"
            disguised="1">
    </record>
    <enumeration name="OperationType"
                 version="0.6.0"
                 glib:type-name="GDataOperationType"
                 glib:get-type="gdata_operation_type_get_type"
                 c:type="GDataOperationType">
      <doc xml:space="preserve">Representations of the different operations performed by the library.</doc>
      <member name="query"
              value="1"
              c:identifier="GDATA_OPERATION_QUERY"
              glib:nick="query">
        <doc xml:space="preserve">a query</doc>
      </member>
      <member name="insertion"
              value="2"
              c:identifier="GDATA_OPERATION_INSERTION"
              glib:nick="insertion">
        <doc xml:space="preserve">an insertion of a #GDataEntry</doc>
      </member>
      <member name="update"
              value="3"
              c:identifier="GDATA_OPERATION_UPDATE"
              glib:nick="update">
        <doc xml:space="preserve">an update of a #GDataEntry</doc>
      </member>
      <member name="deletion"
              value="4"
              c:identifier="GDATA_OPERATION_DELETION"
              glib:nick="deletion">
        <doc xml:space="preserve">a deletion of a #GDataEntry</doc>
      </member>
      <member name="download"
              value="5"
              c:identifier="GDATA_OPERATION_DOWNLOAD"
              glib:nick="download">
        <doc xml:space="preserve">a download of a file</doc>
      </member>
      <member name="upload"
              value="6"
              c:identifier="GDATA_OPERATION_UPLOAD"
              glib:nick="upload">
        <doc xml:space="preserve">an upload of a file</doc>
      </member>
      <member name="authentication"
              value="7"
              c:identifier="GDATA_OPERATION_AUTHENTICATION"
              glib:nick="authentication">
        <doc xml:space="preserve">authentication with the service</doc>
      </member>
      <member name="batch"
              value="8"
              c:identifier="GDATA_OPERATION_BATCH"
              glib:nick="batch">
        <doc xml:space="preserve">a batch operation with #GDataBatchOperation</doc>
      </member>
    </enumeration>
    <constant name="PICASAWEB_VIDEO_STATUS_FAILED"
              value="failed"
              c:type="GDATA_PICASAWEB_VIDEO_STATUS_FAILED"
              version="0.7.0">
      <doc xml:space="preserve">There was an error while processing or thumbnailing the video and it should be deleted.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="PICASAWEB_VIDEO_STATUS_FINAL"
              value="final"
              c:type="GDATA_PICASAWEB_VIDEO_STATUS_FINAL"
              version="0.7.0">
      <doc xml:space="preserve">The video has been processed and thumbnailed.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="PICASAWEB_VIDEO_STATUS_PENDING"
              value="pending"
              c:type="GDATA_PICASAWEB_VIDEO_STATUS_PENDING"
              version="0.7.0">
      <doc xml:space="preserve">The video is still being processed.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="PICASAWEB_VIDEO_STATUS_READY"
              value="ready"
              c:type="GDATA_PICASAWEB_VIDEO_STATUS_READY"
              version="0.7.0">
      <doc xml:space="preserve">The video has been processed, but still needs thumbnailing.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <class name="Parsable"
           c:symbol-prefix="parsable"
           c:type="GDataParsable"
           version="0.3.0"
           parent="GObject.Object"
           abstract="1"
           glib:type-name="GDataParsable"
           glib:get-type="gdata_parsable_get_type"
           glib:type-struct="ParsableClass">
      <doc xml:space="preserve">All the fields in the #GDataParsable structure are private and should never be accessed directly.</doc>
      <constructor name="new_from_json"
                   c:identifier="gdata_parsable_new_from_json"
                   version="0.15.0"
                   throws="1">
        <doc xml:space="preserve">Creates a new #GDataParsable subclass (of the given @parsable_type) from the given @json.

An object of the given @parsable_type is created, and its &lt;function&gt;parse_json&lt;/function&gt; and
&lt;function&gt;post_parse_json&lt;/function&gt; class functions called on the JSON node obtained from @json.
&lt;function&gt;post_parse_json&lt;/function&gt; is called once on the root node, while &lt;function&gt;parse_json&lt;/function&gt; is called for
each of the node's members.

If @length is -1, @json will be assumed to be nul-terminated.

If an error occurs during parsing, a suitable error from #GDataParserError will be returned.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataParsable, or %NULL; unref with g_object_unref()</doc>
          <type name="Parsable" c:type="GDataParsable*"/>
        </return-value>
        <parameters>
          <parameter name="parsable_type" transfer-ownership="none">
            <doc xml:space="preserve">the type of the class represented by the JSON</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
          <parameter name="json" transfer-ownership="none">
            <doc xml:space="preserve">the JSON for just the parsable object</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="length" transfer-ownership="none">
            <doc xml:space="preserve">the length of @json, or -1</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </constructor>
      <constructor name="new_from_xml"
                   c:identifier="gdata_parsable_new_from_xml"
                   version="0.4.0"
                   throws="1">
        <doc xml:space="preserve">Creates a new #GDataParsable subclass (of the given @parsable_type) from the given @xml.

An object of the given @parsable_type is created, and its &lt;function&gt;pre_parse_xml&lt;/function&gt;, &lt;function&gt;parse_xml&lt;/function&gt; and
&lt;function&gt;post_parse_xml&lt;/function&gt; class functions called on the XML tree obtained from @xml. &lt;function&gt;pre_parse_xml&lt;/function&gt; and
&lt;function&gt;post_parse_xml&lt;/function&gt; are called once each on the root node of the tree, while &lt;function&gt;parse_xml&lt;/function&gt; is called for
each of the child nodes of the root node.

If @length is -1, @xml will be assumed to be null-terminated.

If an error occurs during parsing, a suitable error from #GDataParserError will be returned.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataParsable, or %NULL; unref with g_object_unref()</doc>
          <type name="Parsable" c:type="GDataParsable*"/>
        </return-value>
        <parameters>
          <parameter name="parsable_type" transfer-ownership="none">
            <doc xml:space="preserve">the type of the class represented by the XML</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
          <parameter name="xml" transfer-ownership="none">
            <doc xml:space="preserve">the XML for just the parsable object, with full namespace declarations</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="length" transfer-ownership="none">
            <doc xml:space="preserve">the length of @xml, or -1</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </constructor>
      <virtual-method name="get_json">
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="parsable" transfer-ownership="none">
            <type name="Parsable" c:type="GDataParsable*"/>
          </instance-parameter>
          <parameter name="builder" transfer-ownership="none">
            <type name="Json.Builder" c:type="JsonBuilder*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="get_namespaces">
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="parsable" transfer-ownership="none">
            <type name="Parsable" c:type="GDataParsable*"/>
          </instance-parameter>
          <parameter name="namespaces" transfer-ownership="none">
            <type name="GLib.HashTable" c:type="GHashTable*">
              <type name="gpointer" c:type="gpointer"/>
              <type name="gpointer" c:type="gpointer"/>
            </type>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="get_xml">
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="parsable" transfer-ownership="none">
            <type name="Parsable" c:type="GDataParsable*"/>
          </instance-parameter>
          <parameter name="xml_string" transfer-ownership="none">
            <type name="GLib.String" c:type="GString*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="parse_json" throws="1">
        <return-value transfer-ownership="none">
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="parsable" transfer-ownership="none">
            <type name="Parsable" c:type="GDataParsable*"/>
          </instance-parameter>
          <parameter name="reader" transfer-ownership="none">
            <type name="Json.Reader" c:type="JsonReader*"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none" closure="1">
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="parse_xml" throws="1">
        <return-value transfer-ownership="none">
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="parsable" transfer-ownership="none">
            <type name="Parsable" c:type="GDataParsable*"/>
          </instance-parameter>
          <parameter name="doc" transfer-ownership="none">
            <type name="libxml2.Doc" c:type="xmlDoc*"/>
          </parameter>
          <parameter name="node" transfer-ownership="none">
            <type name="libxml2.Node" c:type="xmlNode*"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none" closure="2">
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="post_parse_json" throws="1">
        <return-value transfer-ownership="none">
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="parsable" transfer-ownership="none">
            <type name="Parsable" c:type="GDataParsable*"/>
          </instance-parameter>
          <parameter name="user_data" transfer-ownership="none" closure="0">
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="post_parse_xml" throws="1">
        <return-value transfer-ownership="none">
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="parsable" transfer-ownership="none">
            <type name="Parsable" c:type="GDataParsable*"/>
          </instance-parameter>
          <parameter name="user_data" transfer-ownership="none" closure="0">
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="pre_get_xml">
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="parsable" transfer-ownership="none">
            <type name="Parsable" c:type="GDataParsable*"/>
          </instance-parameter>
          <parameter name="xml_string" transfer-ownership="none">
            <type name="GLib.String" c:type="GString*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="pre_parse_xml" throws="1">
        <return-value transfer-ownership="none">
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="parsable" transfer-ownership="none">
            <type name="Parsable" c:type="GDataParsable*"/>
          </instance-parameter>
          <parameter name="doc" transfer-ownership="none">
            <type name="libxml2.Doc" c:type="xmlDoc*"/>
          </parameter>
          <parameter name="root_node" transfer-ownership="none">
            <type name="libxml2.Node" c:type="xmlNode*"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none" closure="2">
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </virtual-method>
      <method name="get_json"
              c:identifier="gdata_parsable_get_json"
              version="0.15.0">
        <doc xml:space="preserve">Builds a JSON representation of the #GDataParsable in its current state, such that it could be inserted on the server. The JSON
is valid for stand-alone use.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the object's JSON; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataParsable</doc>
            <type name="Parsable" c:type="GDataParsable*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_xml"
              c:identifier="gdata_parsable_get_xml"
              version="0.4.0">
        <doc xml:space="preserve">Builds an XML representation of the #GDataParsable in its current state, such that it could be inserted on the server. The XML is guaranteed
to have all its namespaces declared properly in a self-contained fashion, and is valid for stand-alone use.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the object's XML; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataParsable</doc>
            <type name="Parsable" c:type="GDataParsable*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="constructed-from-xml"
                version="0.7.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies whether the object was constructed by parsing XML or manually.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <field name="parent">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="priv">
        <type name="ParsablePrivate" c:type="GDataParsablePrivate*"/>
      </field>
    </class>
    <record name="ParsableClass"
            c:type="GDataParsableClass"
            glib:is-gtype-struct-for="Parsable"
            version="0.3.0">
      <doc xml:space="preserve">The class structure for the #GDataParsable class. Note that JSON and XML functions are mutually exclusive:
a given implementation of #GDataParsable is represented as exactly one of JSON and XML.</doc>
      <field name="parent">
        <doc xml:space="preserve">the parent class</doc>
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
      <field name="pre_parse_xml">
        <callback name="pre_parse_xml" throws="1">
          <return-value transfer-ownership="none">
            <type name="gboolean" c:type="gboolean"/>
          </return-value>
          <parameters>
            <parameter name="parsable" transfer-ownership="none">
              <type name="Parsable" c:type="GDataParsable*"/>
            </parameter>
            <parameter name="doc" transfer-ownership="none">
              <type name="libxml2.Doc" c:type="xmlDoc*"/>
            </parameter>
            <parameter name="root_node" transfer-ownership="none">
              <type name="libxml2.Node" c:type="xmlNode*"/>
            </parameter>
            <parameter name="user_data" transfer-ownership="none" closure="3">
              <type name="gpointer" c:type="gpointer"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="parse_xml">
        <callback name="parse_xml" throws="1">
          <return-value transfer-ownership="none">
            <type name="gboolean" c:type="gboolean"/>
          </return-value>
          <parameters>
            <parameter name="parsable" transfer-ownership="none">
              <type name="Parsable" c:type="GDataParsable*"/>
            </parameter>
            <parameter name="doc" transfer-ownership="none">
              <type name="libxml2.Doc" c:type="xmlDoc*"/>
            </parameter>
            <parameter name="node" transfer-ownership="none">
              <type name="libxml2.Node" c:type="xmlNode*"/>
            </parameter>
            <parameter name="user_data" transfer-ownership="none" closure="3">
              <type name="gpointer" c:type="gpointer"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="post_parse_xml">
        <callback name="post_parse_xml" throws="1">
          <return-value transfer-ownership="none">
            <type name="gboolean" c:type="gboolean"/>
          </return-value>
          <parameters>
            <parameter name="parsable" transfer-ownership="none">
              <type name="Parsable" c:type="GDataParsable*"/>
            </parameter>
            <parameter name="user_data" transfer-ownership="none" closure="1">
              <type name="gpointer" c:type="gpointer"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="pre_get_xml">
        <callback name="pre_get_xml">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
          <parameters>
            <parameter name="parsable" transfer-ownership="none">
              <type name="Parsable" c:type="GDataParsable*"/>
            </parameter>
            <parameter name="xml_string" transfer-ownership="none">
              <type name="GLib.String" c:type="GString*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="get_xml">
        <callback name="get_xml">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
          <parameters>
            <parameter name="parsable" transfer-ownership="none">
              <type name="Parsable" c:type="GDataParsable*"/>
            </parameter>
            <parameter name="xml_string" transfer-ownership="none">
              <type name="GLib.String" c:type="GString*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="get_namespaces">
        <callback name="get_namespaces">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
          <parameters>
            <parameter name="parsable" transfer-ownership="none">
              <type name="Parsable" c:type="GDataParsable*"/>
            </parameter>
            <parameter name="namespaces" transfer-ownership="none">
              <type name="GLib.HashTable" c:type="GHashTable*">
                <type name="gpointer" c:type="gpointer"/>
                <type name="gpointer" c:type="gpointer"/>
              </type>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="parse_json">
        <callback name="parse_json" throws="1">
          <return-value transfer-ownership="none">
            <type name="gboolean" c:type="gboolean"/>
          </return-value>
          <parameters>
            <parameter name="parsable" transfer-ownership="none">
              <type name="Parsable" c:type="GDataParsable*"/>
            </parameter>
            <parameter name="reader" transfer-ownership="none">
              <type name="Json.Reader" c:type="JsonReader*"/>
            </parameter>
            <parameter name="user_data" transfer-ownership="none" closure="2">
              <type name="gpointer" c:type="gpointer"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="post_parse_json">
        <callback name="post_parse_json" throws="1">
          <return-value transfer-ownership="none">
            <type name="gboolean" c:type="gboolean"/>
          </return-value>
          <parameters>
            <parameter name="parsable" transfer-ownership="none">
              <type name="Parsable" c:type="GDataParsable*"/>
            </parameter>
            <parameter name="user_data" transfer-ownership="none" closure="1">
              <type name="gpointer" c:type="gpointer"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="get_json">
        <callback name="get_json">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
          <parameters>
            <parameter name="parsable" transfer-ownership="none">
              <type name="Parsable" c:type="GDataParsable*"/>
            </parameter>
            <parameter name="builder" transfer-ownership="none">
              <type name="Json.Builder" c:type="JsonBuilder*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="get_content_type">
        <callback name="get_content_type">
          <return-value transfer-ownership="none">
            <type name="utf8" c:type="const gchar*"/>
          </return-value>
        </callback>
      </field>
      <field name="element_name">
        <doc xml:space="preserve">the name of the XML element which represents this parsable</doc>
        <type name="utf8" c:type="const gchar*"/>
      </field>
      <field name="element_namespace">
        <doc xml:space="preserve">the prefix of the XML namespace used for the parsable</doc>
        <type name="utf8" c:type="const gchar*"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved6" introspectable="0">
        <callback name="_g_reserved6">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved7" introspectable="0">
        <callback name="_g_reserved7">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="ParsablePrivate" c:type="GDataParsablePrivate" disguised="1">
    </record>
    <enumeration name="ParserError"
                 glib:type-name="GDataParserError"
                 glib:get-type="gdata_parser_error_get_type"
                 c:type="GDataParserError"
                 glib:error-domain="gdata-parser-error-quark">
      <doc xml:space="preserve">Error codes for XML or JSON parsing operations.</doc>
      <member name="parsing_string"
              value="1"
              c:identifier="GDATA_PARSER_ERROR_PARSING_STRING"
              glib:nick="parsing-string">
        <doc xml:space="preserve">Error parsing the XML or JSON syntax itself</doc>
      </member>
      <member name="empty_document"
              value="2"
              c:identifier="GDATA_PARSER_ERROR_EMPTY_DOCUMENT"
              glib:nick="empty-document">
        <doc xml:space="preserve">Empty document</doc>
      </member>
      <function name="quark" c:identifier="gdata_parser_error_quark">
        <return-value transfer-ownership="none">
          <type name="GLib.Quark" c:type="GQuark"/>
        </return-value>
      </function>
    </enumeration>
    <class name="PicasaWebAlbum"
           c:symbol-prefix="picasaweb_album"
           c:type="GDataPicasaWebAlbum"
           version="0.4.0"
           parent="Entry"
           glib:type-name="GDataPicasaWebAlbum"
           glib:get-type="gdata_picasaweb_album_get_type"
           glib:type-struct="PicasaWebAlbumClass">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebAlbum structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_picasaweb_album_new"
                   version="0.4.0">
        <doc xml:space="preserve">Creates a new #GDataPicasaWebAlbum with the given ID and default properties. @id is the ID which would be returned by gdata_entry_get_id(),
not gdata_picasaweb_album_get_id().

If @id is not %NULL and can't be parsed to extract an album ID, %NULL will be returned.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataPicasaWebAlbum, or %NULL; unref with g_object_unref()</doc>
          <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the album's entry ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_bytes_used"
              c:identifier="gdata_picasaweb_album_get_bytes_used"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:bytes-used property. It will return &lt;code class="literal"&gt;-1&lt;/code&gt; if the current authenticated
user is not the owner of the album.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the number of bytes used by the album and its contents, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="glong" c:type="glong"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_comment_count"
              c:identifier="gdata_picasaweb_album_get_comment_count"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:comment-count property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the number of comments on the album</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_contents"
              c:identifier="gdata_picasaweb_album_get_contents"
              version="0.4.0">
        <doc xml:space="preserve">Returns a list of media content, such as the cover image for the album.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataMediaContent items</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="MediaContent"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_coordinates"
              c:identifier="gdata_picasaweb_album_get_coordinates"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:latitude and #GDataPicasaWebAlbum:longitude properties,
setting the out parameters to them. If either latitude or longitude is %NULL, that parameter will not be set.
If the coordinates are unset, @latitude and @longitude will be set to %G_MAXDOUBLE.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
          <parameter name="latitude"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the latitude, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
          <parameter name="longitude"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the longitude, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_edited"
              c:identifier="gdata_picasaweb_album_get_edited"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:edited property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the time the album was last edited, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_id"
              c:identifier="gdata_picasaweb_album_get_id"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:album-id property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the album's ID</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_location"
              c:identifier="gdata_picasaweb_album_get_location"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:location property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the album's location, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_nickname"
              c:identifier="gdata_picasaweb_album_get_nickname"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:nickname property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the album owner's nickname</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_num_photos"
              c:identifier="gdata_picasaweb_album_get_num_photos"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:num-photos property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the number of photos currently in the album</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_num_photos_remaining"
              c:identifier="gdata_picasaweb_album_get_num_photos_remaining"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:num-photos-remaining property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the number of photos that can still be uploaded to the album</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_tags"
              c:identifier="gdata_picasaweb_album_get_tags"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:tags property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a %NULL-terminated array of tags associated with all the photos in the album, or %NULL</doc>
          <array c:type="gchar**">
            <type name="utf8"/>
          </array>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_thumbnails"
              c:identifier="gdata_picasaweb_album_get_thumbnails"
              version="0.4.0">
        <doc xml:space="preserve">Returns a list of thumbnails, often at different sizes, for this album.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataMediaThumbnail&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="MediaThumbnail"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_timestamp"
              c:identifier="gdata_picasaweb_album_get_timestamp"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:timestamp property. This value usually holds either the date that best corresponds to the album of photos, or to the
day it was uploaded. It's a UNIX timestamp in milliseconds (not seconds) since the epoch. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt;
will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the timestamp property in milliseconds, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_user"
              c:identifier="gdata_picasaweb_album_get_user"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:user property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the album owner's username</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_visibility"
              c:identifier="gdata_picasaweb_album_get_visibility"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:visibility property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the album's visibility level</doc>
          <type name="PicasaWebVisibility" c:type="GDataPicasaWebVisibility"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_commenting_enabled"
              c:identifier="gdata_picasaweb_album_is_commenting_enabled"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebAlbum:is-commenting-enabled property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if commenting is enabled for the album, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_coordinates"
              c:identifier="gdata_picasaweb_album_set_coordinates"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebAlbum:latitude and #GDataPicasaWebAlbum:longitude properties to
@latitude and @longitude respectively.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
          <parameter name="latitude" transfer-ownership="none">
            <doc xml:space="preserve">the album's new latitude coordinate, or %G_MAXDOUBLE</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
          <parameter name="longitude" transfer-ownership="none">
            <doc xml:space="preserve">the album's new longitude coordinate, or %G_MAXDOUBLE</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_commenting_enabled"
              c:identifier="gdata_picasaweb_album_set_is_commenting_enabled"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebAlbum:is-commenting-enabled property to @is_commenting_enabled.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
          <parameter name="is_commenting_enabled" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if commenting should be enabled for the album, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_location"
              c:identifier="gdata_picasaweb_album_set_location"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebAlbum:location property to @location.

Set @location to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
          <parameter name="location"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new album location, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_tags"
              c:identifier="gdata_picasaweb_album_set_tags"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebAlbum:tags property to @tags.

Set @tags to %NULL to unset the album's tag list.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
          <parameter name="tags"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new %NULL-terminated array of tags, or %NULL</doc>
            <array c:type="gchar**">
              <type name="utf8" c:type="gchar*"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="set_timestamp"
              c:identifier="gdata_picasaweb_album_set_timestamp"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebAlbum:timestamp property from @timestamp. This should be a UNIX timestamp in milliseconds (not seconds) since the epoch.

Set @timestamp to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
          <parameter name="timestamp" transfer-ownership="none">
            <doc xml:space="preserve">a UNIX timestamp, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_visibility"
              c:identifier="gdata_picasaweb_album_set_visibility"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebAlbum:visibility property to @visibility.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </instance-parameter>
          <parameter name="visibility" transfer-ownership="none">
            <doc xml:space="preserve">the new album visibility level</doc>
            <type name="PicasaWebVisibility"
                  c:type="GDataPicasaWebVisibility"/>
          </parameter>
        </parameters>
      </method>
      <property name="album-id"
                version="0.7.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The ID of the album. This is a substring of the ID returned by gdata_entry_get_id() for #GDataPicasaWebAlbum&lt;!-- --&gt;s; for example,
if gdata_entry_get_id() returned "http://picasaweb.google.com/data/entry/user/libgdata.picasaweb/albumid/5328889949261497249" for a
particular #GDataPicasaWebAlbum, the #GDataPicasaWebAlbum:album-id property would be "5328889949261497249".

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_id"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="bytes-used" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The number of bytes consumed by this album and its contents. Note that this is only set if the authenticated user is the owner of the
album; it's otherwise &lt;code class="literal"&gt;-1&lt;/code&gt;.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_bytesUsed"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="glong" c:type="glong"/>
      </property>
      <property name="comment-count" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The number of comments on the album.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_commentCount"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="edited" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The time this album was last edited. If the album has not been edited yet, the content indicates the time it was created.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/protocol/#appEdited"&gt;
Atom Publishing Protocol specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="is-commenting-enabled"
                writable="1"
                transfer-ownership="none">
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="latitude"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The location as a latitude coordinate associated with this album. Valid latitudes range from &lt;code class="literal"&gt;-90.0&lt;/code&gt;
to &lt;code class="literal"&gt;90.0&lt;/code&gt; inclusive.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/docs/2.0/reference.html#georss_where"&gt;
GeoRSS specification&lt;/ulink&gt;.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="location"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The user-specified location associated with the album. A place name.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_location"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="longitude"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The location as a longitude coordinate associated with this album. Valid longitudes range from &lt;code class="literal"&gt;-180.0&lt;/code&gt;
to &lt;code class="literal"&gt;180.0&lt;/code&gt; inclusive.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/docs/2.0/reference.html#georss_where"&gt;
GeoRSS specification&lt;/ulink&gt;.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="nickname" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The user's nickname. This is a user-specified value that should be used when referring to the user by name.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_nickname"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="num-photos" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The number of photos and videos in the album.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_numphotos"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="num-photos-remaining"
                version="0.4.0"
                transfer-ownership="none">
        <doc xml:space="preserve">The number of photos and videos that can still be uploaded to this album.
This doesn't account for quota, just a hardcoded maximum number per album set by Google.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_numphotosremaining"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="tags"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A %NULL-terminated array of tags associated with the album; all the tags associated with the individual photos in the album.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#media_keywords"&gt;
Media RSS specification&lt;/ulink&gt;.</doc>
        <array>
          <type name="utf8"/>
        </array>
      </property>
      <property name="timestamp"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The timestamp of when the album occurred, settable by the user. This a UNIX timestamp in milliseconds (not seconds) since the epoch.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_timestamp"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="user" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The username of the album owner.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_user"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="visibility"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The visibility (or access rights) of the album.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_access"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="PicasaWebVisibility"/>
      </property>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="PicasaWebAlbumPrivate"
              c:type="GDataPicasaWebAlbumPrivate*"/>
      </field>
    </class>
    <record name="PicasaWebAlbumClass"
            c:type="GDataPicasaWebAlbumClass"
            glib:is-gtype-struct-for="PicasaWebAlbum"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebAlbumClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="PicasaWebAlbumPrivate"
            c:type="GDataPicasaWebAlbumPrivate"
            disguised="1">
    </record>
    <class name="PicasaWebComment"
           c:symbol-prefix="picasaweb_comment"
           c:type="GDataPicasaWebComment"
           version="0.10.0"
           parent="Comment"
           glib:type-name="GDataPicasaWebComment"
           glib:get-type="gdata_picasaweb_comment_get_type"
           glib:type-struct="PicasaWebCommentClass">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebComment structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_picasaweb_comment_new"
                   version="0.10.0">
        <doc xml:space="preserve">Creates a new #GDataPicasaWebComment with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataPicasaWebComment; unref with g_object_unref()</doc>
          <type name="PicasaWebComment" c:type="GDataPicasaWebComment*"/>
        </return-value>
        <parameters>
          <parameter name="id" transfer-ownership="none">
            <doc xml:space="preserve">the comment's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <field name="parent">
        <type name="Comment" c:type="GDataComment"/>
      </field>
      <field name="priv">
        <type name="PicasaWebCommentPrivate"
              c:type="GDataPicasaWebCommentPrivate*"/>
      </field>
    </class>
    <record name="PicasaWebCommentClass"
            c:type="GDataPicasaWebCommentClass"
            glib:is-gtype-struct-for="PicasaWebComment"
            version="0.10.0">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebCommentClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="CommentClass" c:type="GDataCommentClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="PicasaWebCommentPrivate"
            c:type="GDataPicasaWebCommentPrivate"
            disguised="1">
    </record>
    <class name="PicasaWebFeed"
           c:symbol-prefix="picasaweb_feed"
           c:type="GDataPicasaWebFeed"
           version="0.6.0"
           parent="Feed"
           glib:type-name="GDataPicasaWebFeed"
           glib:get-type="gdata_picasaweb_feed_get_type"
           glib:type-struct="PicasaWebFeedClass">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebFeed structure are private and should never be accessed directly.</doc>
      <field name="parent">
        <type name="Feed" c:type="GDataFeed"/>
      </field>
      <field name="padding1" readable="0" private="1">
        <type name="gpointer" c:type="gpointer"/>
      </field>
    </class>
    <record name="PicasaWebFeedClass"
            c:type="GDataPicasaWebFeedClass"
            glib:is-gtype-struct-for="PicasaWebFeed"
            version="0.6.0">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebFeedClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="FeedClass" c:type="GDataFeedClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <class name="PicasaWebFile"
           c:symbol-prefix="picasaweb_file"
           c:type="GDataPicasaWebFile"
           version="0.4.0"
           parent="Entry"
           glib:type-name="GDataPicasaWebFile"
           glib:get-type="gdata_picasaweb_file_get_type"
           glib:type-struct="PicasaWebFileClass">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebFile structure are private and should never be accessed directly.</doc>
      <implements name="Commentable"/>
      <constructor name="new"
                   c:identifier="gdata_picasaweb_file_new"
                   version="0.4.0">
        <doc xml:space="preserve">Creates a new #GDataPicasaWebFile with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataPicasaWebFile; unref with g_object_unref()</doc>
          <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the file's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_album_id"
              c:identifier="gdata_picasaweb_file_get_album_id"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:album-id property. This is in the same form as returned by gdata_picasaweb_album_get_id().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the ID of the album containing the #GDataPicasaWebFile</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_caption"
              c:identifier="gdata_picasaweb_file_get_caption"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:caption property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the file's descriptive caption, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_checksum"
              c:identifier="gdata_picasaweb_file_get_checksum"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:checksum property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the checksum assigned to this file, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_comment_count"
              c:identifier="gdata_picasaweb_file_get_comment_count"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:comment-count property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the number of comments on the file</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_contents"
              c:identifier="gdata_picasaweb_file_get_contents"
              version="0.4.0">
        <doc xml:space="preserve">Returns a list of media content, e.g. the actual photo or video.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataMediaContent items</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="MediaContent"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_coordinates"
              c:identifier="gdata_picasaweb_file_get_coordinates"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:latitude and #GDataPicasaWebFile:longitude properties, setting the out parameters to them.
If either latitude or longitude is %NULL, that parameter will not be set. If the coordinates are unset,
@latitude and @longitude will be set to %G_MAXDOUBLE.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
          <parameter name="latitude"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the latitude, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
          <parameter name="longitude"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the longitude, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_credit"
              c:identifier="gdata_picasaweb_file_get_credit"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:credit property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the nickname of the user credited with this file</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_distance"
              c:identifier="gdata_picasaweb_file_get_distance"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:distance property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the distance recorded in the photo's EXIF, or &lt;code class="literal"&gt;-1&lt;/code&gt; if unknown</doc>
          <type name="gdouble" c:type="gdouble"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_edited"
              c:identifier="gdata_picasaweb_file_get_edited"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:edited property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the time the file was last edited, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_exposure"
              c:identifier="gdata_picasaweb_file_get_exposure"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:exposure property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the exposure value, or &lt;code class="literal"&gt;0&lt;/code&gt; if unknown</doc>
          <type name="gdouble" c:type="gdouble"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_flash"
              c:identifier="gdata_picasaweb_file_get_flash"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:flash property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if flash was used, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_focal_length"
              c:identifier="gdata_picasaweb_file_get_focal_length"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:focal-length property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the focal-length value, or &lt;code class="literal"&gt;-1&lt;/code&gt; if unknown</doc>
          <type name="gdouble" c:type="gdouble"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_fstop"
              c:identifier="gdata_picasaweb_file_get_fstop"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:fstop property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the F-stop value, or &lt;code class="literal"&gt;0&lt;/code&gt; if unknown</doc>
          <type name="gdouble" c:type="gdouble"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_height"
              c:identifier="gdata_picasaweb_file_get_height"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:height property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the height of the image or video, in pixels</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_id"
              c:identifier="gdata_picasaweb_file_get_id"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:file-id property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the file's ID</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_image_unique_id"
              c:identifier="gdata_picasaweb_file_get_image_unique_id"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:image-unique-id property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the photo's unique EXIF identifier, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_iso"
              c:identifier="gdata_picasaweb_file_get_iso"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:iso property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the ISO speed, or &lt;code class="literal"&gt;-1&lt;/code&gt; if unknown</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_make"
              c:identifier="gdata_picasaweb_file_get_make"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:make property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the name of the manufacturer of the camera, or %NULL if unknown</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_model"
              c:identifier="gdata_picasaweb_file_get_model"
              version="0.5.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:model property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the model name of the camera, or %NULL if unknown</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_rotation"
              c:identifier="gdata_picasaweb_file_get_rotation"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:rotation property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the image's rotation, in degrees</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_size"
              c:identifier="gdata_picasaweb_file_get_size"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:size property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the size of the file, in bytes</doc>
          <type name="gsize" c:type="gsize"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_tags"
              c:identifier="gdata_picasaweb_file_get_tags"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:tags property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a %NULL-terminated array of tags associated with the file, or %NULL</doc>
          <array c:type="gchar**">
            <type name="utf8"/>
          </array>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_thumbnails"
              c:identifier="gdata_picasaweb_file_get_thumbnails"
              version="0.4.0">
        <doc xml:space="preserve">Returns a list of thumbnails, often at different sizes, for this
file.  Currently, PicasaWeb usually returns three thumbnails, with
widths in pixels of 72, 144, and 288.  However, the thumbnail will
not be larger than the actual image, so thumbnails may be smaller
than the widths listed above.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataMediaThumbnail&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="MediaThumbnail"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_timestamp"
              c:identifier="gdata_picasaweb_file_get_timestamp"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:timestamp property. It's a UNIX timestamp in milliseconds (not seconds) since the epoch. If the property is unset,
&lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the timestamp property in milliseconds, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_version"
              c:identifier="gdata_picasaweb_file_get_version"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:version property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the file's version number, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_video_status"
              c:identifier="gdata_picasaweb_file_get_video_status"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:video-status property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the status of this video ("pending", "ready", "final" or "failed"), or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_width"
              c:identifier="gdata_picasaweb_file_get_width"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:width property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the width of the image or video, in pixels</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_commenting_enabled"
              c:identifier="gdata_picasaweb_file_is_commenting_enabled"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebFile:is-commenting-enabled property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if commenting is enabled, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_album_id"
              c:identifier="gdata_picasaweb_file_set_album_id"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebFile:album-id property, effectively moving the file to the album.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
          <parameter name="album_id" transfer-ownership="none">
            <doc xml:space="preserve">the ID of the new album for this file</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_caption"
              c:identifier="gdata_picasaweb_file_set_caption"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebFile:caption property to @caption.

Set @caption to %NULL to unset the file's caption.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
          <parameter name="caption"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the file's new caption, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_checksum"
              c:identifier="gdata_picasaweb_file_set_checksum"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebFile:checksum property to @checksum.

Set @checksum to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
          <parameter name="checksum"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new checksum for this file, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_coordinates"
              c:identifier="gdata_picasaweb_file_set_coordinates"
              version="0.5.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebFile:latitude and #GDataPicasaWebFile:longitude properties to
@latitude and @longitude respectively.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
          <parameter name="latitude" transfer-ownership="none">
            <doc xml:space="preserve">the file's new latitude coordinate, or %G_MAXDOUBLE</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
          <parameter name="longitude" transfer-ownership="none">
            <doc xml:space="preserve">the file's new longitude coordinate, or %G_MAXDOUBLE</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_commenting_enabled"
              c:identifier="gdata_picasaweb_file_set_is_commenting_enabled"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebFile:is-commenting-enabled property to @is_commenting_enabled.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
          <parameter name="is_commenting_enabled" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if commenting should be enabled for the file, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_rotation"
              c:identifier="gdata_picasaweb_file_set_rotation"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebFile:rotation property to @rotation.

The rotation is absolute, rather than cumulative, through successive calls to gdata_picasaweb_file_set_rotation(),
so calling it with 90° then 20° will result in a final rotation of 20°.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
          <parameter name="rotation" transfer-ownership="none">
            <doc xml:space="preserve">the new rotation for the image, in degrees</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_tags"
              c:identifier="gdata_picasaweb_file_set_tags"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebFile:tags property to @tags.

Set @tags to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
          <parameter name="tags"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new %NULL-terminated array of tags, or %NULL</doc>
            <array c:type="gchar**">
              <type name="utf8" c:type="gchar*"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="set_timestamp"
              c:identifier="gdata_picasaweb_file_set_timestamp"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebFile:timestamp property from @timestamp. This should be a UNIX timestamp in milliseconds (not seconds) since the epoch. If
@timestamp is &lt;code class="literal"&gt;-1&lt;/code&gt;, the property will be unset.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </instance-parameter>
          <parameter name="timestamp" transfer-ownership="none">
            <doc xml:space="preserve">a UNIX timestamp, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <property name="album-id"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The ID for the file's album. This is in the same form as returned by gdata_picasaweb_album_get_id().

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_albumid"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="caption"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The file's descriptive caption.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="checksum"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A checksum of the file, useful for duplicate detection.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_checksum"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="comment-count" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The number of comments on the file.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_commentCount"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="credit" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The nickname of the user credited with this file.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#media_credit"&gt;Media RSS
specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="distance" version="0.5.0" transfer-ownership="none">
        <doc xml:space="preserve">The distance to the subject reported in the image's EXIF.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference"&gt;
EXIF element reference&lt;/ulink&gt;.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="edited" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The time this file was last edited. If the file has not been edited yet, the content indicates the time it was created.

For more information, see the &lt;ulink type="http" url="http://www.atomenabled.org/developers/protocol/#appEdited"&gt;
Atom Publishing Protocol specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="exposure" version="0.5.0" transfer-ownership="none">
        <doc xml:space="preserve">The exposure time.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference"&gt;
EXIF element reference&lt;/ulink&gt;.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="file-id"
                version="0.7.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The ID of the file. This is a substring of the ID returned by gdata_entry_get_id() for #GDataPicasaWebFile&lt;!-- --&gt;s; for example,
if gdata_entry_get_id() returned
"http://picasaweb.google.com/data/entry/user/libgdata.picasaweb/albumid/5328889949261497249/photoid/5328890138794566386" for a
particular #GDataPicasaWebFile, the #GDataPicasaWebFile:file-id property would be "5328890138794566386".

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_id"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="flash" version="0.5.0" transfer-ownership="none">
        <doc xml:space="preserve">Indicates whether the flash was used.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference"&gt;
EXIF element reference&lt;/ulink&gt;.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="focal-length" version="0.5.0" transfer-ownership="none">
        <doc xml:space="preserve">The focal length for the shot.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference"&gt;
EXIF element reference&lt;/ulink&gt;.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="fstop" version="0.5.0" transfer-ownership="none">
        <doc xml:space="preserve">The F-stop value.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference"&gt;
EXIF element reference&lt;/ulink&gt;.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="height" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The height of the photo or video, in pixels.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_height"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="image-unique-id"
                version="0.5.0"
                transfer-ownership="none">
        <doc xml:space="preserve">An unique ID for the image found in the EXIF.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference"&gt;
EXIF element reference&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="is-commenting-enabled"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Whether commenting is enabled for this file.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="iso" version="0.5.0" transfer-ownership="none">
        <doc xml:space="preserve">The ISO speed.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference"&gt;
EXIF element reference&lt;/ulink&gt; and ISO 5800:1987.</doc>
        <type name="glong" c:type="glong"/>
      </property>
      <property name="latitude"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The location as a latitude coordinate associated with this file. Valid latitudes range from &lt;code class="literal"&gt;-90.0&lt;/code&gt;
to &lt;code class="literal"&gt;90.0&lt;/code&gt; inclusive.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/docs/2.0/reference.html#georss_where"&gt;
GeoRSS specification&lt;/ulink&gt;.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="longitude"
                version="0.5.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The location as a longitude coordinate associated with this file. Valid longitudes range from &lt;code class="literal"&gt;-180.0&lt;/code&gt;
to &lt;code class="literal"&gt;180.0&lt;/code&gt; inclusive.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/docs/2.0/reference.html#georss_where"&gt;
GeoRSS specification&lt;/ulink&gt;.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="make" version="0.5.0" transfer-ownership="none">
        <doc xml:space="preserve">The name of the manufacturer of the camera.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference"&gt;
EXIF element reference&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="model" version="0.5.0" transfer-ownership="none">
        <doc xml:space="preserve">The model of the camera.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference"&gt;
EXIF element reference&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="rotation"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The rotation of the photo, in degrees. This will only be non-zero for files which are pending rotation, and haven't yet been
permanently modified. For files which have already been rotated, this will be &lt;code class="literal"&gt;0&lt;/code&gt;.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_rotation"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="size" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The size of the file, in bytes.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_size"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="gulong" c:type="gulong"/>
      </property>
      <property name="tags"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A %NULL-terminated array of tags associated with the file.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#media_keywords"&gt;
Media RSS specification&lt;/ulink&gt;.</doc>
        <array>
          <type name="utf8"/>
        </array>
      </property>
      <property name="timestamp"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The time the file was purportedly taken. This a UNIX timestamp in milliseconds (not seconds) since the epoch.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_timestamp"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="version"
                version="0.4.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The version number of the file. Version numbers are based on modification time, so they don't increment linearly.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_version"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="video-status" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The status of the file, if it is a video. For example: %GDATA_PICASAWEB_VIDEO_STATUS_PENDING or %GDATA_PICASAWEB_VIDEO_STATUS_FAILED.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_videostatus"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="width" version="0.4.0" transfer-ownership="none">
        <doc xml:space="preserve">The width of the photo or video, in pixels.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_width"&gt;
gphoto specification&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="PicasaWebFilePrivate" c:type="GDataPicasaWebFilePrivate*"/>
      </field>
    </class>
    <record name="PicasaWebFileClass"
            c:type="GDataPicasaWebFileClass"
            glib:is-gtype-struct-for="PicasaWebFile"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebFileClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="PicasaWebFilePrivate"
            c:type="GDataPicasaWebFilePrivate"
            disguised="1">
    </record>
    <class name="PicasaWebQuery"
           c:symbol-prefix="picasaweb_query"
           c:type="GDataPicasaWebQuery"
           version="0.4.0"
           parent="Query"
           glib:type-name="GDataPicasaWebQuery"
           glib:get-type="gdata_picasaweb_query_get_type"
           glib:type-struct="PicasaWebQueryClass">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebQuery structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_picasaweb_query_new"
                   version="0.4.0">
        <doc xml:space="preserve">Creates a new #GDataPicasaWebQuery with its #GDataQuery:q property set to @q.

Note that when querying for albums with gdata_picasaweb_service_query_all_albums(), the @q parameter cannot be used.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataPicasaWebQuery</doc>
          <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
        </return-value>
        <parameters>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <constructor name="new_with_limits"
                   c:identifier="gdata_picasaweb_query_new_with_limits"
                   version="0.6.0">
        <doc xml:space="preserve">Creates a #GDataPicasaWebQuery with its #GDataQuery:q property set to @q, returning @max_results starting from the @start_index&lt;!-- --&gt;th result.

Note that when querying for albums with gdata_picasaweb_service_query_all_albums(), the @q parameter cannot be used.

This is useful for paging through results, but the result set between separate queries may change. So, if you use this to
request the next ten results after a previous query, it may include some of the previously returned results if their order changed, or
omit ones that would have otherwise been found in a earlier but larger query.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataPicasaWebQuery</doc>
          <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
        </return-value>
        <parameters>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="start_index" transfer-ownership="none">
            <doc xml:space="preserve">the index of the first result to include, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="max_results" transfer-ownership="none">
            <doc xml:space="preserve">the maximum number of results to include, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_bounding_box"
              c:identifier="gdata_picasaweb_query_get_bounding_box"
              version="0.4.0">
        <doc xml:space="preserve">Gets the latitudes and longitudes of a bounding box, inside which all the results must lie.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebQuery</doc>
            <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
          </instance-parameter>
          <parameter name="north"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the latitude of the top of the box, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
          <parameter name="east"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the longitude of the right of the box, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
          <parameter name="south"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the latitude of the south of the box, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
          <parameter name="west"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the longitude of the left of the box, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_image_size"
              c:identifier="gdata_picasaweb_query_get_image_size"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebQuery:image-size property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the currently set desired image size for retrieval, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebQuery</doc>
            <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_location"
              c:identifier="gdata_picasaweb_query_get_location"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebQuery:location property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a location which returned objects must be near, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebQuery</doc>
            <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_tag"
              c:identifier="gdata_picasaweb_query_get_tag"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebQuery:tag property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a tag which retrieved objects must have, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebQuery</doc>
            <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_thumbnail_size"
              c:identifier="gdata_picasaweb_query_get_thumbnail_size"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebQuery:thumbnail-size property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a comma-separated list of thumbnail sizes to retrieve, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebQuery</doc>
            <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_visibility"
              c:identifier="gdata_picasaweb_query_get_visibility"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebQuery:visibility property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the visibility of the objects to retrieve, or &lt;code class="literal"&gt;0&lt;/code&gt; to retrieve all objects</doc>
          <type name="PicasaWebVisibility" c:type="GDataPicasaWebVisibility"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebQuery</doc>
            <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_bounding_box"
              c:identifier="gdata_picasaweb_query_set_bounding_box"
              version="0.4.0">
        <doc xml:space="preserve">Sets a bounding box, inside which all the returned results must lie.

Set @north, @east, @south and @west to &lt;code class="literal"&gt;0&lt;/code&gt; to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebQuery</doc>
            <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
          </instance-parameter>
          <parameter name="north" transfer-ownership="none">
            <doc xml:space="preserve">latitude of the top of the box</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
          <parameter name="east" transfer-ownership="none">
            <doc xml:space="preserve">longitude of the right of the box</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
          <parameter name="south" transfer-ownership="none">
            <doc xml:space="preserve">latitude of the bottom of the box</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
          <parameter name="west" transfer-ownership="none">
            <doc xml:space="preserve">longitude of the left of the box</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_image_size"
              c:identifier="gdata_picasaweb_query_set_image_size"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebQuery:image-size property to @image_size.
Valid sizes are described in the
&lt;ulink type="http" url="http://code.google.com/apis/picasaweb/docs/2.0/reference.html#Parameters"&gt;online documentation&lt;/ulink&gt;.

Set @image_size to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebQuery</doc>
            <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
          </instance-parameter>
          <parameter name="image_size"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the desired size of the image to be retrieved, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_location"
              c:identifier="gdata_picasaweb_query_set_location"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebQuery:location property to @location.

Set @location to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebQuery</doc>
            <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
          </instance-parameter>
          <parameter name="location"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a location which returned objects must be near, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_tag"
              c:identifier="gdata_picasaweb_query_set_tag"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebQuery:tag property to @tag.

Set @tag to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebQuery</doc>
            <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
          </instance-parameter>
          <parameter name="tag"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a tag which retrieved objects must have, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_thumbnail_size"
              c:identifier="gdata_picasaweb_query_set_thumbnail_size"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebQuery:thumbnail-size property to @thumbnail_size.

Set @thumbnail_size to %NULL to unset the property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebQuery</doc>
            <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
          </instance-parameter>
          <parameter name="thumbnail_size"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a comma-separated list of thumbnail sizes to retrieve, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_visibility"
              c:identifier="gdata_picasaweb_query_set_visibility"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataPicasaWebQuery:visibility property to @visibility.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebQuery</doc>
            <type name="PicasaWebQuery" c:type="GDataPicasaWebQuery*"/>
          </instance-parameter>
          <parameter name="visibility" transfer-ownership="none">
            <doc xml:space="preserve">the visibility of the objects to retrieve, or &lt;code class="literal"&gt;0&lt;/code&gt; to retrieve all objects</doc>
            <type name="PicasaWebVisibility"
                  c:type="GDataPicasaWebVisibility"/>
          </parameter>
        </parameters>
      </method>
      <property name="image-size"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">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
&lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#Parameters"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="location"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A location to search for photos, e.g. "London".</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="tag"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A tag which returned results must contain.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="thumbnail-size"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">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
&lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#Parameters"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="visibility"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies which albums should be listed, in terms of their visibility (#GDataPicasaWebAlbum:visibility).

Set the property to &lt;code class="literal"&gt;0&lt;/code&gt; to list all albums, regardless of their visibility. Otherwise, use values
from #GDataPicasaWebVisibility.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#Visibility"&gt;
online documentation&lt;/ulink&gt;.</doc>
        <type name="gint" c:type="gint"/>
      </property>
      <field name="parent">
        <type name="Query" c:type="GDataQuery"/>
      </field>
      <field name="priv">
        <type name="PicasaWebQueryPrivate"
              c:type="GDataPicasaWebQueryPrivate*"/>
      </field>
    </class>
    <record name="PicasaWebQueryClass"
            c:type="GDataPicasaWebQueryClass"
            glib:is-gtype-struct-for="PicasaWebQuery"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebQueryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="QueryClass" c:type="GDataQueryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="PicasaWebQueryPrivate"
            c:type="GDataPicasaWebQueryPrivate"
            disguised="1">
    </record>
    <class name="PicasaWebService"
           c:symbol-prefix="picasaweb_service"
           c:type="GDataPicasaWebService"
           version="0.4.0"
           parent="Service"
           glib:type-name="GDataPicasaWebService"
           glib:get-type="gdata_picasaweb_service_get_type"
           glib:type-struct="PicasaWebServiceClass">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebService structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_picasaweb_service_new"
                   version="0.9.0">
        <doc xml:space="preserve">Creates a new #GDataPicasaWebService using the given #GDataAuthorizer. If @authorizer is %NULL, all requests are made as an unauthenticated user.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataPicasaWebService, or %NULL; unref with g_object_unref()</doc>
          <type name="PicasaWebService" c:type="GDataPicasaWebService*"/>
        </return-value>
        <parameters>
          <parameter name="authorizer"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataAuthorizer to authorize the service's requests, or %NULL</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </parameter>
        </parameters>
      </constructor>
      <function name="get_primary_authorization_domain"
                c:identifier="gdata_picasaweb_service_get_primary_authorization_domain"
                version="0.9.0">
        <doc xml:space="preserve">The primary #GDataAuthorizationDomain for interacting with PicasaWeb. This will not normally need to be used, as it's used internally
by the #GDataPicasaWebService methods. However, if using the plain #GDataService methods to implement custom queries or requests which libgdata
does not support natively, then this domain may be needed to authorize the requests.

The domain never changes, and is interned so that pointer comparison can be used to differentiate it from other authorization domains.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the service's authorization domain</doc>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
      </function>
      <method name="finish_file_upload"
              c:identifier="gdata_picasaweb_service_finish_file_upload"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Finish off a file upload operation started by gdata_picasaweb_service_upload_file(), parsing the result and returning the new #GDataPicasaWebFile.

If an error occurred during the upload operation, it will have been returned during the operation (e.g. by g_output_stream_splice() or one
of the other stream methods). In such a case, %NULL will be returned but @error will remain unset. @error is only set in the case that the server
indicates that the operation was successful, but an error is encountered in parsing the result sent by the server.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the new #GDataPicasaWebFile, or %NULL; unref with g_object_unref()</doc>
          <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebService</doc>
            <type name="PicasaWebService" c:type="GDataPicasaWebService*"/>
          </instance-parameter>
          <parameter name="upload_stream" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataUploadStream from the operation</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_user"
              c:identifier="gdata_picasaweb_service_get_user"
              version="0.6.0"
              throws="1">
        <doc xml:space="preserve">Queries the service to return the user specified by @username.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataPicasaWebUser; unref with g_object_unref()</doc>
          <type name="PicasaWebUser" c:type="GDataPicasaWebUser*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebService</doc>
            <type name="PicasaWebService" c:type="GDataPicasaWebService*"/>
          </instance-parameter>
          <parameter name="username"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the username of the user whose information you wish to retrieve, or %NULL for the currently authenticated user.</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_user_async"
              c:identifier="gdata_picasaweb_service_get_user_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the service to return the user specified by @username.

For more details, see gdata_picasaweb_service_get_user() which is the synchronous version of this method.

When the operation is finished, @callback will be called. You can then call gdata_picasaweb_service_get_user_finish() to get the results of the
operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebService</doc>
            <type name="PicasaWebService" c:type="GDataPicasaWebService*"/>
          </instance-parameter>
          <parameter name="username"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the username of the user whose information you wish to retrieve, or %NULL for the currently authenticated user</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the query is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_user_finish"
              c:identifier="gdata_picasaweb_service_get_user_finish"
              version="0.9.1"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous user retrieval operation started with gdata_picasaweb_service_get_user_async().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataPicasaWebUser; unref with g_object_unref()</doc>
          <type name="PicasaWebUser" c:type="GDataPicasaWebUser*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebService</doc>
            <type name="PicasaWebService" c:type="GDataPicasaWebService*"/>
          </instance-parameter>
          <parameter name="result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_album"
              c:identifier="gdata_picasaweb_service_insert_album"
              version="0.6.0"
              throws="1">
        <doc xml:space="preserve">Inserts a new album described by @album. A user must be
authenticated to use this function.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the inserted #GDataPicasaWebAlbum; unref with
g_object_unref()</doc>
          <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebService</doc>
            <type name="PicasaWebService" c:type="GDataPicasaWebService*"/>
          </instance-parameter>
          <parameter name="album" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum to create on the server</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_album_async"
              c:identifier="gdata_picasaweb_service_insert_album_async"
              version="0.8.0">
        <doc xml:space="preserve">Inserts a new album described by @album. The user must be authenticated to use this function. @self and @album are both reffed when this function
is called, so can safely be unreffed after this function returns.

@callback should call gdata_service_insert_entry_finish() to obtain a #GDataPicasaWebAlbum representing the inserted album and to check for
possible errors.

For more details, see gdata_picasaweb_service_insert_album(), which is the synchronous version of this function, and
gdata_service_insert_entry_async(), which is the base asynchronous insertion function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebService</doc>
            <type name="PicasaWebService" c:type="GDataPicasaWebService*"/>
          </instance-parameter>
          <parameter name="album" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum to create on the server</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when insertion is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_all_albums"
              c:identifier="gdata_picasaweb_service_query_all_albums"
              version="0.4.0"
              throws="1">
        <doc xml:space="preserve">Queries the service to return a list of all albums belonging to the specified @username which match the given
@query. If a user is authenticated with the service, @username can be set as %NULL to return a list of albums belonging
to the currently-authenticated user.

Note that the #GDataQuery:q query parameter cannot be set on @query for album queries.

For more details, see gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebService</doc>
            <type name="PicasaWebService" c:type="GDataPicasaWebService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="username"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the username of the user whose albums you wish to retrieve, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_all_albums_async"
              c:identifier="gdata_picasaweb_service_query_all_albums_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the service to return a list of all albums belonging to the specified @username which match the given
@query. @self, @query and @username are all reffed/copied when this function is called, so can safely be unreffed/freed after
this function returns.

For more details, see gdata_picasaweb_service_query_all_albums(), which is the synchronous version of
this function, and gdata_service_query_async(), which is the base asynchronous query function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebService</doc>
            <type name="PicasaWebService" c:type="GDataPicasaWebService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="username"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the username of the user whose albums you wish to retrieve, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="4"
                     destroy="5">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="7">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authentication is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_files"
              c:identifier="gdata_picasaweb_service_query_files"
              version="0.4.0"
              throws="1">
        <doc xml:space="preserve">Queries the specified @album for a list of the files which match the given @query. If @album is %NULL and a user is
authenticated with the service, the user's default album will be queried.

For more details, see gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebService</doc>
            <type name="PicasaWebService" c:type="GDataPicasaWebService*"/>
          </instance-parameter>
          <parameter name="album"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum from which to retrieve the files, or %NULL</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_files_async"
              c:identifier="gdata_picasaweb_service_query_files_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the specified @album for a list of the files which match the given @query. If @album is %NULL and a user is authenticated with the service,
the user's default album will be queried. @self, @album and @query are all reffed when this function is called, so can safely be unreffed after
this function returns.

For more details, see gdata_picasaweb_service_query_files(), which is the synchronous version of this function, and gdata_service_query_async(),
which is the base asynchronous query function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebService</doc>
            <type name="PicasaWebService" c:type="GDataPicasaWebService*"/>
          </instance-parameter>
          <parameter name="album"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum from which to retrieve the files, or %NULL</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="4"
                     destroy="5">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="7">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the query is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="upload_file"
              c:identifier="gdata_picasaweb_service_upload_file"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Uploads a file (photo or video) to the given PicasaWeb @album, using the metadata from @file and the file data written to the resulting
#GDataUploadStream. If @album is %NULL, the file will be uploaded to the currently-authenticated user's "Drop Box" album. A user must be
authenticated to use this function.

If @file has already been inserted, a %GDATA_SERVICE_ERROR_ENTRY_ALREADY_INSERTED error will be returned. If no user is authenticated
with the service, %GDATA_SERVICE_ERROR_AUTHENTICATION_REQUIRED will be returned.

The stream returned by this function should be written to using the standard #GOutputStream methods, asychronously or synchronously. Once the stream
is closed (using g_output_stream_close()), gdata_picasaweb_service_finish_file_upload() should be called on it to parse and return the updated
#GDataPicasaWebFile for the uploaded file. This must be done, as @file_entry isn't updated in-place.

In order to cancel the upload, a #GCancellable passed in to @cancellable must be cancelled using g_cancellable_cancel(). Cancelling the individual
#GOutputStream operations on the #GDataUploadStream will not cancel the entire upload; merely the write or close operation in question. See the
#GDataUploadStream:cancellable for more details.

Any upload errors will be thrown by the stream methods, and may come from the #GDataServiceError domain.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataUploadStream to write the file data to, or %NULL; unref with g_object_unref()</doc>
          <type name="UploadStream" c:type="GDataUploadStream*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebService</doc>
            <type name="PicasaWebService" c:type="GDataPicasaWebService*"/>
          </instance-parameter>
          <parameter name="album"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataPicasaWebAlbum into which to insert the file, or %NULL</doc>
            <type name="PicasaWebAlbum" c:type="GDataPicasaWebAlbum*"/>
          </parameter>
          <parameter name="file_entry" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebFile to insert</doc>
            <type name="PicasaWebFile" c:type="GDataPicasaWebFile*"/>
          </parameter>
          <parameter name="slug" transfer-ownership="none">
            <doc xml:space="preserve">the filename to give to the uploaded file</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="content_type" transfer-ownership="none">
            <doc xml:space="preserve">the content type of the uploaded data</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable for the entire upload stream, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <field name="parent">
        <type name="Service" c:type="GDataService"/>
      </field>
    </class>
    <record name="PicasaWebServiceClass"
            c:type="GDataPicasaWebServiceClass"
            glib:is-gtype-struct-for="PicasaWebService"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebServiceClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ServiceClass" c:type="GDataServiceClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <class name="PicasaWebUser"
           c:symbol-prefix="picasaweb_user"
           c:type="GDataPicasaWebUser"
           version="0.6.0"
           parent="Entry"
           glib:type-name="GDataPicasaWebUser"
           glib:get-type="gdata_picasaweb_user_get_type"
           glib:type-struct="PicasaWebUserClass">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebUser structure are private and should never be accessed directly.</doc>
      <method name="get_max_photos_per_album"
              c:identifier="gdata_picasaweb_user_get_max_photos_per_album"
              version="0.6.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebUser:max-photos-per-album property.  Note that
this information is not available when accessing feeds which we
haven't authenticated, and &lt;code class="literal"&gt;0&lt;/code&gt; is returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the maximum number of photos an album for this account can hold, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebUser</doc>
            <type name="PicasaWebUser" c:type="GDataPicasaWebUser*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_nickname"
              c:identifier="gdata_picasaweb_user_get_nickname"
              version="0.6.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebUser:nickname property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the nickname of the feed's user's nickname, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebUser</doc>
            <type name="PicasaWebUser" c:type="GDataPicasaWebUser*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_quota_current"
              c:identifier="gdata_picasaweb_user_get_quota_current"
              version="0.6.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebUser:quota-current property.  Note that
this information is not available when accessing feeds which we
haven't authenticated, and &lt;code class="literal"&gt;0&lt;/code&gt; is returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the current number of bytes in use by this feed's account, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebUser</doc>
            <type name="PicasaWebUser" c:type="GDataPicasaWebUser*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_quota_limit"
              c:identifier="gdata_picasaweb_user_get_quota_limit"
              version="0.6.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebUser:quota-limit property. Note that
this information is not available when accessing feeds which we
haven't authenticated, and &lt;code class="literal"&gt;0&lt;/code&gt; is returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the maximum capacity in bytes for this feed's account, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebUser</doc>
            <type name="PicasaWebUser" c:type="GDataPicasaWebUser*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_thumbnail_uri"
              c:identifier="gdata_picasaweb_user_get_thumbnail_uri"
              version="0.6.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebUser:thumbnail-uri property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the URI for the thumbnail of the account, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebUser</doc>
            <type name="PicasaWebUser" c:type="GDataPicasaWebUser*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_user"
              c:identifier="gdata_picasaweb_user_get_user"
              version="0.6.0">
        <doc xml:space="preserve">Gets the #GDataPicasaWebUser:user property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the feed's user, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataPicasaWebUser</doc>
            <type name="PicasaWebUser" c:type="GDataPicasaWebUser*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="max-photos-per-album"
                version="0.6.0"
                transfer-ownership="none">
        <doc xml:space="preserve">The maximum number of photos allowed in an album.
http://code.google.com/apis/picasaweb/docs/2.0/reference.html#gphoto_maxPhotosPerAlbum

If the #GDataPicasaWebUser does not represent the currently authenticated user, this will be &lt;code class="literal"&gt;-1&lt;/code&gt;.</doc>
        <type name="gint" c:type="gint"/>
      </property>
      <property name="nickname" version="0.6.0" transfer-ownership="none">
        <doc xml:space="preserve">The user's nickname. This is a user-specified value that should be used when referring to the user by name.
http://code.google.com/apis/picasaweb/docs/2.0/reference.html#gphoto_nickname</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="quota-current" version="0.6.0" transfer-ownership="none">
        <doc xml:space="preserve">The current amount of space, in bytes, already used by the user.
http://code.google.com/apis/picasaweb/docs/2.0/reference.html#gphoto_quotacurrent

If the #GDataPicasaWebUser does not represent the currently authenticated user, this will be &lt;code class="literal"&gt;-1&lt;/code&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="quota-limit" version="0.6.0" transfer-ownership="none">
        <doc xml:space="preserve">The total amount of space, in bytes, available to the user.
http://code.google.com/apis/picasaweb/docs/2.0/reference.html#gphoto_quotalimit

If the #GDataPicasaWebUser does not represent the currently authenticated user, this will be &lt;code class="literal"&gt;-1&lt;/code&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="thumbnail-uri" version="0.6.0" transfer-ownership="none">
        <doc xml:space="preserve">The URI of a thumbnail-sized portrait of the user.
http://code.google.com/apis/picasaweb/docs/2.0/reference.html#gphoto_thumbnail</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="user" version="0.6.0" transfer-ownership="none">
        <doc xml:space="preserve">The username of the user, as seen in feed URLs.
http://code.google.com/apis/picasaweb/docs/2.0/reference.html#gphoto_user</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="PicasaWebUserPrivate" c:type="GDataPicasaWebUserPrivate*"/>
      </field>
    </class>
    <record name="PicasaWebUserClass"
            c:type="GDataPicasaWebUserClass"
            glib:is-gtype-struct-for="PicasaWebUser"
            version="0.6.0">
      <doc xml:space="preserve">All the fields in the #GDataPicasaWebUserClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="PicasaWebUserPrivate"
            c:type="GDataPicasaWebUserPrivate"
            disguised="1">
    </record>
    <enumeration name="PicasaWebVisibility"
                 version="0.4.0"
                 glib:type-name="GDataPicasaWebVisibility"
                 glib:get-type="gdata_picasaweb_visibility_get_type"
                 c:type="GDataPicasaWebVisibility">
      <doc xml:space="preserve">Visibility statuses available for albums on PicasaWeb. For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#Visibility"&gt;online documentation&lt;/ulink&gt;.</doc>
      <member name="public"
              value="1"
              c:identifier="GDATA_PICASAWEB_PUBLIC"
              glib:nick="public">
        <doc xml:space="preserve">the album is visible to everyone, regardless of whether they're authenticated</doc>
      </member>
      <member name="private"
              value="2"
              c:identifier="GDATA_PICASAWEB_PRIVATE"
              glib:nick="private">
        <doc xml:space="preserve">the album is visible only to authenticated users in a whitelist</doc>
      </member>
    </enumeration>
    <class name="Query"
           c:symbol-prefix="query"
           c:type="GDataQuery"
           parent="GObject.Object"
           glib:type-name="GDataQuery"
           glib:get-type="gdata_query_get_type"
           glib:type-struct="QueryClass">
      <doc xml:space="preserve">All the fields in the #GDataQuery structure are private and should never be accessed directly.</doc>
      <constructor name="new" c:identifier="gdata_query_new">
        <doc xml:space="preserve">Creates a new #GDataQuery with its #GDataQuery:q property set to @q.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataQuery</doc>
          <type name="Query" c:type="GDataQuery*"/>
        </return-value>
        <parameters>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <constructor name="new_with_limits"
                   c:identifier="gdata_query_new_with_limits">
        <doc xml:space="preserve">Creates a new #GDataQuery with its #GDataQuery:q property set to @q, and the limits @start_index and @max_results
applied.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataQuery</doc>
          <type name="Query" c:type="GDataQuery*"/>
        </return-value>
        <parameters>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="start_index" transfer-ownership="none">
            <doc xml:space="preserve">a one-based start index for the results, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="max_results" transfer-ownership="none">
            <doc xml:space="preserve">the maximum number of results to return, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </constructor>
      <virtual-method name="get_query_uri">
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="feed_uri" transfer-ownership="none">
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="query_uri" transfer-ownership="none">
            <type name="GLib.String" c:type="GString*"/>
          </parameter>
          <parameter name="params_started" transfer-ownership="none">
            <type name="gboolean" c:type="gboolean*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <method name="get_author" c:identifier="gdata_query_get_author">
        <doc xml:space="preserve">Gets the #GDataQuery:author property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the author property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_categories" c:identifier="gdata_query_get_categories">
        <doc xml:space="preserve">Gets the #GDataQuery:categories property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the categories property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_etag"
              c:identifier="gdata_query_get_etag"
              version="0.2.0">
        <doc xml:space="preserve">Gets the #GDataQuery:etag property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the ETag property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_max_results"
              c:identifier="gdata_query_get_max_results">
        <doc xml:space="preserve">Gets the #GDataQuery:max-results property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the maximum results property, or &lt;code class="literal"&gt;0&lt;/code&gt; if it is unset</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_published_max"
              c:identifier="gdata_query_get_published_max">
        <doc xml:space="preserve">Gets the #GDataQuery:published-max property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the published-max property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_published_min"
              c:identifier="gdata_query_get_published_min">
        <doc xml:space="preserve">Gets the #GDataQuery:published-min property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the published-min property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_q" c:identifier="gdata_query_get_q">
        <doc xml:space="preserve">Gets the #GDataQuery:q property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the q property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_query_uri" c:identifier="gdata_query_get_query_uri">
        <doc xml:space="preserve">Builds a query URI from the given base feed URI, using the properties of the #GDataQuery. This function will take care
of all necessary URI escaping, so it should &lt;emphasis&gt;not&lt;/emphasis&gt; be done beforehand.

The query URI is what functions like gdata_service_query() use to query the online service.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a query URI; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="feed_uri" transfer-ownership="none">
            <doc xml:space="preserve">the feed URI on which to build the query URI</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_start_index"
              c:identifier="gdata_query_get_start_index">
        <doc xml:space="preserve">Gets the #GDataQuery:start-index property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the start index property, or &lt;code class="literal"&gt;0&lt;/code&gt; if it is unset</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_updated_max"
              c:identifier="gdata_query_get_updated_max">
        <doc xml:space="preserve">Gets the #GDataQuery:updated-max property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the updated-max property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_updated_min"
              c:identifier="gdata_query_get_updated_min">
        <doc xml:space="preserve">Gets the #GDataQuery:updated-min property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the updated-min property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_strict"
              c:identifier="gdata_query_is_strict"
              version="0.2.0">
        <doc xml:space="preserve">Gets the #GDataQuery:is-strict property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the strict property</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="next_page" c:identifier="gdata_query_next_page">
        <doc xml:space="preserve">Changes the state of the #GDataQuery such that when gdata_query_get_query_uri() is next called, it will build the
query URI for the next page in the result set.

Ideally, the URI of the next page is retrieved from a feed automatically when gdata_service_query() is called, but
gdata_query_next_page() will fall back to using #GDataQuery:start-index to emulate true pagination if this fails.

You &lt;emphasis&gt;should not&lt;/emphasis&gt; implement pagination manually using #GDataQuery:start-index.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="previous_page" c:identifier="gdata_query_previous_page">
        <doc xml:space="preserve">Changes the state of the #GDataQuery such that when gdata_query_get_query_uri() is next called, it will build the
query URI for the previous page in the result set.

See the documentation for gdata_query_next_page() for an explanation of how query URIs from the feeds are used to this end.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if there is a previous page and it has been switched to, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_author" c:identifier="gdata_query_set_author">
        <doc xml:space="preserve">Sets the #GDataQuery:author property of the #GDataQuery to the new author string, @author.

Set @author to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="author"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new author string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_categories" c:identifier="gdata_query_set_categories">
        <doc xml:space="preserve">Sets the #GDataQuery:categories property of the #GDataQuery to the new category string, @categories.

Set @categories to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="categories"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new category string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_etag"
              c:identifier="gdata_query_set_etag"
              version="0.2.0">
        <doc xml:space="preserve">Sets the #GDataQuery:etag property of the #GDataQuery to the new ETag, @etag.

Set @etag to %NULL to not check against the server-side ETag.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="etag"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new ETag, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_strict"
              c:identifier="gdata_query_set_is_strict"
              version="0.2.0">
        <doc xml:space="preserve">Sets the #GDataQuery:is-strict property of the #GDataQuery to the new strict value, @is_strict.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="is_strict" transfer-ownership="none">
            <doc xml:space="preserve">the new strict value</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_max_results"
              c:identifier="gdata_query_set_max_results">
        <doc xml:space="preserve">Sets the #GDataQuery:max-results property of the #GDataQuery to the new maximum results value, @max_results.

Set @max_results to &lt;code class="literal"&gt;0&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="max_results" transfer-ownership="none">
            <doc xml:space="preserve">the new maximum results value, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_published_max"
              c:identifier="gdata_query_set_published_max">
        <doc xml:space="preserve">Sets the #GDataQuery:published-max property of the #GDataQuery to the new maximum publish time, @published_max.

Set @published_max to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="published_max" transfer-ownership="none">
            <doc xml:space="preserve">the new maximum publish time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_published_min"
              c:identifier="gdata_query_set_published_min">
        <doc xml:space="preserve">Sets the #GDataQuery:published-min property of the #GDataQuery to the new minimum publish time, @published_min.

Set @published_min to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="published_min" transfer-ownership="none">
            <doc xml:space="preserve">the new minimum publish time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_q" c:identifier="gdata_query_set_q">
        <doc xml:space="preserve">Sets the #GDataQuery:q property of the #GDataQuery to the new query string, @q.

Set @q to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_start_index"
              c:identifier="gdata_query_set_start_index">
        <doc xml:space="preserve">Sets the #GDataQuery:start-index property of the #GDataQuery to the new one-based start index, @start_index.

Set @start_index to &lt;code class="literal"&gt;0&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="start_index" transfer-ownership="none">
            <doc xml:space="preserve">the new start index, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_updated_max"
              c:identifier="gdata_query_set_updated_max">
        <doc xml:space="preserve">Sets the #GDataQuery:updated-max property of the #GDataQuery to the new maximum update time, @updated_max.

Set @updated_max to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="updated_max" transfer-ownership="none">
            <doc xml:space="preserve">the new maximum update time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_updated_min"
              c:identifier="gdata_query_set_updated_min">
        <doc xml:space="preserve">Sets the #GDataQuery:updated-min property of the #GDataQuery to the new minimum update time, @updated_min.

Set @updated_min to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataQuery</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </instance-parameter>
          <parameter name="updated_min" transfer-ownership="none">
            <doc xml:space="preserve">the new minimum update time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <property name="author" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">An entry author. The service returns entries where the author name and/or e-mail address match your query string.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="categories" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">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: &lt;userinput&gt;Fritz/Laurie&lt;/userinput&gt; returns
entries that match both categories ("Fritz" and "Laurie").

To do an OR between terms, use a pipe character (&lt;literal&gt;|&lt;/literal&gt;). For example: &lt;userinput&gt;Fritz\%7CLaurie&lt;/userinput&gt; returns
entries that match either category.

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 &lt;userinput&gt;-categoryname&lt;/userinput&gt;.

To query for a category that has a scheme – such as &lt;literal&gt;&amp;lt;category scheme="urn:google.com" term="public"/&amp;gt;&lt;/literal&gt; – you must
place the scheme in curly braces before the category name. For example: &lt;userinput&gt;{urn:google.com}public&lt;/userinput&gt;. To match a category
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.

The above features can be combined. For example: &lt;userinput&gt;A|-{urn:google.com}B/-C&lt;/userinput&gt; means (A OR (NOT B)) AND (NOT C).</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="etag"
                version="0.2.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">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.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="is-strict"
                version="0.2.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Strict query parameter checking. If this is enabled, an error will be returned by the online service if a parameter is
not recognised.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="max-results" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">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 &lt;code class="literal"&gt;0&lt;/code&gt; to not specify a maximum number of results.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="published-max" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">Upper bound on the entry publish date, exclusive.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="published-min" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">Lower bound on the entry publish date, inclusive.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="q" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">A full-text query string.

When creating a query, list search terms separated by spaces, in the form &lt;userinput&gt;term1 term2 term3&lt;/userinput&gt;.
(As with all of the query parameter values, the spaces must be URL encoded.) The service returns all entries that match all of the
search terms (like using AND between terms). Like Google's web search, a service searches on complete words (and related words with
the same stem), not substrings.

To search for an exact phrase, enclose the phrase in quotation marks: &lt;userinput&gt;"exact phrase"&lt;/userinput&gt;.

To exclude entries that match a given term, use the form &lt;userinput&gt;-term&lt;/userinput&gt;.

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: &lt;userinput&gt;"Elizabeth Bennet" Darcy -Austen&lt;/userinput&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="start-index" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">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 &lt;code class="literal"&gt;0&lt;/code&gt; to not specify a start index.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="updated-max" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">Upper bound on the entry update date, exclusive.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="updated-min" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">Lower bound on the entry update date, inclusive.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <field name="parent">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="priv">
        <type name="QueryPrivate" c:type="GDataQueryPrivate*"/>
      </field>
    </class>
    <record name="QueryClass"
            c:type="GDataQueryClass"
            glib:is-gtype-struct-for="Query">
      <doc xml:space="preserve">All the fields in the #GDataQueryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
      <field name="get_query_uri">
        <callback name="get_query_uri">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <type name="Query" c:type="GDataQuery*"/>
            </parameter>
            <parameter name="feed_uri" transfer-ownership="none">
              <type name="utf8" c:type="const gchar*"/>
            </parameter>
            <parameter name="query_uri" transfer-ownership="none">
              <type name="GLib.String" c:type="GString*"/>
            </parameter>
            <parameter name="params_started" transfer-ownership="none">
              <type name="gboolean" c:type="gboolean*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="QueryPrivate" c:type="GDataQueryPrivate" disguised="1">
    </record>
    <callback name="QueryProgressCallback" c:type="GDataQueryProgressCallback">
      <doc xml:space="preserve">Callback function called for each #GDataEntry parsed in a #GDataFeed when loading the results of a query.

It is called in the main thread, so there is no guarantee on the order in which the callbacks are executed,
or whether they will be called in a timely manner. It is, however, guaranteed that they will all be called before
the #GAsyncReadyCallback which signals the completion of the query is called.</doc>
      <return-value transfer-ownership="none">
        <type name="none" c:type="void"/>
      </return-value>
      <parameters>
        <parameter name="entry" transfer-ownership="none">
          <doc xml:space="preserve">a new #GDataEntry</doc>
          <type name="Entry" c:type="GDataEntry*"/>
        </parameter>
        <parameter name="entry_key" transfer-ownership="none">
          <doc xml:space="preserve">the key of the entry (zero-based index of its position in the feed)</doc>
          <type name="guint" c:type="guint"/>
        </parameter>
        <parameter name="entry_count" transfer-ownership="none">
          <doc xml:space="preserve">the total number of entries in the feed</doc>
          <type name="guint" c:type="guint"/>
        </parameter>
        <parameter name="user_data" transfer-ownership="none" closure="3">
          <doc xml:space="preserve">user data passed to the callback</doc>
          <type name="gpointer" c:type="gpointer"/>
        </parameter>
      </parameters>
    </callback>
    <class name="Service"
           c:symbol-prefix="service"
           c:type="GDataService"
           parent="GObject.Object"
           glib:type-name="GDataService"
           glib:get-type="gdata_service_get_type"
           glib:type-struct="ServiceClass">
      <doc xml:space="preserve">All the fields in the #GDataService structure are private and should never be accessed directly.</doc>
      <function name="get_authorization_domains"
                c:identifier="gdata_service_get_authorization_domains"
                version="0.9.0">
        <doc xml:space="preserve">Retrieves the full list of #GDataAuthorizationDomain&lt;!-- --&gt;s which relate to the specified @service_type. All the
#GDataAuthorizationDomain&lt;!-- --&gt;s are unique and interned, so can be compared with other domains by simple pointer comparison.

Note that in addition to this method, #GDataService subclasses may expose some or all of their authorization domains individually by means of
individual accessor functions.</doc>
        <return-value transfer-ownership="container">
          <doc xml:space="preserve">an unordered list of #GDataAuthorizationDomain&lt;!-- --&gt;s; free with
g_list_free()</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="AuthorizationDomain"/>
          </type>
        </return-value>
        <parameters>
          <parameter name="service_type" transfer-ownership="none">
            <doc xml:space="preserve">the #GType of the #GDataService subclass to retrieve the authorization domains for</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
        </parameters>
      </function>
      <virtual-method name="append_query_headers">
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="domain" transfer-ownership="none">
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="message" transfer-ownership="none">
            <type name="Soup.Message" c:type="SoupMessage*"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="parse_error_response" throws="1">
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="operation_type" transfer-ownership="none">
            <type name="OperationType" c:type="GDataOperationType"/>
          </parameter>
          <parameter name="status" transfer-ownership="none">
            <type name="guint" c:type="guint"/>
          </parameter>
          <parameter name="reason_phrase" transfer-ownership="none">
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="response_body" transfer-ownership="none">
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="length" transfer-ownership="none">
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </virtual-method>
      <virtual-method name="parse_feed" introspectable="0" throws="1">
        <return-value>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="domain" transfer-ownership="none">
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="query" transfer-ownership="none">
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="entry_type" transfer-ownership="none">
            <type name="GType" c:type="GType"/>
          </parameter>
          <parameter name="message" transfer-ownership="none">
            <type name="Soup.Message" c:type="SoupMessage*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     closure="6">
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </virtual-method>
      <method name="delete_entry"
              c:identifier="gdata_service_delete_entry"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Deletes @entry from the server. For more information about the concept of deleting entries, see the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/basics.html#DeletingEntry"&gt;online documentation&lt;/ulink&gt; for the GData
protocol.

If @cancellable is not %NULL, then the operation can be cancelled by triggering the @cancellable object from another thread.
If the operation was cancelled before or during network activity, the error %G_IO_ERROR_CANCELLED will be returned. Cancellation has no effect
after network activity has finished, however, and the deletion will return successfully (or return an error sent by the server) if it is first
cancelled after network activity has finished. See the &lt;link linkend="cancellable-support"&gt;overview of cancellation&lt;/link&gt; for
more details.

If there is an error deleting the entry, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned. Currently, subclasses
&lt;emphasis&gt;cannot&lt;/emphasis&gt; cannot override this or provide more specific errors.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain the deletion falls under, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataEntry to delete</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="delete_entry_async"
              c:identifier="gdata_service_delete_entry_async"
              version="0.9.0">
        <doc xml:space="preserve">Deletes @entry from the server. @self and @entry are both reffed when this function is called,
so can safely be unreffed after this function returns.

For more details, see gdata_service_delete_entry(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_service_delete_entry_finish()
to get the results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain the deletion falls under, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataEntry to delete</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="4">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when deletion is finished, or %NULL</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="delete_entry_finish"
              c:identifier="gdata_service_delete_entry_finish"
              version="0.3.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous entry deletion operation started with gdata_service_delete_entry_async().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_authorizer"
              c:identifier="gdata_service_get_authorizer"
              version="0.9.0">
        <doc xml:space="preserve">Gets the #GDataAuthorizer object currently in use by the service. See the documentation for #GDataService:authorizer for more details.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the authorizer object for this service, or %NULL</doc>
          <type name="Authorizer" c:type="GDataAuthorizer*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_locale"
              c:identifier="gdata_service_get_locale"
              version="0.7.0">
        <doc xml:space="preserve">Returns the locale currently being used for network requests, or %NULL if the locale is the default.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the current locale</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_proxy_resolver"
              c:identifier="gdata_service_get_proxy_resolver"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GProxyResolver on the #GDataService's #SoupSession.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GProxyResolver, or %NULL</doc>
          <type name="Gio.ProxyResolver" c:type="GProxyResolver*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_proxy_uri"
              c:identifier="gdata_service_get_proxy_uri"
              version="0.2.0"
              deprecated="1"
              deprecated-version="0.15.0">
        <doc xml:space="preserve">Gets the proxy URI on the #GDataService's #SoupSession.</doc>
        <doc-deprecated xml:space="preserve">Use gdata_service_get_proxy_resolver() instead, which gives more flexibility over the proxy used.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the proxy URI, or %NULL</doc>
          <type name="Soup.URI" c:type="SoupURI*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_timeout"
              c:identifier="gdata_service_get_timeout"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataService:timeout property; the network timeout, in seconds.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the timeout, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="insert_entry"
              c:identifier="gdata_service_insert_entry"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Inserts @entry by uploading it to the online service at @upload_uri. For more information about the concept of inserting entries, see
the &lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/basics.html#InsertingEntry"&gt;online documentation&lt;/ulink&gt; for the GData
protocol.

The service will return an updated version of the entry, which is the return value of this function on success.

If @cancellable is not %NULL, then the operation can be cancelled by triggering the @cancellable object from another thread.
If the operation was cancelled before or during network activity, the error %G_IO_ERROR_CANCELLED will be returned. Cancellation has no effect
after network activity has finished, however, and the insertion will return successfully (or return an error sent by the server) if it is first
cancelled after network activity has finished. See the &lt;link linkend="cancellable-support"&gt;overview of cancellation&lt;/link&gt; for
more details.

If the entry is marked as already having been inserted a %GDATA_SERVICE_ERROR_ENTRY_ALREADY_INSERTED error will be returned immediately
(there will be no network requests).

If there is an error inserting the entry, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned. Currently, subclasses
&lt;emphasis&gt;cannot&lt;/emphasis&gt; cannot override this or provide more specific errors.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataEntry, or %NULL; unref with g_object_unref()</doc>
          <type name="Entry" c:type="GDataEntry*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain the insertion operation falls under, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="upload_uri" transfer-ownership="none">
            <doc xml:space="preserve">the URI to which the upload should be sent</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataEntry to insert</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_entry_async"
              c:identifier="gdata_service_insert_entry_async"
              version="0.9.0">
        <doc xml:space="preserve">Inserts @entry by uploading it to the online service at @upload_uri. @self, @upload_uri and
@entry are all reffed/copied when this function is called, so can safely be freed after this function returns.

For more details, see gdata_service_insert_entry(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_service_insert_entry_finish()
to get the results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain the insertion operation falls under, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="upload_uri" transfer-ownership="none">
            <doc xml:space="preserve">the URI to which the upload should be sent</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataEntry to insert</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="5">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when insertion is finished, or %NULL</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_entry_finish"
              c:identifier="gdata_service_insert_entry_finish"
              version="0.3.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous entry insertion operation started with gdata_service_insert_entry_async().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataEntry, or %NULL; unref with g_object_unref()</doc>
          <type name="Entry" c:type="GDataEntry*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="is_authorized"
              c:identifier="gdata_service_is_authorized"
              version="0.9.0">
        <doc xml:space="preserve">Determines whether the service is authorized for all the #GDataAuthorizationDomain&lt;!-- --&gt;s it belongs to (as returned by
gdata_service_get_authorization_domains()). If the service's #GDataService:authorizer is %NULL, %FALSE is always returned.

This is basically a convenience method for checking that the service's #GDataAuthorizer is authorized for all the service's
#GDataAuthorizationDomain&lt;!-- --&gt;s.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the service is authorized for all its domains, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="query"
              c:identifier="gdata_service_query"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Queries the service's @feed_uri feed to build a #GDataFeed.

If @cancellable is not %NULL, then the operation can be cancelled by triggering the @cancellable object from another thread.
If the operation was cancelled before or during network activity, the error %G_IO_ERROR_CANCELLED will be returned. Cancellation has no effect
after network activity has finished, however, and the query will return successfully (or return an error sent by the server) if it is first
cancelled after network activity has finished. See the &lt;link linkend="cancellable-support"&gt;overview of cancellation&lt;/link&gt; for
more details.

A %GDATA_SERVICE_ERROR_PROTOCOL_ERROR will be returned if the server indicates there is a problem with the query, but subclasses may override
this and return their own errors. See their documentation for more details.

For each entry in the response feed, @progress_callback will be called in the main thread. If there was an error parsing the XML response,
a #GDataParserError will be returned.

If the query is successful and the feed supports pagination, @query will be updated with the pagination URIs, and the next or previous page
can then be loaded by calling gdata_query_next_page() or gdata_query_previous_page() before running the query again.

If the #GDataQuery's ETag is set and it finds a match on the server, %NULL will be returned, but @error will remain unset. Otherwise,
@query's ETag will be updated with the ETag from the returned feed, if available.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results, or %NULL; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain the query falls under, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="feed_uri" transfer-ownership="none">
            <doc xml:space="preserve">the feed URI to query, including the host name and protocol</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="entry_type" transfer-ownership="none">
            <doc xml:space="preserve">a #GType for the #GDataEntry&lt;!-- --&gt;s to build from the XML</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="6">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_async"
              c:identifier="gdata_service_query_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the service's @feed_uri feed to build a #GDataFeed. @self, @feed_uri and
@query are all reffed/copied when this function is called, so can safely be freed after this function returns.

For more details, see gdata_service_query(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_service_query_finish()
to get the results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain the query falls under, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="feed_uri" transfer-ownership="none">
            <doc xml:space="preserve">the feed URI to query, including the host name and protocol</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="entry_type" transfer-ownership="none">
            <doc xml:space="preserve">a #GType for the #GDataEntry&lt;!-- --&gt;s to build from the XML</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="6"
                     destroy="7">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="9">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the query is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_finish"
              c:identifier="gdata_service_query_finish"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous query operation started with gdata_service_query_async().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results, or %NULL; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_single_entry"
              c:identifier="gdata_service_query_single_entry"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Retrieves information about the single entry with the given @entry_id. @entry_id should be as returned by
gdata_entry_get_id().

Parameters and errors are as for gdata_service_query(). Most of the properties of @query aren't relevant, and
will cause a server-side error if used. The most useful property to use is #GDataQuery:etag, which will cause the
server to not return anything if the entry hasn't been modified since it was given the specified ETag; thus saving
bandwidth. If the server does not return anything for this reason, gdata_service_query_single_entry() will return
%NULL, but will not set an error in @error.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataEntry, or %NULL; unref with g_object_unref()</doc>
          <type name="Entry" c:type="GDataEntry*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain the query falls under, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="entry_id" transfer-ownership="none">
            <doc xml:space="preserve">the entry ID of the desired entry</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="entry_type" transfer-ownership="none">
            <doc xml:space="preserve">a #GType for the #GDataEntry to build from the XML</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_single_entry_async"
              c:identifier="gdata_service_query_single_entry_async"
              version="0.9.0">
        <doc xml:space="preserve">Retrieves information about the single entry with the given @entry_id. @entry_id should be as returned by
gdata_entry_get_id(). @self, @query and @entry_id are reffed/copied when this
function is called, so can safely be freed after this function returns.

For more details, see gdata_service_query_single_entry(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_service_query_single_entry_finish()
to get the results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain the query falls under, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="entry_id" transfer-ownership="none">
            <doc xml:space="preserve">the entry ID of the desired entry</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="entry_type" transfer-ownership="none">
            <doc xml:space="preserve">a #GType for the #GDataEntry to build from the XML</doc>
            <type name="GType" c:type="GType"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="6">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the query is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_single_entry_finish"
              c:identifier="gdata_service_query_single_entry_finish"
              version="0.7.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous query operation for a single entry, as started with gdata_service_query_single_entry_async().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataEntry, or %NULL; unref with g_object_unref()</doc>
          <type name="Entry" c:type="GDataEntry*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_authorizer"
              c:identifier="gdata_service_set_authorizer"
              version="0.9.0">
        <doc xml:space="preserve">Sets #GDataService:authorizer to @authorizer. This may be %NULL if the service will only make requests in future which don't require authorization.
See the documentation for #GDataService:authorizer for more information.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="authorizer" transfer-ownership="none">
            <doc xml:space="preserve">a new authorizer object for the service, or %NULL</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_locale"
              c:identifier="gdata_service_set_locale"
              version="0.7.0">
        <doc xml:space="preserve">Set the locale used for network requests to @locale, given in standard Unix locale format. See #GDataService:locale for more details.

Note that while it's possible to change the locale after sending network requests, it is unsupported, as the server-side software may behave
unexpectedly. The only supported use of this function is after creation of a service, but before any network requests are made.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="locale"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the new locale in Unix locale format, or %NULL for the default locale</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_proxy_resolver"
              c:identifier="gdata_service_set_proxy_resolver"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GProxyResolver on the #SoupSession used internally by the given #GDataService.

Setting this will clear the #GDataService:proxy-uri property.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="proxy_resolver"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GProxyResolver, or %NULL</doc>
            <type name="Gio.ProxyResolver" c:type="GProxyResolver*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_proxy_uri"
              c:identifier="gdata_service_set_proxy_uri"
              version="0.2.0"
              deprecated="1"
              deprecated-version="0.15.0">
        <doc xml:space="preserve">Sets the proxy URI on the #SoupSession used internally by the given #GDataService.
This forces all requests through the given proxy.

If @proxy_uri is %NULL, no proxy will be used.

Note that if a #GDataAuthorizer is being used with this #GDataService, the authorizer might also need its proxy URI setting.</doc>
        <doc-deprecated xml:space="preserve">Use gdata_service_set_proxy_resolver() instead, which gives more flexibility over the proxy used.</doc-deprecated>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="proxy_uri"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the proxy URI, or %NULL</doc>
            <type name="Soup.URI" c:type="SoupURI*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_timeout"
              c:identifier="gdata_service_set_timeout"
              version="0.7.0">
        <doc xml:space="preserve">Sets the #GDataService:timeout property; the network timeout, in seconds.

If @timeout is &lt;code class="literal"&gt;0&lt;/code&gt;, network operations will never time out.

Note that if a #GDataAuthorizer is being used with this #GDataService, the authorizer might also need its timeout setting.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="timeout" transfer-ownership="none">
            <doc xml:space="preserve">the timeout, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="guint" c:type="guint"/>
          </parameter>
        </parameters>
      </method>
      <method name="update_entry"
              c:identifier="gdata_service_update_entry"
              version="0.9.0"
              throws="1">
        <doc xml:space="preserve">Updates @entry by PUTting it to its &lt;literal&gt;edit&lt;/literal&gt; link's URI. For more information about the concept of updating entries, see
the &lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/2.0/basics.html#UpdatingEntry"&gt;online documentation&lt;/ulink&gt; for the GData
protocol.

The service will return an updated version of the entry, which is the return value of this function on success.

If @cancellable is not %NULL, then the operation can be cancelled by triggering the @cancellable object from another thread.
If the operation was cancelled before or during network activity, the error %G_IO_ERROR_CANCELLED will be returned. Cancellation has no effect
after network activity has finished, however, and the update will return successfully (or return an error sent by the server) if it is first
cancelled after network activity has finished. See the &lt;link linkend="cancellable-support"&gt;overview of cancellation&lt;/link&gt; for
more details.

If there is an error updating the entry, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned. Currently, subclasses
&lt;emphasis&gt;cannot&lt;/emphasis&gt; cannot override this or provide more specific errors.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataEntry, or %NULL; unref with g_object_unref()</doc>
          <type name="Entry" c:type="GDataEntry*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain the update operation falls under, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataEntry to update</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="update_entry_async"
              c:identifier="gdata_service_update_entry_async"
              version="0.9.0">
        <doc xml:space="preserve">Updates @entry by PUTting it to its &lt;literal&gt;edit&lt;/literal&gt; link's URI. @self and
@entry are both reffed when this function is called, so can safely be unreffed after this function returns.

For more details, see gdata_service_update_entry(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_service_update_entry_finish()
to get the results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain the update operation falls under, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="entry" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataEntry to update</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="4">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the update is finished, or %NULL</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="update_entry_finish"
              c:identifier="gdata_service_update_entry_finish"
              version="0.3.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous entry update operation started with gdata_service_update_entry_async().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataEntry, or %NULL; unref with g_object_unref()</doc>
          <type name="Entry" c:type="GDataEntry*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <property name="authorizer"
                version="0.9.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An object which implements #GDataAuthorizer. This should have previously been authenticated authorized against this service type (and
potentially other service types). The service will use the authorizer to add an authorization token to each request it performs.

Your application should call methods on the #GDataAuthorizer object itself in order to authenticate with the Google accounts service and
authorize against this service type. See the documentation for the particular #GDataAuthorizer implementation being used for more details.

The authorizer for a service can be changed at runtime for a different #GDataAuthorizer object or %NULL without affecting ongoing requests
and operations.

Note that it's only necessary to set an authorizer on the service if your application is going to make requests of the service which
require authorization. For example, listing the current most popular videos on YouTube does not require authorization, but uploading a
video to YouTube does. It's an unnecessary overhead to require the user to authorize against a service when not strictly required.</doc>
        <type name="Authorizer"/>
      </property>
      <property name="locale"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The locale to use for network requests, in Unix locale format. (e.g. "en_GB", "cs", "de_DE".) Use %NULL for the default "C" locale
(typically "en_US").

Typically, this locale will be used by the server-side software to localise results, such as by translating category names, or by choosing
geographically relevant search results. This will vary from service to service.

The server-side behaviour is undefined if it doesn't support a given locale.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="proxy-resolver"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The #GProxyResolver used to determine a proxy URI.  Setting this will clear the #GDataService:proxy-uri property.</doc>
        <type name="Gio.ProxyResolver"/>
      </property>
      <property name="proxy-uri"
                version="0.2.0"
                deprecated="1"
                deprecated-version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The proxy URI used internally for all network requests.

Note that if a #GDataAuthorizer is being used with this #GDataService, the authorizer might also need its proxy URI setting.</doc>
        <doc-deprecated xml:space="preserve">Use #GDataService:proxy-resolver instead, which gives more flexibility over the proxy used.</doc-deprecated>
        <type name="Soup.URI"/>
      </property>
      <property name="timeout"
                version="0.7.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A timeout, in seconds, for network operations. If the timeout is exceeded, the operation will be cancelled and
%GDATA_SERVICE_ERROR_NETWORK_ERROR will be returned.

If the timeout is &lt;code class="literal"&gt;0&lt;/code&gt;, operations will never time out.

Note that if a #GDataAuthorizer is being used with this #GDataService, the authorizer might also need its timeout setting.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <field name="parent">
        <type name="GObject.Object" c:type="GObject"/>
      </field>
      <field name="priv">
        <type name="ServicePrivate" c:type="GDataServicePrivate*"/>
      </field>
    </class>
    <record name="ServiceClass"
            c:type="GDataServiceClass"
            glib:is-gtype-struct-for="Service"
            version="0.9.0">
      <doc xml:space="preserve">The class structure for the #GDataService type.</doc>
      <field name="parent">
        <doc xml:space="preserve">the parent class</doc>
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
      <field name="api_version">
        <doc xml:space="preserve">the version of the GData API used by the service (typically &lt;code class="literal"&gt;2&lt;/code&gt;)</doc>
        <type name="utf8" c:type="const gchar*"/>
      </field>
      <field name="feed_type">
        <doc xml:space="preserve">the #GType of the feed class (subclass of #GDataFeed) to use for query results from this service</doc>
        <type name="GType" c:type="GType"/>
      </field>
      <field name="append_query_headers">
        <callback name="append_query_headers">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <type name="Service" c:type="GDataService*"/>
            </parameter>
            <parameter name="domain" transfer-ownership="none">
              <type name="AuthorizationDomain"
                    c:type="GDataAuthorizationDomain*"/>
            </parameter>
            <parameter name="message" transfer-ownership="none">
              <type name="Soup.Message" c:type="SoupMessage*"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="parse_error_response">
        <callback name="parse_error_response" throws="1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <type name="Service" c:type="GDataService*"/>
            </parameter>
            <parameter name="operation_type" transfer-ownership="none">
              <type name="OperationType" c:type="GDataOperationType"/>
            </parameter>
            <parameter name="status" transfer-ownership="none">
              <type name="guint" c:type="guint"/>
            </parameter>
            <parameter name="reason_phrase" transfer-ownership="none">
              <type name="utf8" c:type="const gchar*"/>
            </parameter>
            <parameter name="response_body" transfer-ownership="none">
              <type name="utf8" c:type="const gchar*"/>
            </parameter>
            <parameter name="length" transfer-ownership="none">
              <type name="gint" c:type="gint"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="get_authorization_domains" introspectable="0">
        <callback name="get_authorization_domains" introspectable="0">
          <return-value>
            <type name="GLib.List" c:type="GList*">
              <type name="gpointer" c:type="gpointer"/>
            </type>
          </return-value>
        </callback>
      </field>
      <field name="parse_feed" introspectable="0">
        <callback name="parse_feed" introspectable="0" throws="1">
          <return-value>
            <type name="Feed" c:type="GDataFeed*"/>
          </return-value>
          <parameters>
            <parameter name="self" transfer-ownership="none">
              <type name="Service" c:type="GDataService*"/>
            </parameter>
            <parameter name="domain" transfer-ownership="none">
              <type name="AuthorizationDomain"
                    c:type="GDataAuthorizationDomain*"/>
            </parameter>
            <parameter name="query" transfer-ownership="none">
              <type name="Query" c:type="GDataQuery*"/>
            </parameter>
            <parameter name="entry_type" transfer-ownership="none">
              <type name="GType" c:type="GType"/>
            </parameter>
            <parameter name="message" transfer-ownership="none">
              <type name="Soup.Message" c:type="SoupMessage*"/>
            </parameter>
            <parameter name="cancellable"
                       transfer-ownership="none"
                       nullable="1"
                       allow-none="1">
              <type name="Gio.Cancellable" c:type="GCancellable*"/>
            </parameter>
            <parameter name="progress_callback"
                       transfer-ownership="none"
                       closure="7">
              <type name="QueryProgressCallback"
                    c:type="GDataQueryProgressCallback"/>
            </parameter>
            <parameter name="progress_user_data" transfer-ownership="none">
              <type name="gpointer" c:type="gpointer"/>
            </parameter>
          </parameters>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved6" introspectable="0">
        <callback name="_g_reserved6">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved7" introspectable="0">
        <callback name="_g_reserved7">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <enumeration name="ServiceError"
                 glib:type-name="GDataServiceError"
                 glib:get-type="gdata_service_error_get_type"
                 c:type="GDataServiceError"
                 glib:error-domain="gdata-service-error-quark">
      <doc xml:space="preserve">Error codes for #GDataService operations.</doc>
      <member name="unavailable"
              value="1"
              c:identifier="GDATA_SERVICE_ERROR_UNAVAILABLE"
              glib:nick="unavailable">
        <doc xml:space="preserve">The service is unavailable due to maintainence or other reasons (e.g. network errors at the server end)</doc>
      </member>
      <member name="protocol_error"
              value="2"
              c:identifier="GDATA_SERVICE_ERROR_PROTOCOL_ERROR"
              glib:nick="protocol-error">
        <doc xml:space="preserve">The client or server unexpectedly strayed from the protocol (fatal error)</doc>
      </member>
      <member name="entry_already_inserted"
              value="3"
              c:identifier="GDATA_SERVICE_ERROR_ENTRY_ALREADY_INSERTED"
              glib:nick="entry-already-inserted">
        <doc xml:space="preserve">An entry has already been inserted, and cannot be re-inserted</doc>
      </member>
      <member name="authentication_required"
              value="4"
              c:identifier="GDATA_SERVICE_ERROR_AUTHENTICATION_REQUIRED"
              glib:nick="authentication-required">
        <doc xml:space="preserve">The user attempted to do something which required authentication, and they weren't authenticated or
didn't have authorization for the operation</doc>
      </member>
      <member name="not_found"
              value="5"
              c:identifier="GDATA_SERVICE_ERROR_NOT_FOUND"
              glib:nick="not-found">
        <doc xml:space="preserve">A requested resource (feed or entry) was not found on the server</doc>
      </member>
      <member name="conflict"
              value="6"
              c:identifier="GDATA_SERVICE_ERROR_CONFLICT"
              glib:nick="conflict">
        <doc xml:space="preserve">There was a conflict when updating an entry on the server; the server-side copy was modified inbetween downloading
and uploading the modified entry</doc>
      </member>
      <member name="forbidden"
              value="7"
              c:identifier="GDATA_SERVICE_ERROR_FORBIDDEN"
              glib:nick="forbidden">
        <doc xml:space="preserve">Generic error for a forbidden action (not due to having insufficient permissions)</doc>
      </member>
      <member name="bad_query_parameter"
              value="8"
              c:identifier="GDATA_SERVICE_ERROR_BAD_QUERY_PARAMETER"
              glib:nick="bad-query-parameter">
        <doc xml:space="preserve">A given query parameter was invalid for the query type</doc>
      </member>
      <member name="network_error"
              value="9"
              c:identifier="GDATA_SERVICE_ERROR_NETWORK_ERROR"
              glib:nick="network-error">
        <doc xml:space="preserve">The service is unavailable due to local network errors (e.g. no Internet connection)</doc>
      </member>
      <member name="proxy_error"
              value="10"
              c:identifier="GDATA_SERVICE_ERROR_PROXY_ERROR"
              glib:nick="proxy-error">
        <doc xml:space="preserve">The service is unavailable due to proxy network errors (e.g. proxy unreachable)</doc>
      </member>
      <member name="with_batch_operation"
              value="11"
              c:identifier="GDATA_SERVICE_ERROR_WITH_BATCH_OPERATION"
              glib:nick="with-batch-operation">
        <doc xml:space="preserve">Generic error when running a batch operation and the whole operation fails</doc>
      </member>
      <member name="api_quota_exceeded"
              value="12"
              c:identifier="GDATA_SERVICE_ERROR_API_QUOTA_EXCEEDED"
              glib:nick="api-quota-exceeded">
        <doc xml:space="preserve">The API request quota for this
developer account has been exceeded for the current time period (e.g. day).
Try again later. (Since: 0.16.0.)</doc>
      </member>
      <function name="quark" c:identifier="gdata_service_error_quark">
        <return-value transfer-ownership="none">
          <type name="GLib.Quark" c:type="GQuark"/>
        </return-value>
      </function>
    </enumeration>
    <record name="ServicePrivate" c:type="GDataServicePrivate" disguised="1">
    </record>
    <constant name="TASKS_STATUS_COMPLETED"
              value="completed"
              c:type="GDATA_TASKS_STATUS_COMPLETED"
              version="0.16.0">
      <doc xml:space="preserve">A value for #GDataTasksTask:status indicating the task has been completed.

Reference:
&lt;ulink type="http" url="https://developers.google.com/google-apps/tasks/v1/reference/tasks#status"&gt;
Google Tasks documentation&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="TASKS_STATUS_NEEDS_ACTION"
              value="needsAction"
              c:type="GDATA_TASKS_STATUS_NEEDS_ACTION"
              version="0.16.0">
      <doc xml:space="preserve">A value for #GDataTasksTask:status indicating the task still needs action
before it is complete.

Reference:
&lt;ulink type="http" url="https://developers.google.com/google-apps/tasks/v1/reference/tasks#status"&gt;
Google Tasks documentation&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <class name="TasksQuery"
           c:symbol-prefix="tasks_query"
           c:type="GDataTasksQuery"
           version="0.15.0"
           parent="Query"
           glib:type-name="GDataTasksQuery"
           glib:get-type="gdata_tasks_query_get_type"
           glib:type-struct="TasksQueryClass">
      <doc xml:space="preserve">All the fields in the #GDataTasksQuery structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_tasks_query_new"
                   version="0.15.0">
        <doc xml:space="preserve">Creates a new #GDataTasksQuery. @q is unused and must be set to %NULL.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataTasksQuery</doc>
          <type name="TasksQuery" c:type="GDataTasksQuery*"/>
        </return-value>
        <parameters>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_completed_max"
              c:identifier="gdata_tasks_query_get_completed_max"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksQuery:completed-max property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the completed-max property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_completed_min"
              c:identifier="gdata_tasks_query_get_completed_min"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksQuery:completed-min property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the completed-min property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_due_max"
              c:identifier="gdata_tasks_query_get_due_max"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksQuery:due-max property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the due-max property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_due_min"
              c:identifier="gdata_tasks_query_get_due_min"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksQuery:due-min property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the due-min property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_show_completed"
              c:identifier="gdata_tasks_query_get_show_completed"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksQuery:show-completed property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the show-completed property</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_show_deleted"
              c:identifier="gdata_tasks_query_get_show_deleted"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksQuery:show-deleted property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the show-deleted property</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_show_hidden"
              c:identifier="gdata_tasks_query_get_show_hidden"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksQuery:show-hidden property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the show-hidden property</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_completed_max"
              c:identifier="gdata_tasks_query_set_completed_max"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GDataTasksQuery:completed-max property of the #GDataTasksQuery
to the new time/date, @completed_max.

Set @completed_max to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
          <parameter name="completed_max" transfer-ownership="none">
            <doc xml:space="preserve">upper bound for a task's completion date by UNIX timestamp, or  &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_completed_min"
              c:identifier="gdata_tasks_query_set_completed_min"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GDataTasksQuery:completed-min property of the #GDataTasksQuery
to the new time/date, @completed_min.

Set @completed_min to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
          <parameter name="completed_min" transfer-ownership="none">
            <doc xml:space="preserve">lower bound for a task's completion date by UNIX timestamp, or  &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_due_max"
              c:identifier="gdata_tasks_query_set_due_max"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GDataTasksQuery:due-max property of the #GDataTasksQuery
to the new time/date, @due_max.

Set @due_max to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
          <parameter name="due_max" transfer-ownership="none">
            <doc xml:space="preserve">upper bound for a task's due date by UNIX timestamp, or  &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_due_min"
              c:identifier="gdata_tasks_query_set_due_min"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GDataTasksQuery:due-min property of the #GDataTasksQuery
to the new time/date, @due_min.

Set @due_min to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
          <parameter name="due_min" transfer-ownership="none">
            <doc xml:space="preserve">lower bound for a task's due date by UNIX timestamp, or  &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_show_completed"
              c:identifier="gdata_tasks_query_set_show_completed"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GDataTasksQuery:show-completed property of the #GDataTasksQuery.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
          <parameter name="show_completed" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE to show completed tasks, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_show_deleted"
              c:identifier="gdata_tasks_query_set_show_deleted"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GDataTasksQuery:show-deleted property of the #GDataTasksQuery.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
          <parameter name="show_deleted" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE to show deleted tasks, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_show_hidden"
              c:identifier="gdata_tasks_query_set_show_hidden"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GDataTasksQuery:show-hidden property of the #GDataTasksQuery.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksQuery</doc>
            <type name="TasksQuery" c:type="GDataTasksQuery*"/>
          </instance-parameter>
          <parameter name="show_hidden" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE to show hidden tasks, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <property name="completed-max"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Upper bound for a task's completion date (as a RFC 3339 timestamp) to filter by. Optional.
The default is not to filter by completion date.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="completed-min"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Lower bound for a task's completion date (as a RFC 3339 timestamp) to filter by. Optional.
The default is not to filter by completion date.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="due-max"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Upper bound for a task's due date (as a RFC 3339 timestamp) to filter by. Optional.
The default is not to filter by completion date.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="due-min"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Lower bound for a task's due date (as a RFC 3339 timestamp) to filter by. Optional.
The default is not to filter by completion date.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="show-completed"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Flag indicating whether completed tasks are returned in the result. Optional. The default is %FALSE.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="show-deleted"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Flag indicating whether deleted tasks are returned in the result. Optional. The default is %FALSE.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="show-hidden"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Flag indicating whether hidden tasks are returned in the result. Optional. The default is %FALSE.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <field name="parent">
        <type name="Query" c:type="GDataQuery"/>
      </field>
      <field name="priv">
        <type name="TasksQueryPrivate" c:type="GDataTasksQueryPrivate*"/>
      </field>
    </class>
    <record name="TasksQueryClass"
            c:type="GDataTasksQueryClass"
            glib:is-gtype-struct-for="TasksQuery"
            version="0.15.0">
      <doc xml:space="preserve">All the fields in the #GDataTasksQueryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="QueryClass" c:type="GDataQueryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="TasksQueryPrivate"
            c:type="GDataTasksQueryPrivate"
            disguised="1">
    </record>
    <class name="TasksService"
           c:symbol-prefix="tasks_service"
           c:type="GDataTasksService"
           version="0.15.0"
           parent="Service"
           glib:type-name="GDataTasksService"
           glib:get-type="gdata_tasks_service_get_type"
           glib:type-struct="TasksServiceClass">
      <doc xml:space="preserve">All the fields in the #GDataTasksService structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_tasks_service_new"
                   version="0.15.0">
        <doc xml:space="preserve">Creates a new #GDataTasksService using the given #GDataAuthorizer. If @authorizer is %NULL, all requests are made as an unauthenticated user.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataTasksService, or %NULL; unref with g_object_unref()</doc>
          <type name="TasksService" c:type="GDataTasksService*"/>
        </return-value>
        <parameters>
          <parameter name="authorizer"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataAuthorizer to authorize the service's requests, or %NULL</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </parameter>
        </parameters>
      </constructor>
      <function name="get_primary_authorization_domain"
                c:identifier="gdata_tasks_service_get_primary_authorization_domain"
                version="0.15.0">
        <doc xml:space="preserve">The primary #GDataAuthorizationDomain for interacting with Google Tasks. This will not normally need to be used, as it's used internally
by the #GDataTasksService methods. However, if using the plain #GDataService methods to implement custom queries or requests which libgdata
does not support natively, then this domain may be needed to authorize the requests.

The domain never changes, and is interned so that pointer comparison can be used to differentiate it from other authorization domains.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the service's authorization domain</doc>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
      </function>
      <method name="delete_task"
              c:identifier="gdata_tasks_service_delete_task"
              version="0.15.0"
              throws="1">
        <doc xml:space="preserve">Delete @task from online tasks service.

For more details, see gdata_service_delete_entry().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="task" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataTasksTask to delete</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="delete_task_async"
              c:identifier="gdata_tasks_service_delete_task_async"
              version="0.15.0">
        <doc xml:space="preserve">Deletes @task from online tasks service. @self and @task are both reffed when this function is called, so can safely be
unreffed after this function returns.

@callback should call gdata_service_delete_entry_finish() to finish deleting task and to check for possible
errors.

For more details, see gdata_tasks_service_delete_task(), which is the synchronous version of this function, and
gdata_service_delete_entry_async(), which is the base asynchronous insertion function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="task" transfer-ownership="none">
            <doc xml:space="preserve">#GDataTasksTask to delete</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when insertion is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="delete_tasklist"
              c:identifier="gdata_tasks_service_delete_tasklist"
              version="0.15.0"
              throws="1">
        <doc xml:space="preserve">Delete @tasklist from online tasks service.

For more details, see gdata_service_delete_entry().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="tasklist" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataTasksTasklist to delete</doc>
            <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="delete_tasklist_async"
              c:identifier="gdata_tasks_service_delete_tasklist_async"
              version="0.15.0">
        <doc xml:space="preserve">Deletes @tasklist from online tasks service. @self and @tasklist are both reffed when this function is called, so can safely be
unreffed after this function returns.

@callback should call gdata_service_delete_entry_finish() to finish deleting tasklist and to check for possible
errors.

For more details, see gdata_tasks_service_delete_tasklist(), which is the synchronous version of this function, and
gdata_service_delete_entry_async(), which is the base asynchronous insertion function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="tasklist" transfer-ownership="none">
            <doc xml:space="preserve">#GDataTasksTasklist to delete</doc>
            <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when insertion is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_task"
              c:identifier="gdata_tasks_service_insert_task"
              version="0.15.0"
              throws="1">
        <doc xml:space="preserve">Inserts @task by uploading it to the online tasks service into tasklist @tasklist. It is safe to unref @tasklist after function returns.

For more details, see gdata_service_insert_entry().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataTasksTask, or %NULL; unref with g_object_unref()</doc>
          <type name="TasksTask" c:type="GDataTasksTask*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="task" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataTasksTask to insert</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </parameter>
          <parameter name="tasklist" transfer-ownership="none">
            <doc xml:space="preserve">#GDataTasksTasklist to insert into</doc>
            <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_task_async"
              c:identifier="gdata_tasks_service_insert_task_async"
              version="0.15.0">
        <doc xml:space="preserve">Inserts @task by uploading it to the online tasks service into tasklist @tasklist. @self, @task and @tasklist are all reffed when this function is called, so can safely be
unreffed after this function returns.

@callback should call gdata_service_insert_entry_finish() to obtain a #GDataTasksTask representing the inserted task and to check for possible
errors.

For more details, see gdata_tasks_service_insert_task(), which is the synchronous version of this function, and
gdata_service_insert_entry_async(), which is the base asynchronous insertion function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="task" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataTasksTask to insert</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </parameter>
          <parameter name="tasklist" transfer-ownership="none">
            <doc xml:space="preserve">#GDataTasksTasklist to insert into</doc>
            <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="4">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when insertion is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_tasklist"
              c:identifier="gdata_tasks_service_insert_tasklist"
              version="0.15.0"
              throws="1">
        <doc xml:space="preserve">Inserts @tasklist by uploading it to the online tasks service.

For more details, see gdata_service_insert_entry().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataTasksTasklist, or %NULL; unref with g_object_unref()</doc>
          <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="tasklist" transfer-ownership="none">
            <doc xml:space="preserve">#GDataTasksTasklist to insert</doc>
            <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="insert_tasklist_async"
              c:identifier="gdata_tasks_service_insert_tasklist_async"
              version="0.15.0">
        <doc xml:space="preserve">Inserts @tasklist by uploading it to the online tasks service. @self and @tasklist are both reffed when this function is called, so can safely be
unreffed after this function returns.

@callback should call gdata_service_insert_entry_finish() to obtain a #GDataTasksTasklist representing the inserted tasklist and to check for possible
errors.

For more details, see gdata_tasks_service_insert_tasklist(), which is the synchronous version of this function, and
gdata_service_insert_entry_async(), which is the base asynchronous insertion function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="tasklist" transfer-ownership="none">
            <doc xml:space="preserve">#GDataTasksTasklist to insert</doc>
            <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when insertion is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_all_tasklists"
              c:identifier="gdata_tasks_service_query_all_tasklists"
              version="0.15.0"
              throws="1">
        <doc xml:space="preserve">Queries the service to return a list of all tasklists from the authenticated account which match the given
@query. It will return all tasklists the user has read access to.

For more details, see gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_all_tasklists_async"
              c:identifier="gdata_tasks_service_query_all_tasklists_async"
              version="0.15.0">
        <doc xml:space="preserve">Queries the service to return a list of all tasklists from the authenticated account which match the given
@query. @self and @query are all reffed when this function is called, so can safely be unreffed after
this function returns.

For more details, see gdata_tasks_service_query_all_tasklists(), which is the synchronous version of
this function, and gdata_service_query_async(), which is the base asynchronous query function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="3"
                     destroy="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="6">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authentication is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_tasks"
              c:identifier="gdata_tasks_service_query_tasks"
              version="0.15.0"
              throws="1">
        <doc xml:space="preserve">Queries the service to return a list of tasks in the given @tasklist, which match @query.

For more details, see gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="tasklist" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTasklist</doc>
            <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_tasks_async"
              c:identifier="gdata_tasks_service_query_tasks_async"
              version="0.15.0">
        <doc xml:space="preserve">Queries the service to return a list of tasks in the given @tasklist, which match @query. @self, @tasklist and @query are all reffed when this
function is called, so can safely be unreffed after this function returns.

Get the results of the query using gdata_service_query_finish() in the @callback.

For more details, see gdata_tasks_service_query_tasks(), which is the synchronous version of this function, and gdata_service_query_async(),
which is the base asynchronous query function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="tasklist" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTasklist</doc>
            <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="4"
                     destroy="5">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="7">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the query is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="update_task"
              c:identifier="gdata_tasks_service_update_task"
              version="0.15.0"
              throws="1">
        <doc xml:space="preserve">Update @task in online tasks service.

For more details, see gdata_service_update_entry().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataTasksTask, or %NULL; unref with g_object_unref()</doc>
          <type name="TasksTask" c:type="GDataTasksTask*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="task" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataTasksTask to update</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="update_task_async"
              c:identifier="gdata_tasks_service_update_task_async"
              version="0.15.0">
        <doc xml:space="preserve">Updates @task to online tasks service. @self and @task are both reffed when this function is called, so can safely be
unreffed after this function returns.

@callback should call gdata_service_update_entry_finish() to obtain a #GDataTasksTask representing the updated task and to check for possible
errors.

For more details, see gdata_tasks_service_update_task(), which is the synchronous version of this function, and
gdata_service_update_entry_async(), which is the base asynchronous insertion function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="task" transfer-ownership="none">
            <doc xml:space="preserve">#GDataTasksTask to update</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when insertion is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="update_tasklist"
              c:identifier="gdata_tasks_service_update_tasklist"
              version="0.15.0"
              throws="1">
        <doc xml:space="preserve">Update @tasklist in online tasks service.

For more details, see gdata_service_update_entry().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">an updated #GDataTasksTasklist, or %NULL; unref with g_object_unref()</doc>
          <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="tasklist" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataTasksTasklist to update</doc>
            <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="update_tasklist_async"
              c:identifier="gdata_tasks_service_update_tasklist_async"
              version="0.15.0">
        <doc xml:space="preserve">Updates @tasklist from online tasks service. @self and @tasklist are both reffed when this function is called, so can safely be
unreffed after this function returns.

@callback should call gdata_service_update_entry_finish() to obtain a #GDataTasksTasklist representing the updated task and to check for possible
errors.

For more details, see gdata_tasks_service_update_tasklist(), which is the synchronous version of this function, and
gdata_service_update_entry_async(), which is the base asynchronous insertion function.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksService</doc>
            <type name="TasksService" c:type="GDataTasksService*"/>
          </instance-parameter>
          <parameter name="tasklist" transfer-ownership="none">
            <doc xml:space="preserve">#GDataTasksTasklist to update</doc>
            <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="3">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when insertion is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <field name="parent">
        <type name="Service" c:type="GDataService"/>
      </field>
    </class>
    <record name="TasksServiceClass"
            c:type="GDataTasksServiceClass"
            glib:is-gtype-struct-for="TasksService"
            version="0.15.0">
      <doc xml:space="preserve">All the fields in the #GDataTasksServiceClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ServiceClass" c:type="GDataServiceClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <class name="TasksTask"
           c:symbol-prefix="tasks_task"
           c:type="GDataTasksTask"
           version="0.15.0"
           parent="Entry"
           glib:type-name="GDataTasksTask"
           glib:get-type="gdata_tasks_task_get_type"
           glib:type-struct="TasksTaskClass">
      <doc xml:space="preserve">All the fields in the #GDataTasksTask structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_tasks_task_new"
                   version="0.15.0">
        <doc xml:space="preserve">Creates a new #GDataTasksTask with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataTasksTask; unref with g_object_unref()</doc>
          <type name="TasksTask" c:type="GDataTasksTask*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the task's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_completed"
              c:identifier="gdata_tasks_task_get_completed"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksTask:completed property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the completed property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_due"
              c:identifier="gdata_tasks_task_get_due"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksTask:due property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the due property, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_notes"
              c:identifier="gdata_tasks_task_get_notes"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksTask:notes property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">notes of the task, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_parent"
              c:identifier="gdata_tasks_task_get_parent"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksTask:parent property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the parent of the task, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_position"
              c:identifier="gdata_tasks_task_get_position"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksTask:position property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the position of the task, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_status"
              c:identifier="gdata_tasks_task_get_status"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksTask:status property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the status of the task, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_deleted"
              c:identifier="gdata_tasks_task_is_deleted"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksTask:is-deleted property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if task is deleted, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_hidden"
              c:identifier="gdata_tasks_task_is_hidden"
              version="0.15.0">
        <doc xml:space="preserve">Gets the #GDataTasksTask:is-hidden property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if task is hidden, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_completed"
              c:identifier="gdata_tasks_task_set_completed"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GDataTasksTask:completed property of the #GDataTasksTask to the new completion time of the task, @completed.

Set @completed to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the completion time of the task</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
          <parameter name="completed" transfer-ownership="none">
            <doc xml:space="preserve">completion time of the task, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_due"
              c:identifier="gdata_tasks_task_set_due"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GDataTasksTask:due property of the #GDataTasksTask to the new due time of the task, @due.

Set @due to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the property in the due time of the task</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
          <parameter name="due" transfer-ownership="none">
            <doc xml:space="preserve">due time of the task, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_deleted"
              c:identifier="gdata_tasks_task_set_is_deleted"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GDataTasksTask:is-deleted property to @deleted.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
          <parameter name="deleted" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if task is deleted, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_notes"
              c:identifier="gdata_tasks_task_set_notes"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GDataTasksTask:notes property to the new notes, @notes.

Set @notes to %NULL to unset the property in the task.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
          <parameter name="notes"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new notes of the task, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_status"
              c:identifier="gdata_tasks_task_set_status"
              version="0.15.0">
        <doc xml:space="preserve">Sets the #GDataTasksTask:status property to the new status, @status.

Set @status to %NULL to unset the property in the task.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataTasksTask</doc>
            <type name="TasksTask" c:type="GDataTasksTask*"/>
          </instance-parameter>
          <parameter name="status"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new status of the task, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="completed"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Completion date of the task (as a RFC 3339 timestamp; seconds since
the UNIX epoch).

This field is &lt;code class="literal"&gt;-1&lt;/code&gt; if the task has not
been completed.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="due"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Due date of the task (as a RFC 3339 timestamp; seconds since the UNIX
epoch).

This field is &lt;code class="literal"&gt;-1&lt;/code&gt; if the task has no due
date assigned.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="is-deleted"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Flag indicating whether the task has been deleted. The default is %FALSE.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="is-hidden" version="0.15.0" transfer-ownership="none">
        <doc xml:space="preserve">Flag indicating whether the task is hidden. This is the case if the task
had been marked completed when the task list was last cleared.
The default is %FALSE. This field is read-only.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="notes"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">This is where the description of what needs to be done in the task is stored.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="parent" version="0.15.0" transfer-ownership="none">
        <doc xml:space="preserve">Parent task identifier. This field is omitted if it is a top-level task. This field is read-only.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="position" version="0.15.0" transfer-ownership="none">
        <doc xml:space="preserve">String indicating the position of the task among its sibling tasks under the same parent task
or at the top level. If this string is greater than another task's corresponding position string
according to lexicographical ordering, the task is positioned after the other task under the same
parent task (or at the top level). This field is read-only.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="status"
                version="0.15.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Status of the task. This is either %GDATA_TASKS_STATUS_NEEDS_ACTION
or %GDATA_TASKS_STATUS_COMPLETED.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="TasksTaskPrivate" c:type="GDataTasksTaskPrivate*"/>
      </field>
    </class>
    <record name="TasksTaskClass"
            c:type="GDataTasksTaskClass"
            glib:is-gtype-struct-for="TasksTask"
            version="0.15.0">
      <doc xml:space="preserve">All the fields in the #GDataTasksTaskClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="TasksTaskPrivate"
            c:type="GDataTasksTaskPrivate"
            disguised="1">
    </record>
    <class name="TasksTasklist"
           c:symbol-prefix="tasks_tasklist"
           c:type="GDataTasksTasklist"
           version="0.15.0"
           parent="Entry"
           glib:type-name="GDataTasksTasklist"
           glib:get-type="gdata_tasks_tasklist_get_type"
           glib:type-struct="TasksTasklistClass">
      <doc xml:space="preserve">All the fields in the #GDataTasksTasklist structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_tasks_tasklist_new"
                   version="0.15.0">
        <doc xml:space="preserve">Creates a new #GDataTasksTasklist with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataTasksTasklist; unref with g_object_unref()</doc>
          <type name="TasksTasklist" c:type="GDataTasksTasklist*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the tasklist's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
    </class>
    <record name="TasksTasklistClass"
            c:type="GDataTasksTasklistClass"
            glib:is-gtype-struct-for="TasksTasklist"
            version="0.15.0">
      <doc xml:space="preserve">All the fields in the #GDataTasksTasklistClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <class name="UploadStream"
           c:symbol-prefix="upload_stream"
           c:type="GDataUploadStream"
           version="0.5.0"
           parent="Gio.OutputStream"
           glib:type-name="GDataUploadStream"
           glib:get-type="gdata_upload_stream_get_type"
           glib:type-struct="UploadStreamClass">
      <doc xml:space="preserve">All the fields in the #GDataUploadStream structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_upload_stream_new"
                   version="0.9.0">
        <doc xml:space="preserve">Creates a new #GDataUploadStream, allowing a file to be uploaded from a GData service using standard #GOutputStream API.

The HTTP method to use should be specified in @method, and will typically be either %SOUP_METHOD_POST (for insertions) or %SOUP_METHOD_PUT
(for updates), according to the server and the @upload_uri.

If @entry is specified, it will be attached to the upload as the entry to which the file being uploaded belongs. Otherwise, just the file
written to the stream will be uploaded, and given a default entry as determined by the server.

@slug and @content_type must be specified before the upload begins, as they describe the file being streamed. @slug is the filename given to the
file, which will typically be stored on the server and made available when downloading the file again. @content_type must be the correct
content type for the file, and should be in the service's list of acceptable content types.

As well as the standard GIO errors, calls to the #GOutputStream API on a #GDataUploadStream can also return any relevant specific error from
#GDataServiceError, or %GDATA_SERVICE_ERROR_PROTOCOL_ERROR in the general case.

If a #GCancellable is provided in @cancellable, the upload operation may be cancelled at any time from another thread using g_cancellable_cancel().
In this case, any ongoing network activity will be stopped, and any pending or future calls to #GOutputStream API on the #GDataUploadStream will
return %G_IO_ERROR_CANCELLED. Note that the #GCancellable objects which can be passed to individual #GOutputStream operations will not cancel the
upload operation proper if cancelled — they will merely cancel that API call. The only way to cancel the upload operation completely is using this
@cancellable.

Note that network communication won't begin until the first call to g_output_stream_write() on the #GDataUploadStream.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GOutputStream, or %NULL; unref with g_object_unref()</doc>
          <type name="Gio.OutputStream" c:type="GOutputStream*"/>
        </return-value>
        <parameters>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain to authorize the upload, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="method" transfer-ownership="none">
            <doc xml:space="preserve">the HTTP method to use</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="upload_uri" transfer-ownership="none">
            <doc xml:space="preserve">the URI to upload</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="entry"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the entry to upload as metadata, or %NULL</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </parameter>
          <parameter name="slug" transfer-ownership="none">
            <doc xml:space="preserve">the file's slug (filename)</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="content_type" transfer-ownership="none">
            <doc xml:space="preserve">the content type of the file being uploaded</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable for the entire upload stream, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </constructor>
      <constructor name="new_resumable"
                   c:identifier="gdata_upload_stream_new_resumable"
                   version="0.13.0">
        <doc xml:space="preserve">Creates a new resumable #GDataUploadStream, allowing a file to be uploaded from a GData service using standard #GOutputStream API. The upload will
use GData's resumable upload API, so should be more reliable than a normal upload (especially if the file is large). See the
&lt;ulink type="http" url="http://code.google.com/apis/gdata/docs/resumable_upload.html"&gt;GData documentation on resumable uploads&lt;/ulink&gt; for more
information.

The HTTP method to use should be specified in @method, and will typically be either %SOUP_METHOD_POST (for insertions) or %SOUP_METHOD_PUT
(for updates), according to the server and the @upload_uri.

If @entry is specified, it will be attached to the upload as the entry to which the file being uploaded belongs. Otherwise, just the file
written to the stream will be uploaded, and given a default entry as determined by the server.

@slug, @content_type and @content_length must be specified before the upload begins, as they describe the file being streamed. @slug is the filename
given to the file, which will typically be stored on the server and made available when downloading the file again. @content_type must be the
correct content type for the file, and should be in the service's list of acceptable content types. @content_length must be the size of the file
being uploaded (not including the XML for any associated #GDataEntry) in bytes. Zero is accepted if a metadata-only upload is being performed.

As well as the standard GIO errors, calls to the #GOutputStream API on a #GDataUploadStream can also return any relevant specific error from
#GDataServiceError, or %GDATA_SERVICE_ERROR_PROTOCOL_ERROR in the general case.

If a #GCancellable is provided in @cancellable, the upload operation may be cancelled at any time from another thread using g_cancellable_cancel().
In this case, any ongoing network activity will be stopped, and any pending or future calls to #GOutputStream API on the #GDataUploadStream will
return %G_IO_ERROR_CANCELLED. Note that the #GCancellable objects which can be passed to individual #GOutputStream operations will not cancel the
upload operation proper if cancelled — they will merely cancel that API call. The only way to cancel the upload operation completely is using this
@cancellable.

Note that network communication won't begin until the first call to g_output_stream_write() on the #GDataUploadStream.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GOutputStream, or %NULL; unref with g_object_unref()</doc>
          <type name="Gio.OutputStream" c:type="GOutputStream*"/>
        </return-value>
        <parameters>
          <parameter name="service" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="Service" c:type="GDataService*"/>
          </parameter>
          <parameter name="domain"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the #GDataAuthorizationDomain to authorize the upload, or %NULL</doc>
            <type name="AuthorizationDomain"
                  c:type="GDataAuthorizationDomain*"/>
          </parameter>
          <parameter name="method" transfer-ownership="none">
            <doc xml:space="preserve">the HTTP method to use</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="upload_uri" transfer-ownership="none">
            <doc xml:space="preserve">the URI to upload</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="entry"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the entry to upload as metadata, or %NULL</doc>
            <type name="Entry" c:type="GDataEntry*"/>
          </parameter>
          <parameter name="slug" transfer-ownership="none">
            <doc xml:space="preserve">the file's slug (filename)</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="content_type" transfer-ownership="none">
            <doc xml:space="preserve">the content type of the file being uploaded</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="content_length" transfer-ownership="none">
            <doc xml:space="preserve">the size (in bytes) of the file being uploaded</doc>
            <type name="gint64" c:type="goffset"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable for the entire upload stream, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_authorization_domain"
              c:identifier="gdata_upload_stream_get_authorization_domain"
              version="0.9.0">
        <doc xml:space="preserve">Gets the authorization domain used to authorize the upload, as passed to gdata_upload_stream_new(). It may be %NULL if authorization is not
needed for the upload.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #GDataAuthorizationDomain used to authorize the upload, or %NULL</doc>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataUploadStream</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_cancellable"
              c:identifier="gdata_upload_stream_get_cancellable"
              version="0.8.0">
        <doc xml:space="preserve">Gets the #GCancellable for the entire upload operation, #GDataUploadStream:cancellable.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #GCancellable for the entire upload operation</doc>
          <type name="Gio.Cancellable" c:type="GCancellable*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataUploadStream</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_content_length"
              c:identifier="gdata_upload_stream_get_content_length"
              version="0.13.0">
        <doc xml:space="preserve">Gets the size (in bytes) of the file being uploaded. This will be &lt;code class="literal"&gt;-1&lt;/code&gt; for a non-resumable upload, and zero or greater
for a resumable upload.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the size of the file being uploaded</doc>
          <type name="gint64" c:type="goffset"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataUploadStream</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_content_type"
              c:identifier="gdata_upload_stream_get_content_type"
              version="0.5.0">
        <doc xml:space="preserve">Gets the content type of the file being uploaded.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the content type of the file being uploaded</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataUploadStream</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_entry"
              c:identifier="gdata_upload_stream_get_entry"
              version="0.5.0">
        <doc xml:space="preserve">Gets the entry being used to upload metadata, if one was passed to gdata_upload_stream_new().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the entry used for metadata, or %NULL</doc>
          <type name="Entry" c:type="GDataEntry*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataUploadStream</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_method"
              c:identifier="gdata_upload_stream_get_method"
              version="0.7.0">
        <doc xml:space="preserve">Gets the HTTP request method being used to upload the file, as passed to gdata_upload_stream_new().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the HTTP request method in use</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataUploadStream</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_response"
              c:identifier="gdata_upload_stream_get_response"
              version="0.5.0">
        <doc xml:space="preserve">Returns the server's response to the upload operation performed by the #GDataUploadStream. If the operation
is still underway, or the server's response hasn't been received yet, %NULL is returned and @length is set to &lt;code class="literal"&gt;-1&lt;/code&gt;.

If there was an error during the upload operation (but it is complete), %NULL is returned, and @length is set to &lt;code class="literal"&gt;0&lt;/code&gt;.

While it is safe to call this function from any thread at any time during the network operation, the only way to guarantee that the response has
been set before calling this function is to have closed the #GDataUploadStream by calling g_output_stream_close() on it, without cancelling
the close operation. Once the stream has been closed, all network communication is guaranteed to have finished. Note that if a call to
g_output_stream_close() is cancelled, g_output_stream_is_closed() will immediately start to return %TRUE, even if the #GDataUploadStream is still
attempting to flush the network buffers asynchronously — consequently, gdata_upload_stream_get_response() may still return %NULL and a @length of
&lt;code class="literal"&gt;-1&lt;/code&gt;. The only reliable way to determine if the stream has been fully closed in this situation is to check the results
of gdata_upload_stream_get_response(), rather than g_output_stream_is_closed().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the server's response to the upload, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataUploadStream</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </instance-parameter>
          <parameter name="length"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the length of the response, or %NULL</doc>
            <type name="gssize" c:type="gssize*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_service"
              c:identifier="gdata_upload_stream_get_service"
              version="0.5.0">
        <doc xml:space="preserve">Gets the service used to authorize the upload, as passed to gdata_upload_stream_new().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the #GDataService used to authorize the upload</doc>
          <type name="Service" c:type="GDataService*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataUploadStream</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_slug"
              c:identifier="gdata_upload_stream_get_slug"
              version="0.5.0">
        <doc xml:space="preserve">Gets the slug (filename) of the file being uploaded.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the slug of the file being uploaded</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataUploadStream</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_upload_uri"
              c:identifier="gdata_upload_stream_get_upload_uri"
              version="0.5.0">
        <doc xml:space="preserve">Gets the URI the file is being uploaded to, as passed to gdata_upload_stream_new().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the URI which the file is being uploaded to</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataUploadStream</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="authorization-domain"
                version="0.9.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The authorization domain for the upload, against which the #GDataService:authorizer for the #GDataDownloadStream:service should be
authorized. This may be %NULL if authorization is not needed for the upload.</doc>
        <type name="AuthorizationDomain"/>
      </property>
      <property name="cancellable"
                version="0.8.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">An optional cancellable used to cancel the entire upload operation. If a #GCancellable instance isn't provided for this property at
construction time (i.e. to gdata_upload_stream_new()), one will be created internally and can be retrieved using
gdata_upload_stream_get_cancellable() and used to cancel the upload operation with g_cancellable_cancel() just as if it was passed to
gdata_upload_stream_new().

If the upload operation is cancelled using this #GCancellable, any ongoing network activity will be stopped, and any pending or future calls
to #GOutputStream API on the #GDataUploadStream will return %G_IO_ERROR_CANCELLED. Note that the #GCancellable objects which can be passed
to individual #GOutputStream operations will not cancel the upload operation proper if cancelled — they will merely cancel that API call.
The only way to cancel the upload operation completely is using #GDataUploadStream:cancellable.</doc>
        <type name="Gio.Cancellable"/>
      </property>
      <property name="content-length"
                version="0.13.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The content length (in bytes) of the file being uploaded (i.e. as returned by g_file_info_get_size()). Note that this does not include the
length of the XML serialisation of #GDataUploadStream:entry, if set.

If this is &lt;code class="literal"&gt;-1&lt;/code&gt; the upload will be non-resumable; if it is non-negative, the upload will be resumable.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="content-type"
                version="0.5.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The content type of the file being uploaded (i.e. as returned by g_file_info_get_content_type()).</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="entry"
                version="0.5.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The entry used for metadata to upload.</doc>
        <type name="Entry"/>
      </property>
      <property name="method"
                version="0.7.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The HTTP request method to use when uploading the file.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="service"
                version="0.5.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The service which is used to authorize the upload, and to which the upload relates.</doc>
        <type name="Service"/>
      </property>
      <property name="slug"
                version="0.5.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The slug of the file being uploaded. This is usually the display name of the file (i.e. as returned by g_file_info_get_display_name()).</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="upload-uri"
                version="0.5.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The URI to upload the data and metadata to.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Gio.OutputStream" c:type="GOutputStream"/>
      </field>
      <field name="priv">
        <type name="UploadStreamPrivate" c:type="GDataUploadStreamPrivate*"/>
      </field>
    </class>
    <record name="UploadStreamClass"
            c:type="GDataUploadStreamClass"
            glib:is-gtype-struct-for="UploadStream"
            version="0.5.0">
      <doc xml:space="preserve">All the fields in the #GDataUploadStreamClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="Gio.OutputStreamClass" c:type="GOutputStreamClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="UploadStreamPrivate"
            c:type="GDataUploadStreamPrivate"
            disguised="1">
    </record>
    <constant name="YOUTUBE_ACTION_COMMENT"
              value="comment"
              c:type="GDATA_YOUTUBE_ACTION_COMMENT"
              version="0.7.0">
      <doc xml:space="preserve">An action to comment on a video, for use with gdata_youtube_video_set_access_control().</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="YOUTUBE_ACTION_COMMENT_VOTE"
              value="commentVote"
              c:type="GDATA_YOUTUBE_ACTION_COMMENT_VOTE"
              version="0.7.0">
      <doc xml:space="preserve">An action to rate other users' comments on a video, for use with gdata_youtube_video_set_access_control().</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="YOUTUBE_ACTION_EMBED"
              value="embed"
              c:type="GDATA_YOUTUBE_ACTION_EMBED"
              version="0.7.0">
      <doc xml:space="preserve">An action to embed a video on third-party websites, for use with gdata_youtube_video_set_access_control().</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="YOUTUBE_ACTION_RATE"
              value="rate"
              c:type="GDATA_YOUTUBE_ACTION_RATE"
              version="0.7.0">
      <doc xml:space="preserve">An action to rate a video, for use with gdata_youtube_video_set_access_control().</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="YOUTUBE_ACTION_SYNDICATE"
              value="syndicate"
              c:type="GDATA_YOUTUBE_ACTION_SYNDICATE"
              version="0.7.0">
      <doc xml:space="preserve">An action allowing YouTube to show the video on mobile phones and televisions, for use with gdata_youtube_video_set_access_control().</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="YOUTUBE_ACTION_VIDEO_RESPOND"
              value="videoRespond"
              c:type="GDATA_YOUTUBE_ACTION_VIDEO_RESPOND"
              version="0.7.0">
      <doc xml:space="preserve">An action to add a video response to a video, for use with gdata_youtube_video_set_access_control().</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="YOUTUBE_ASPECT_RATIO_WIDESCREEN"
              value="widescreen"
              c:type="GDATA_YOUTUBE_ASPECT_RATIO_WIDESCREEN"
              version="0.7.0">
      <doc xml:space="preserve">The aspect ratio for widescreen (16:9) videos.

For more information, see the &lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_yt:aspectratio"&gt;
online documentation&lt;/ulink&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="YOUTUBE_CREDIT_ENTITY_PARTNER"
              value="partner"
              c:type="GDATA_YOUTUBE_CREDIT_ENTITY_PARTNER"
              version="0.7.0"
              deprecated="1"
              deprecated-version="0.17.0">
      <doc xml:space="preserve">The credited entity is a YouTube partner.</doc>
      <doc-deprecated xml:space="preserve">This is no longer supported by Google. There is no
  replacement.</doc-deprecated>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="YOUTUBE_LICENSE_CC"
              value="cc"
              c:type="GDATA_YOUTUBE_LICENSE_CC"
              version="0.11.0">
      <doc xml:space="preserve">Value for #GDataYouTubeQuery:license to restrict search results to only videos which are Creative Commons licensed. Specifically, the license
is the Creative Commons Attribution 3.0 Unported license; see the
&lt;ulink type="http" url="http://www.google.com/support/youtube/bin/answer.py?hl=en&amp;answer=1284989"&gt;YouTube Help&lt;/ulink&gt; for more information.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="YOUTUBE_LICENSE_STANDARD"
              value="youtube"
              c:type="GDATA_YOUTUBE_LICENSE_STANDARD"
              version="0.11.0">
      <doc xml:space="preserve">Value for #GDataYouTubeQuery:license to restrict search results to only videos which are under the standard YouTube license.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="YOUTUBE_RATING_TYPE_MPAA"
              value="mpaa"
              c:type="GDATA_YOUTUBE_RATING_TYPE_MPAA"
              version="0.10.0">
      <doc xml:space="preserve">A rating type to pass to gdata_youtube_video_get_media_rating() for ratings by the &lt;ulink type="http" url="http://www.mpaa.org/"&gt;MPAA&lt;/ulink&gt;. The
values which can be returned for such ratings are: &lt;code class="literal"&gt;g&lt;/code&gt;, &lt;code class="literal"&gt;pg&lt;/code&gt;,
&lt;code class="literal"&gt;pg-13&lt;/code&gt;, &lt;code class="literal"&gt;r&lt;/code&gt; and &lt;code class="literal"&gt;nc-17&lt;/code&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="YOUTUBE_RATING_TYPE_SIMPLE"
              value="simple"
              c:type="GDATA_YOUTUBE_RATING_TYPE_SIMPLE"
              version="0.10.0"
              deprecated="1"
              deprecated-version="0.17.0">
      <doc xml:space="preserve">A rating type to pass to gdata_youtube_video_get_media_rating() for “simple” ratings. The values which can be returned for such ratings are:
&lt;code class="literal"&gt;adult&lt;/code&gt; and &lt;code class="literal"&gt;nonadult&lt;/code&gt;.</doc>
      <doc-deprecated xml:space="preserve">No longer supported by Google. Calling
  gdata_youtube_video_get_media_rating() with this rating type will always
  return %NULL.</doc-deprecated>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <constant name="YOUTUBE_RATING_TYPE_V_CHIP"
              value="v-chip"
              c:type="GDATA_YOUTUBE_RATING_TYPE_V_CHIP"
              version="0.10.0">
      <doc xml:space="preserve">A rating type to pass to gdata_youtube_video_get_media_rating() for ratings following the FCC
&lt;ulink type="http" url="http://www.fcc.gov/vchip/"&gt;V-Chip&lt;/ulink&gt; system. The values which can be returned for such ratings are:
&lt;code class="literal"&gt;tv-y&lt;/code&gt;, &lt;code class="literal"&gt;tv-y7&lt;/code&gt;, &lt;code class="literal"&gt;tv-y7-fv&lt;/code&gt;, &lt;code class="literal"&gt;tv-g&lt;/code&gt;,
&lt;code class="literal"&gt;tv-pg&lt;/code&gt;, &lt;code class="literal"&gt;tv-14&lt;/code&gt; and &lt;code class="literal"&gt;tv-ma&lt;/code&gt;.</doc>
      <type name="utf8" c:type="gchar*"/>
    </constant>
    <enumeration name="YouTubeAge"
                 version="0.3.0"
                 glib:type-name="GDataYouTubeAge"
                 glib:get-type="gdata_youtube_age_get_type"
                 c:type="GDataYouTubeAge">
      <doc xml:space="preserve">Video ages, allowing queries to be limited to videos uploaded in a recent time period.</doc>
      <member name="all_time"
              value="0"
              c:identifier="GDATA_YOUTUBE_AGE_ALL_TIME"
              glib:nick="all-time">
        <doc xml:space="preserve">retrieve all videos, regardless of the date they were uploaded</doc>
      </member>
      <member name="today"
              value="1"
              c:identifier="GDATA_YOUTUBE_AGE_TODAY"
              glib:nick="today">
        <doc xml:space="preserve">retrieve only videos uploaded in the past day</doc>
      </member>
      <member name="this_week"
              value="2"
              c:identifier="GDATA_YOUTUBE_AGE_THIS_WEEK"
              glib:nick="this-week">
        <doc xml:space="preserve">retrieve only videos uploaded in the past week</doc>
      </member>
      <member name="this_month"
              value="3"
              c:identifier="GDATA_YOUTUBE_AGE_THIS_MONTH"
              glib:nick="this-month">
        <doc xml:space="preserve">retrieve only videos uploaded in the past month</doc>
      </member>
    </enumeration>
    <class name="YouTubeCategory"
           c:symbol-prefix="youtube_category"
           c:type="GDataYouTubeCategory"
           version="0.7.0"
           parent="Category"
           glib:type-name="GDataYouTubeCategory"
           glib:get-type="gdata_youtube_category_get_type"
           glib:type-struct="YouTubeCategoryClass">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeCategory structure are private and should never be accessed directly.</doc>
      <implements name="Comparable"/>
      <method name="is_assignable"
              c:identifier="gdata_youtube_category_is_assignable"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeCategory:is-assignable property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">whether new videos can be assigned to the category</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeCategory</doc>
            <type name="YouTubeCategory" c:type="GDataYouTubeCategory*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_browsable"
              c:identifier="gdata_youtube_category_is_browsable"
              version="0.7.0">
        <doc xml:space="preserve">Returns whether the category is browsable in the given @region. The list of supported region IDs is
&lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#Region_specific_feeds"&gt;available online&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">whether the category is browsable in @region</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeCategory</doc>
            <type name="YouTubeCategory" c:type="GDataYouTubeCategory*"/>
          </instance-parameter>
          <parameter name="region" transfer-ownership="none">
            <doc xml:space="preserve">a two-letter region ID</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="is_deprecated"
              c:identifier="gdata_youtube_category_is_deprecated"
              version="0.7.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeCategory:is-deprecated property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">whether the category is deprecated</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeCategory</doc>
            <type name="YouTubeCategory" c:type="GDataYouTubeCategory*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="is-assignable" version="0.7.0" transfer-ownership="none">
        <doc xml:space="preserve">Whether new videos can be added to the category.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="is-deprecated" version="0.7.0" transfer-ownership="none">
        <doc xml:space="preserve">Whether the category is deprecated.</doc>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <field name="parent">
        <type name="Category" c:type="GDataCategory"/>
      </field>
      <field name="priv">
        <type name="YouTubeCategoryPrivate"
              c:type="GDataYouTubeCategoryPrivate*"/>
      </field>
    </class>
    <record name="YouTubeCategoryClass"
            c:type="GDataYouTubeCategoryClass"
            glib:is-gtype-struct-for="YouTubeCategory"
            version="0.7.0">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeCategoryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="CategoryClass" c:type="GDataCategoryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="YouTubeCategoryPrivate"
            c:type="GDataYouTubeCategoryPrivate"
            disguised="1">
    </record>
    <class name="YouTubeComment"
           c:symbol-prefix="youtube_comment"
           c:type="GDataYouTubeComment"
           version="0.10.0"
           parent="Comment"
           glib:type-name="GDataYouTubeComment"
           glib:get-type="gdata_youtube_comment_get_type"
           glib:type-struct="YouTubeCommentClass">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeComment structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_youtube_comment_new"
                   version="0.10.0">
        <doc xml:space="preserve">Creates a new #GDataYouTubeComment with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataYouTubeComment; unref with g_object_unref()</doc>
          <type name="YouTubeComment" c:type="GDataYouTubeComment*"/>
        </return-value>
        <parameters>
          <parameter name="id" transfer-ownership="none">
            <doc xml:space="preserve">the comment's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_parent_comment_uri"
              c:identifier="gdata_youtube_comment_get_parent_comment_uri"
              version="0.10.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeComment:parent-comment-uri property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the parent comment URI, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeComment</doc>
            <type name="YouTubeComment" c:type="GDataYouTubeComment*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_parent_comment_uri"
              c:identifier="gdata_youtube_comment_set_parent_comment_uri"
              version="0.10.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeComment:parent-comment-uri property to @parent_comment_uri.

Set @parent_comment_uri to %NULL to unset the #GDataYouTubeComment:parent-comment-uri property in the comment (i.e. make the comment a top-level
comment).

See the &lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/developers_guide_protocol_comments.html#Retrieve_comments"&gt;online
documentation&lt;/ulink&gt; for more information.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeComment</doc>
            <type name="YouTubeComment" c:type="GDataYouTubeComment*"/>
          </instance-parameter>
          <parameter name="parent_comment_uri" transfer-ownership="none">
            <doc xml:space="preserve">a new parent comment URI, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="parent-comment-uri"
                version="0.10.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The URI of the parent comment to this one, or %NULL if this comment is a top-level comment.

See the documentation for #GDataYouTubeComment for an explanation of the semantics of parent comment URIs.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Comment" c:type="GDataComment"/>
      </field>
      <field name="priv">
        <type name="YouTubeCommentPrivate"
              c:type="GDataYouTubeCommentPrivate*"/>
      </field>
    </class>
    <record name="YouTubeCommentClass"
            c:type="GDataYouTubeCommentClass"
            glib:is-gtype-struct-for="YouTubeComment"
            version="0.10.0">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeCommentClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="CommentClass" c:type="GDataCommentClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="YouTubeCommentPrivate"
            c:type="GDataYouTubeCommentPrivate"
            disguised="1">
    </record>
    <class name="YouTubeContent"
           c:symbol-prefix="youtube_content"
           c:type="GDataYouTubeContent"
           version="0.4.0"
           deprecated="1"
           deprecated-version="0.17.0"
           parent="MediaContent"
           glib:type-name="GDataYouTubeContent"
           glib:get-type="gdata_youtube_content_get_type"
           glib:type-struct="YouTubeContentClass">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeContent structure are private and should never be accessed directly.</doc>
      <doc-deprecated xml:space="preserve">Accessing YouTube video content directly is no longer
  supported by Google. There is no replacement.</doc-deprecated>
      <method name="get_format"
              c:identifier="gdata_youtube_content_get_format"
              version="0.4.0"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeContent:format property.</doc>
        <doc-deprecated xml:space="preserve">Accessing YouTube video content directly is no longer
  supported by Google. There is no replacement.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the video format, or %GDATA_YOUTUBE_FORMAT_UNKNOWN</doc>
          <type name="YouTubeFormat" c:type="GDataYouTubeFormat"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeContent</doc>
            <type name="YouTubeContent" c:type="GDataYouTubeContent*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="format"
                version="0.4.0"
                deprecated="1"
                deprecated-version="0.17.0"
                transfer-ownership="none">
        <doc xml:space="preserve">The video format of the video object.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_media:content"&gt;
YouTube documentation&lt;/ulink&gt;.</doc>
        <doc-deprecated xml:space="preserve">Accessing YouTube video content directly is
  no longer supported by Google. There is no replacement.</doc-deprecated>
        <type name="YouTubeFormat"/>
      </property>
      <field name="parent">
        <type name="MediaContent" c:type="GDataMediaContent"/>
      </field>
      <field name="priv">
        <type name="YouTubeContentPrivate"
              c:type="GDataYouTubeContentPrivate*"/>
      </field>
    </class>
    <record name="YouTubeContentClass"
            c:type="GDataYouTubeContentClass"
            glib:is-gtype-struct-for="YouTubeContent"
            version="0.4.0"
            deprecated="1"
            deprecated-version="0.17.0">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeContentClass structure are private and should never be accessed directly.</doc>
      <doc-deprecated xml:space="preserve">Accessing YouTube video content directly is no longer
  supported by Google. There is no replacement.</doc-deprecated>
      <field name="parent" readable="0" private="1">
        <type name="MediaContentClass" c:type="GDataMediaContentClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="YouTubeContentPrivate"
            c:type="GDataYouTubeContentPrivate"
            disguised="1">
    </record>
    <class name="YouTubeCredit"
           c:symbol-prefix="youtube_credit"
           c:type="GDataYouTubeCredit"
           version="0.4.0"
           deprecated="1"
           deprecated-version="0.17.0"
           parent="MediaCredit"
           glib:type-name="GDataYouTubeCredit"
           glib:get-type="gdata_youtube_credit_get_type"
           glib:type-struct="YouTubeCreditClass">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeCredit structure are private and should never be accessed directly.</doc>
      <doc-deprecated xml:space="preserve">This is no longer supported by Google. There is no
  replacement.</doc-deprecated>
      <method name="get_entity_type"
              c:identifier="gdata_youtube_credit_get_entity_type"
              version="0.4.0"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeCredit:entity-type property.</doc>
        <doc-deprecated xml:space="preserve">This is no longer supported by Google. There is no
  replacement.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the type of the credited user (e.g. %GDATA_YOUTUBE_CREDIT_ENTITY_PARTNER), or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeCredit</doc>
            <type name="YouTubeCredit" c:type="GDataYouTubeCredit*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="entity-type"
                version="0.4.0"
                deprecated="1"
                deprecated-version="0.17.0"
                transfer-ownership="none">
        <doc xml:space="preserve">The type of entity who is credited. Currently this can only be %GDATA_YOUTUBE_CREDIT_ENTITY_PARTNER, for a YouTube partner.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_media:credit"&gt;
YouTube documentation&lt;/ulink&gt;.</doc>
        <doc-deprecated xml:space="preserve">This is no longer supported by Google. There
  is no replacement.</doc-deprecated>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="MediaCredit" c:type="GDataMediaCredit"/>
      </field>
      <field name="priv">
        <type name="YouTubeCreditPrivate" c:type="GDataYouTubeCreditPrivate*"/>
      </field>
    </class>
    <record name="YouTubeCreditClass"
            c:type="GDataYouTubeCreditClass"
            glib:is-gtype-struct-for="YouTubeCredit"
            version="0.4.0"
            deprecated="1"
            deprecated-version="0.17.0">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeCreditClass structure are private and should never be accessed directly.</doc>
      <doc-deprecated xml:space="preserve">This is no longer supported by Google. There is no
  replacement.</doc-deprecated>
      <field name="parent" readable="0" private="1">
        <type name="MediaCreditClass" c:type="GDataMediaCreditClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="YouTubeCreditPrivate"
            c:type="GDataYouTubeCreditPrivate"
            disguised="1">
    </record>
    <class name="YouTubeFeed"
           c:symbol-prefix="youtube_feed"
           c:type="GDataYouTubeFeed"
           version="0.17.0"
           parent="Feed"
           glib:type-name="GDataYouTubeFeed"
           glib:get-type="gdata_youtube_feed_get_type"
           glib:type-struct="YouTubeFeedClass">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeFeed structure are private and should
never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="Feed" c:type="GDataFeed"/>
      </field>
      <field name="priv" readable="0" private="1">
        <type name="YouTubeFeedPrivate" c:type="GDataYouTubeFeedPrivate*"/>
      </field>
    </class>
    <record name="YouTubeFeedClass"
            c:type="GDataYouTubeFeedClass"
            glib:is-gtype-struct-for="YouTubeFeed"
            version="0.17.0">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeFeedClass structure are private and should
never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="FeedClass" c:type="GDataFeedClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="YouTubeFeedPrivate"
            c:type="GDataYouTubeFeedPrivate"
            disguised="1">
    </record>
    <enumeration name="YouTubeFormat"
                 version="0.3.0"
                 deprecated="1"
                 deprecated-version="0.17.0"
                 glib:type-name="GDataYouTubeFormat"
                 glib:get-type="gdata_youtube_format_get_type"
                 c:type="GDataYouTubeFormat">
      <doc xml:space="preserve">Video formats available on YouTube. For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#formatsp"&gt;online documentation&lt;/ulink&gt;.</doc>
      <doc-deprecated xml:space="preserve">Accessing YouTube video content directly is no longer
  supported by Google. There is no replacement.</doc-deprecated>
      <member name="unknown"
              value="0"
              c:identifier="GDATA_YOUTUBE_FORMAT_UNKNOWN"
              glib:nick="unknown">
        <doc xml:space="preserve">retrieve videos in all formats when querying the service</doc>
      </member>
      <member name="rtsp_h263_amr"
              value="1"
              c:identifier="GDATA_YOUTUBE_FORMAT_RTSP_H263_AMR"
              glib:nick="rtsp-h263-amr">
        <doc xml:space="preserve">RTSP streaming URI for mobile video playback; H.263 video (up to 176×144) and AMR audio</doc>
      </member>
      <member name="http_swf"
              value="5"
              c:identifier="GDATA_YOUTUBE_FORMAT_HTTP_SWF"
              glib:nick="http-swf">
        <doc xml:space="preserve">HTTP URI to the embeddable player (SWF) for this video</doc>
      </member>
      <member name="rtsp_mpeg4_aac"
              value="6"
              c:identifier="GDATA_YOUTUBE_FORMAT_RTSP_MPEG4_AAC"
              glib:nick="rtsp-mpeg4-aac">
        <doc xml:space="preserve">RTSP streaming URI for mobile video playback; MPEG-4 SP video (up to 176×144) and AAC audio</doc>
      </member>
    </enumeration>
    <enumeration name="YouTubePermission"
                 version="0.7.0"
                 glib:type-name="GDataYouTubePermission"
                 glib:get-type="gdata_youtube_permission_get_type"
                 c:type="GDataYouTubePermission">
      <doc xml:space="preserve">Permissions for actions which can be set on a #GDataYouTubeVideo using gdata_youtube_video_set_access_control().

The only actions which can have the %GDATA_YOUTUBE_PERMISSION_MODERATED permission are
%GDATA_YOUTUBE_ACTION_RATE and %GDATA_YOUTUBE_ACTION_COMMENT.</doc>
      <member name="allowed"
              value="0"
              c:identifier="GDATA_YOUTUBE_PERMISSION_ALLOWED"
              glib:nick="allowed">
        <doc xml:space="preserve">the action is allowed for everyone</doc>
      </member>
      <member name="denied"
              value="1"
              c:identifier="GDATA_YOUTUBE_PERMISSION_DENIED"
              glib:nick="denied">
        <doc xml:space="preserve">the action is denied for everyone</doc>
      </member>
      <member name="moderated"
              value="2"
              c:identifier="GDATA_YOUTUBE_PERMISSION_MODERATED"
              glib:nick="moderated">
        <doc xml:space="preserve">the action is moderated by the video owner</doc>
      </member>
    </enumeration>
    <class name="YouTubeQuery"
           c:symbol-prefix="youtube_query"
           c:type="GDataYouTubeQuery"
           version="0.3.0"
           parent="Query"
           glib:type-name="GDataYouTubeQuery"
           glib:get-type="gdata_youtube_query_get_type"
           glib:type-struct="YouTubeQueryClass">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeQuery structure are private and should never be accessed directly.</doc>
      <constructor name="new"
                   c:identifier="gdata_youtube_query_new"
                   version="0.3.0">
        <doc xml:space="preserve">Creates a new #GDataYouTubeQuery with its #GDataQuery:q property set to @q.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataYouTubeQuery</doc>
          <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
        </return-value>
        <parameters>
          <parameter name="q"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a query string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_age"
              c:identifier="gdata_youtube_query_get_age"
              version="0.3.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeQuery:age property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the age property</doc>
          <type name="YouTubeAge" c:type="GDataYouTubeAge"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_format"
              c:identifier="gdata_youtube_query_get_format"
              version="0.3.0"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeQuery:format property.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries. There is no replacement.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the format property</doc>
          <type name="YouTubeFormat" c:type="GDataYouTubeFormat"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_language"
              c:identifier="gdata_youtube_query_get_language"
              version="0.3.0"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeQuery:language property.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries. There is no replacement.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the language property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_license"
              c:identifier="gdata_youtube_query_get_license"
              version="0.11.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeQuery:license property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the license property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_location"
              c:identifier="gdata_youtube_query_get_location"
              version="0.3.0">
        <doc xml:space="preserve">Gets the location-based properties of the #GDataYouTubeQuery&lt;!-- --&gt;: #GDataYouTubeQuery:latitude, #GDataYouTubeQuery:longitude,
#GDataYouTubeQuery:location-radius and #GDataYouTubeQuery:has-location.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
          <parameter name="latitude"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">a location in which to return the latitude, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
          <parameter name="longitude"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">a location in which to return the longitude, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
          <parameter name="radius"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">a location in which to return the location radius, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
          <parameter name="has_location"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">a location in which to return %TRUE if the query is searching for videos with a specific
location, %FALSE otherwise, or %NULL</doc>
            <type name="gboolean" c:type="gboolean*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_order_by"
              c:identifier="gdata_youtube_query_get_order_by"
              version="0.3.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeQuery:order-by property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the order by property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_restriction"
              c:identifier="gdata_youtube_query_get_restriction"
              version="0.3.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeQuery:restriction property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the restriction property, or %NULL if it is unset</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_safe_search"
              c:identifier="gdata_youtube_query_get_safe_search"
              version="0.3.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeQuery:safe-search property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the safe search property</doc>
          <type name="YouTubeSafeSearch" c:type="GDataYouTubeSafeSearch"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_sort_order"
              c:identifier="gdata_youtube_query_get_sort_order"
              version="0.3.0"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeQuery:sort-order property.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries. There is no replacement.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the sort order property</doc>
          <type name="YouTubeSortOrder" c:type="GDataYouTubeSortOrder"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_uploader"
              c:identifier="gdata_youtube_query_get_uploader"
              version="0.3.0"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeQuery:uploader property.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries. There is no replacement.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the uploader property</doc>
          <type name="YouTubeUploader" c:type="GDataYouTubeUploader"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_age"
              c:identifier="gdata_youtube_query_set_age"
              version="0.3.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeQuery:age property of the #GDataYouTubeQuery to @age.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
          <parameter name="age" transfer-ownership="none">
            <doc xml:space="preserve">the new age</doc>
            <type name="YouTubeAge" c:type="GDataYouTubeAge"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_format"
              c:identifier="gdata_youtube_query_set_format"
              version="0.3.0"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeQuery:format property of the #GDataYouTubeQuery to @format.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries. There is no replacement.</doc-deprecated>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
          <parameter name="format" transfer-ownership="none">
            <doc xml:space="preserve">the requested video format</doc>
            <type name="YouTubeFormat" c:type="GDataYouTubeFormat"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_language"
              c:identifier="gdata_youtube_query_set_language"
              version="0.3.0"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeQuery:language property of the #GDataYouTubeQuery to the new language, @language.

Set @language to %NULL to unset the property in the query URI.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries. There is no replacement.</doc-deprecated>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
          <parameter name="language"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new language name, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_license"
              c:identifier="gdata_youtube_query_set_license"
              version="0.11.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeQuery:license property of the #GDataYouTubeQuery to the new license value, @license.

Set @license to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
          <parameter name="license"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new license value, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_location"
              c:identifier="gdata_youtube_query_set_location"
              version="0.3.0">
        <doc xml:space="preserve">Sets the location-based properties of the #GDataYouTubeQuery&lt;!-- --&gt;: #GDataYouTubeQuery:latitude, #GDataYouTubeQuery:longitude,
#GDataYouTubeQuery:location-radius and #GDataYouTubeQuery:has-location.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
          <parameter name="latitude" transfer-ownership="none">
            <doc xml:space="preserve">the new latitude, or %G_MAXDOUBLE</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
          <parameter name="longitude" transfer-ownership="none">
            <doc xml:space="preserve">the new longitude, or %G_MAXDOUBLE</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
          <parameter name="radius" transfer-ownership="none">
            <doc xml:space="preserve">the new location radius, or &lt;code class="literal"&gt;0&lt;/code&gt;</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
          <parameter name="has_location" transfer-ownership="none">
            <doc xml:space="preserve">%TRUE if the query is for videos with a specific location, %FALSE otherwise</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_order_by"
              c:identifier="gdata_youtube_query_set_order_by"
              version="0.3.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeQuery: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.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
          <parameter name="order_by"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new order by string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_restriction"
              c:identifier="gdata_youtube_query_set_restriction"
              version="0.3.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeQuery:restriction property of the #GDataYouTubeQuery to the new restriction string, @restriction.

Set @restriction to %NULL to unset the property in the query URI.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
          <parameter name="restriction"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new restriction string, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_safe_search"
              c:identifier="gdata_youtube_query_set_safe_search"
              version="0.3.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeQuery:safe-search property of the #GDataYouTubeQuery to @safe_search.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
          <parameter name="safe_search" transfer-ownership="none">
            <doc xml:space="preserve">a new safe search level</doc>
            <type name="YouTubeSafeSearch" c:type="GDataYouTubeSafeSearch"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_sort_order"
              c:identifier="gdata_youtube_query_set_sort_order"
              version="0.3.0"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeQuery: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.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries. There is no replacement.</doc-deprecated>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
          <parameter name="sort_order" transfer-ownership="none">
            <doc xml:space="preserve">the new sort order</doc>
            <type name="YouTubeSortOrder" c:type="GDataYouTubeSortOrder"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_uploader"
              c:identifier="gdata_youtube_query_set_uploader"
              version="0.3.0"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeQuery:uploader property of the #GDataYouTubeQuery to @uploader.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries. There is no replacement.</doc-deprecated>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeQuery</doc>
            <type name="YouTubeQuery" c:type="GDataYouTubeQuery*"/>
          </instance-parameter>
          <parameter name="uploader" transfer-ownership="none">
            <doc xml:space="preserve">the new uploader</doc>
            <type name="YouTubeUploader" c:type="GDataYouTubeUploader"/>
          </parameter>
        </parameters>
      </method>
      <property name="age"
                version="0.3.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">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.</doc>
        <type name="YouTubeAge"/>
      </property>
      <property name="format"
                version="0.3.0"
                deprecated="1"
                deprecated-version="0.17.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies that videos must be available in a particular video format. Use %GDATA_YOUTUBE_FORMAT_UNKNOWN to
retrieve videos irrespective of their format availability.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries. There is no replacement.</doc-deprecated>
        <type name="YouTubeFormat"/>
      </property>
      <property name="has-location"
                version="0.3.0"
                deprecated="1"
                deprecated-version="0.17.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Whether to restrict search results to videos with specific coordinates associated with them. If used with a given
#GDataYouTubeQuery:latitude and #GDataYouTubeQuery: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 #GDataYouTubeQuery:latitude.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries.</doc-deprecated>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="language"
                version="0.3.0"
                deprecated="1"
                deprecated-version="0.17.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">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 &lt;literal&gt;zh-Hans&lt;/literal&gt; for simplified Chinese and &lt;literal&gt;zh-Hant&lt;/literal&gt;
for traditional Chinese.

For more information, see the &lt;ulink type="http"
url="http://code.google.com/apis/youtube/2.0/reference.html#lrsp"&gt;online documentation&lt;/ulink&gt;.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries. There is no replacement.</doc-deprecated>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="latitude"
                version="0.3.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The latitude of a particular location of which videos should be found. This should be used in conjunction with
#GDataYouTubeQuery:longitude; if either property is outside the valid range, neither will be used. Valid latitudes
are between &lt;code class="literal"&gt;-90&lt;/code&gt; and &lt;code class="literal"&gt;90&lt;/code&gt;0 degrees; any values of this property outside that range
will unset the property in the query URI.

If #GDataYouTubeQuery:location-radius is a non-&lt;code class="literal"&gt;0&lt;/code&gt; value, this will define a circle from which videos should be
found.

As it is deprecated, the value of #GDataYouTubeQuery:has-location is
ignored.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/search/list#location"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="license"
                version="0.11.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">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 &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/search/list#videoLicense"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="location-radius"
                version="0.3.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">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 #GDataYouTubeQuery:latitude and #GDataYouTubeQuery:longitude.

Set this property to &lt;code class="literal"&gt;0&lt;/code&gt; to search for specific coordinates, rather than within a given radius.

For more information, see the documentation for #GDataYouTubeQuery:latitude.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="longitude"
                version="0.3.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The longitude of a particular location of which videos should be found. This should be used in conjunction with
#GDataYouTubeQuery:latitude; if either property is outside the valid range, neither will be used. Valid longitudes
are between &lt;code class="literal"&gt;-180&lt;/code&gt; and &lt;code class="literal"&gt;180&lt;/code&gt; degrees; any values of this property outside that
range will unset the property in the query URI.

For more information, see the documentation for #GDataYouTubeQuery:latitude.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="order-by"
                version="0.3.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies the order of entries in a feed. Supported values are &lt;literal&gt;relevance&lt;/literal&gt;,
&lt;literal&gt;published&lt;/literal&gt;, &lt;literal&gt;viewCount&lt;/literal&gt; and &lt;literal&gt;rating&lt;/literal&gt;.

Additionally, results most relevant to a specific language can be returned by setting the property
to &lt;literal&gt;relevance_lang_&lt;replaceable&gt;languageCode&lt;/replaceable&gt;&lt;/literal&gt;, where
&lt;replaceable&gt;languageCode&lt;/replaceable&gt; is an ISO 639-1 language code, as used in #GDataYouTubeQuery:language.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/search/list#order"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="restriction"
                version="0.3.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">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 &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/search/list#regionCode"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="safe-search"
                version="0.3.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Whether the search results should include restricted content as well as standard content.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/search/list#safeSearch"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="YouTubeSafeSearch"/>
      </property>
      <property name="sort-order"
                version="0.3.0"
                deprecated="1"
                deprecated-version="0.17.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies the direction of sorting. To use the default sort order, set the property to %GDATA_YOUTUBE_SORT_NONE.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries. There is no replacement.</doc-deprecated>
        <type name="YouTubeSortOrder"/>
      </property>
      <property name="uploader"
                version="0.3.0"
                deprecated="1"
                deprecated-version="0.17.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">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.</doc>
        <doc-deprecated xml:space="preserve">No longer supported by Google. The value of
  this property will be unused in queries. There is no replacement.</doc-deprecated>
        <type name="YouTubeUploader"/>
      </property>
      <field name="parent">
        <type name="Query" c:type="GDataQuery"/>
      </field>
      <field name="priv">
        <type name="YouTubeQueryPrivate" c:type="GDataYouTubeQueryPrivate*"/>
      </field>
    </class>
    <record name="YouTubeQueryClass"
            c:type="GDataYouTubeQueryClass"
            glib:is-gtype-struct-for="YouTubeQuery"
            version="0.3.0">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeQueryClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="QueryClass" c:type="GDataQueryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="YouTubeQueryPrivate"
            c:type="GDataYouTubeQueryPrivate"
            disguised="1">
    </record>
    <enumeration name="YouTubeSafeSearch"
                 version="0.3.0"
                 glib:type-name="GDataYouTubeSafeSearch"
                 glib:get-type="gdata_youtube_safe_search_get_type"
                 c:type="GDataYouTubeSafeSearch">
      <doc xml:space="preserve">Safe search levels for removing restricted entries from query results. For more information, see the
&lt;ulink type="http" url="https://developers.google.com/youtube/v3/docs/search/list#safeSearch"&gt;online documentation&lt;/ulink&gt;.</doc>
      <member name="none"
              value="0"
              c:identifier="GDATA_YOUTUBE_SAFE_SEARCH_NONE"
              glib:nick="none">
        <doc xml:space="preserve">YouTube will not perform any filtering on the search result set</doc>
      </member>
      <member name="moderate"
              value="1"
              c:identifier="GDATA_YOUTUBE_SAFE_SEARCH_MODERATE"
              glib:nick="moderate">
        <doc xml:space="preserve">YouTube will filter some content from search results and, at the least,
will filter content that is restricted in your locale</doc>
      </member>
      <member name="strict"
              value="2"
              c:identifier="GDATA_YOUTUBE_SAFE_SEARCH_STRICT"
              glib:nick="strict">
        <doc xml:space="preserve">YouTube will try to exclude all restricted content from the search result set</doc>
      </member>
    </enumeration>
    <class name="YouTubeService"
           c:symbol-prefix="youtube_service"
           c:type="GDataYouTubeService"
           parent="Service"
           glib:type-name="GDataYouTubeService"
           glib:get-type="gdata_youtube_service_get_type"
           glib:type-struct="YouTubeServiceClass">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeService structure are private and should never be accessed directly.</doc>
      <implements name="Batchable"/>
      <constructor name="new"
                   c:identifier="gdata_youtube_service_new"
                   version="0.9.0">
        <doc xml:space="preserve">Creates a new #GDataYouTubeService using the given #GDataAuthorizer. If @authorizer is %NULL, all requests are made as an unauthenticated user.
The @developer_key must be unique for your application, and as
&lt;ulink type="http" url="https://developers.google.com/youtube/registering_an_application"&gt;registered with Google&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataYouTubeService, or %NULL; unref with g_object_unref()</doc>
          <type name="YouTubeService" c:type="GDataYouTubeService*"/>
        </return-value>
        <parameters>
          <parameter name="developer_key" transfer-ownership="none">
            <doc xml:space="preserve">your application's developer API key</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="authorizer"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataAuthorizer to authorize the service's requests, or %NULL</doc>
            <type name="Authorizer" c:type="GDataAuthorizer*"/>
          </parameter>
        </parameters>
      </constructor>
      <function name="get_primary_authorization_domain"
                c:identifier="gdata_youtube_service_get_primary_authorization_domain"
                version="0.9.0">
        <doc xml:space="preserve">The primary #GDataAuthorizationDomain for interacting with YouTube. This will not normally need to be used, as it's used internally
by the #GDataYouTubeService methods. However, if using the plain #GDataService methods to implement custom queries or requests which libgdata
does not support natively, then this domain may be needed to authorize the requests.

The domain never changes, and is interned so that pointer comparison can be used to differentiate it from other authorization domains.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the service's authorization domain</doc>
          <type name="AuthorizationDomain" c:type="GDataAuthorizationDomain*"/>
        </return-value>
      </function>
      <method name="finish_video_upload"
              c:identifier="gdata_youtube_service_finish_video_upload"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Finish off a video upload operation started by gdata_youtube_service_upload_video(), parsing the result and returning the new #GDataYouTubeVideo.

If an error occurred during the upload operation, it will have been returned during the operation (e.g. by g_output_stream_splice() or one
of the other stream methods). In such a case, %NULL will be returned but @error will remain unset. @error is only set in the case that the server
indicates that the operation was successful, but an error is encountered in parsing the result sent by the server.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the new #GDataYouTubeVideo, or %NULL; unref with g_object_unref()</doc>
          <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeService</doc>
            <type name="YouTubeService" c:type="GDataYouTubeService*"/>
          </instance-parameter>
          <parameter name="upload_stream" transfer-ownership="none">
            <doc xml:space="preserve">the #GDataUploadStream from the operation</doc>
            <type name="UploadStream" c:type="GDataUploadStream*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_categories"
              c:identifier="gdata_youtube_service_get_categories"
              version="0.7.0"
              throws="1">
        <doc xml:space="preserve">Gets a list of the categories currently in use on YouTube. The returned #GDataAPPCategories contains a list of #GDataYouTubeCategory&lt;!-- --&gt;s which
enumerate the current YouTube categories.

The category labels (#GDataCategory:label) are localised based on the value of #GDataService:locale.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataAPPCategories, or %NULL; unref with g_object_unref()</doc>
          <type name="APPCategories" c:type="GDataAPPCategories*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeService</doc>
            <type name="YouTubeService" c:type="GDataYouTubeService*"/>
          </instance-parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_categories_async"
              c:identifier="gdata_youtube_service_get_categories_async"
              version="0.7.0">
        <doc xml:space="preserve">Gets a list of the categories currently in use on YouTube. @self is reffed when this function is called, so can safely be unreffed after this
function returns.

For more details, see gdata_youtube_service_get_categories(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_youtube_service_get_categories_finish() to get the results of the
operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeService</doc>
            <type name="YouTubeService" c:type="GDataYouTubeService*"/>
          </instance-parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="2">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when the request is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_categories_finish"
              c:identifier="gdata_youtube_service_get_categories_finish"
              version="0.7.0"
              throws="1">
        <doc xml:space="preserve">Finishes an asynchronous request for a list of categories on YouTube, as started with gdata_youtube_service_get_categories_async().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataAPPCategories, or %NULL; unref with g_object_unref()</doc>
          <type name="APPCategories" c:type="GDataAPPCategories*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeService</doc>
            <type name="YouTubeService" c:type="GDataYouTubeService*"/>
          </instance-parameter>
          <parameter name="async_result" transfer-ownership="none">
            <doc xml:space="preserve">a #GAsyncResult</doc>
            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_developer_key"
              c:identifier="gdata_youtube_service_get_developer_key">
        <doc xml:space="preserve">Gets the #GDataYouTubeService:developer-key property from the #GDataYouTubeService.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the developer key property</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeService</doc>
            <type name="YouTubeService" c:type="GDataYouTubeService*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="query_related"
              c:identifier="gdata_youtube_service_query_related"
              throws="1">
        <doc xml:space="preserve">Queries the service for videos related to @video. The algorithm determining which videos are related is on the server side.

Parameters and other errors are as for gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeService</doc>
            <type name="YouTubeService" c:type="GDataYouTubeService*"/>
          </instance-parameter>
          <parameter name="video" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo for which to find related videos</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_related_async"
              c:identifier="gdata_youtube_service_query_related_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the service for videos related to @video. The algorithm determining which videos are related is on the server side.
@self and @query are both reffed when this function is called, so can safely be freed after this function returns.

For more details, see gdata_youtube_service_query_related(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_service_query_finish()
to get the results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="YouTubeService" c:type="GDataYouTubeService*"/>
          </instance-parameter>
          <parameter name="video" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo for which to find related videos</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="4"
                     destroy="5">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="7">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authentication is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_standard_feed"
              c:identifier="gdata_youtube_service_query_standard_feed"
              throws="1">
        <doc xml:space="preserve">Queries the service's standard @feed_type feed to build a #GDataFeed.

Note that with the port from v2 to v3 of the YouTube API in libgdata
0.17.0, all feed types except %GDATA_YOUTUBE_MOST_POPULAR_FEED have been
deprecated. Other feed types will now transparently return
%GDATA_YOUTUBE_MOST_POPULAR_FEED, limited to the past 24 hours.

Parameters and errors are as for gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results, or %NULL; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeService</doc>
            <type name="YouTubeService" c:type="GDataYouTubeService*"/>
          </instance-parameter>
          <parameter name="feed_type" transfer-ownership="none">
            <doc xml:space="preserve">the feed type to query, from #GDataYouTubeStandardFeedType</doc>
            <type name="YouTubeStandardFeedType"
                  c:type="GDataYouTubeStandardFeedType"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_standard_feed_async"
              c:identifier="gdata_youtube_service_query_standard_feed_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the service's standard @feed_type feed to build a #GDataFeed. @self and
@query are both reffed when this function is called, so can safely be freed after this function returns.

For more details, see gdata_youtube_service_query_standard_feed(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_service_query_finish()
to get the results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="YouTubeService" c:type="GDataYouTubeService*"/>
          </instance-parameter>
          <parameter name="feed_type" transfer-ownership="none">
            <doc xml:space="preserve">the feed type to query, from #GDataYouTubeStandardFeedType</doc>
            <type name="YouTubeStandardFeedType"
                  c:type="GDataYouTubeStandardFeedType"/>
          </parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="4"
                     destroy="5">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="7">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authentication is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_videos"
              c:identifier="gdata_youtube_service_query_videos"
              throws="1">
        <doc xml:space="preserve">Queries the service for videos matching the parameters set on the #GDataQuery. This searches site-wide, and imposes no other restrictions or
parameters on the query.

Parameters and errors are as for gdata_service_query().</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataFeed of query results, or %NULL; unref with g_object_unref()</doc>
          <type name="Feed" c:type="GDataFeed*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeService</doc>
            <type name="YouTubeService" c:type="GDataYouTubeService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="query_videos_async"
              c:identifier="gdata_youtube_service_query_videos_async"
              version="0.9.1">
        <doc xml:space="preserve">Queries the service for videos matching the parameters set on the #GDataQuery. This searches site-wide, and imposes no other restrictions or
parameters on the query. @self and @query are both reffed when this function is called, so can safely be freed after this function returns.

For more details, see gdata_youtube_service_query_videos(), which is the synchronous version of this function.

When the operation is finished, @callback will be called. You can then call gdata_service_query_finish()
to get the results of the operation.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataService</doc>
            <type name="YouTubeService" c:type="GDataYouTubeService*"/>
          </instance-parameter>
          <parameter name="query"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GDataQuery with the query parameters, or %NULL</doc>
            <type name="Query" c:type="GDataQuery*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="notified"
                     closure="3"
                     destroy="4">
            <doc xml:space="preserve">a #GDataQueryProgressCallback to call when an entry is loaded, or %NULL</doc>
            <type name="QueryProgressCallback"
                  c:type="GDataQueryProgressCallback"/>
          </parameter>
          <parameter name="progress_user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @progress_callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="destroy_progress_user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async">
            <doc xml:space="preserve">the function to call when @progress_callback will not be called any more, or %NULL. This function will be
called with @progress_user_data as a parameter and can be used to free any memory allocated for it.</doc>
            <type name="GLib.DestroyNotify" c:type="GDestroyNotify"/>
          </parameter>
          <parameter name="callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="async"
                     closure="6">
            <doc xml:space="preserve">a #GAsyncReadyCallback to call when authentication is finished</doc>
            <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
          </parameter>
          <parameter name="user_data" transfer-ownership="none">
            <doc xml:space="preserve">data to pass to the @callback function</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
        </parameters>
      </method>
      <method name="upload_video"
              c:identifier="gdata_youtube_service_upload_video"
              version="0.8.0"
              throws="1">
        <doc xml:space="preserve">Uploads a video to YouTube, using the properties from @video and the file data written to the resulting #GDataUploadStream.

If @video has already been inserted, a %GDATA_SERVICE_ERROR_ENTRY_ALREADY_INSERTED error will be returned. If no user is authenticated
with the service, %GDATA_SERVICE_ERROR_AUTHENTICATION_REQUIRED will be returned.

The stream returned by this function should be written to using the standard #GOutputStream methods, asychronously or synchronously. Once the stream
is closed (using g_output_stream_close()), gdata_youtube_service_finish_video_upload() should be called on it to parse and return the updated
#GDataYouTubeVideo for the uploaded video. This must be done, as @video isn't updated in-place.

In order to cancel the upload, a #GCancellable passed in to @cancellable must be cancelled using g_cancellable_cancel(). Cancelling the individual
#GOutputStream operations on the #GDataUploadStream will not cancel the entire upload; merely the write or close operation in question. See the
#GDataUploadStream:cancellable for more details.

Any upload errors will be thrown by the stream methods, and may come from the #GDataServiceError domain.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a #GDataUploadStream to write the video data to, or %NULL; unref with g_object_unref()</doc>
          <type name="UploadStream" c:type="GDataUploadStream*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeService</doc>
            <type name="YouTubeService" c:type="GDataYouTubeService*"/>
          </instance-parameter>
          <parameter name="video" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo to insert</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </parameter>
          <parameter name="slug" transfer-ownership="none">
            <doc xml:space="preserve">the filename to give to the uploaded file</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="content_type" transfer-ownership="none">
            <doc xml:space="preserve">the content type of the uploaded data</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a #GCancellable for the entire upload stream, or %NULL</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <property name="developer-key"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The developer key your application has registered with the YouTube API. For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/registering_an_application"&gt;online documentation&lt;/ulink&gt;.

With the port from v2 to v3 of the YouTube API in libgdata
0.17.0, it might be necessary to update your application’s
developer key.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Service" c:type="GDataService"/>
      </field>
      <field name="priv">
        <type name="YouTubeServicePrivate"
              c:type="GDataYouTubeServicePrivate*"/>
      </field>
    </class>
    <record name="YouTubeServiceClass"
            c:type="GDataYouTubeServiceClass"
            glib:is-gtype-struct-for="YouTubeService">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeServiceClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ServiceClass" c:type="GDataServiceClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved2" introspectable="0">
        <callback name="_g_reserved2">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved3" introspectable="0">
        <callback name="_g_reserved3">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved4" introspectable="0">
        <callback name="_g_reserved4">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved5" introspectable="0">
        <callback name="_g_reserved5">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <enumeration name="YouTubeServiceError"
                 glib:type-name="GDataYouTubeServiceError"
                 glib:get-type="gdata_youtube_service_error_get_type"
                 c:type="GDataYouTubeServiceError"
                 glib:error-domain="gdata-youtube-service-error-quark">
      <doc xml:space="preserve">Error codes for #GDataYouTubeService operations.</doc>
      <member name="api_quota_exceeded"
              value="0"
              c:identifier="GDATA_YOUTUBE_SERVICE_ERROR_API_QUOTA_EXCEEDED"
              glib:nick="api-quota-exceeded">
        <doc xml:space="preserve">the API request quota for this developer account has been exceeded</doc>
      </member>
      <member name="entry_quota_exceeded"
              value="1"
              c:identifier="GDATA_YOUTUBE_SERVICE_ERROR_ENTRY_QUOTA_EXCEEDED"
              glib:nick="entry-quota-exceeded">
        <doc xml:space="preserve">the entry (e.g. video) quota for this user account has been exceeded</doc>
      </member>
      <member name="channel_required"
              value="2"
              c:identifier="GDATA_YOUTUBE_SERVICE_ERROR_CHANNEL_REQUIRED"
              glib:nick="channel-required">
        <doc xml:space="preserve">the currently authenticated user doesn't have a YouTube channel, but the current action requires one;
if this error is received, inform the user that they need a YouTube channel, and provide a link to
&lt;ulink type="http" url="https://www.youtube.com/create_channel"&gt;https://www.youtube.com/create_channel&lt;/ulink&gt;</doc>
      </member>
      <function name="quark" c:identifier="gdata_youtube_service_error_quark">
        <return-value transfer-ownership="none">
          <type name="GLib.Quark" c:type="GQuark"/>
        </return-value>
      </function>
    </enumeration>
    <record name="YouTubeServicePrivate"
            c:type="GDataYouTubeServicePrivate"
            disguised="1">
    </record>
    <enumeration name="YouTubeSortOrder"
                 version="0.3.0"
                 deprecated="1"
                 deprecated-version="0.17.0"
                 glib:type-name="GDataYouTubeSortOrder"
                 glib:get-type="gdata_youtube_sort_order_get_type"
                 c:type="GDataYouTubeSortOrder">
      <doc xml:space="preserve">Sort orders for the search results from queries. They specify the order of the designated order field.</doc>
      <doc-deprecated xml:space="preserve">No longer supported by Google. There is no
  replacement.</doc-deprecated>
      <member name="none"
              value="0"
              c:identifier="GDATA_YOUTUBE_SORT_NONE"
              glib:nick="none">
        <doc xml:space="preserve">do not explicitly sort in any sense</doc>
      </member>
      <member name="ascending"
              value="1"
              c:identifier="GDATA_YOUTUBE_SORT_ASCENDING"
              glib:nick="ascending">
        <doc xml:space="preserve">sort results in ascending order of the order field</doc>
      </member>
      <member name="descending"
              value="2"
              c:identifier="GDATA_YOUTUBE_SORT_DESCENDING"
              glib:nick="descending">
        <doc xml:space="preserve">sort results in descending order of the order field</doc>
      </member>
    </enumeration>
    <enumeration name="YouTubeStandardFeedType"
                 glib:type-name="GDataYouTubeStandardFeedType"
                 glib:get-type="gdata_youtube_standard_feed_type_get_type"
                 c:type="GDataYouTubeStandardFeedType">
      <doc xml:space="preserve">Standard feed types for standard feed queries with
gdata_youtube_service_query_standard_feed(). For more information, see the
&lt;ulink type="http" url="https://developers.google.com/youtube/2.0/developers_guide_protocol_video_feeds#Standard_feeds"&gt;online
documentation&lt;/ulink&gt;.</doc>
      <member name="top_rated_feed"
              value="0"
              c:identifier="GDATA_YOUTUBE_TOP_RATED_FEED"
              glib:nick="top-rated-feed">
        <doc xml:space="preserve">This feed contains the most highly rated
  YouTube videos. Deprecated: 0.17.0: Google no longer supports this feed
  type, and it will return results equivalent to
  %GDATA_YOUTUBE_MOST_POPULAR_FEED.</doc>
      </member>
      <member name="top_favorites_feed"
              value="1"
              c:identifier="GDATA_YOUTUBE_TOP_FAVORITES_FEED"
              glib:nick="top-favorites-feed">
        <doc xml:space="preserve">This feed contains videos most frequently
  flagged as favorite videos. Deprecated: 0.17.0: Google no longer
  supports this feed type, and it will return results equivalent to
  %GDATA_YOUTUBE_MOST_POPULAR_FEED.</doc>
      </member>
      <member name="most_viewed_feed"
              value="2"
              c:identifier="GDATA_YOUTUBE_MOST_VIEWED_FEED"
              glib:nick="most-viewed-feed">
        <doc xml:space="preserve">This feed contains the most frequently
  watched YouTube videos. Deprecated: 0.17.0: Google no longer supports
  this feed type, and it will return results equivalent to
  %GDATA_YOUTUBE_MOST_POPULAR_FEED.</doc>
      </member>
      <member name="most_popular_feed"
              value="3"
              c:identifier="GDATA_YOUTUBE_MOST_POPULAR_FEED"
              glib:nick="most-popular-feed">
        <doc xml:space="preserve">This feed contains the most popular YouTube
  videos, selected using an algorithm that combines many different signals to
  determine overall popularity. As of version 0.17.0, this is the only
  supported feed type.</doc>
      </member>
      <member name="most_recent_feed"
              value="4"
              c:identifier="GDATA_YOUTUBE_MOST_RECENT_FEED"
              glib:nick="most-recent-feed">
        <doc xml:space="preserve">This feed contains the videos most recently
  submitted to YouTube. Deprecated: 0.17.0: Google no longer supports
  this feed type, and it will return results equivalent to
  %GDATA_YOUTUBE_MOST_POPULAR_FEED.</doc>
      </member>
      <member name="most_discussed_feed"
              value="5"
              c:identifier="GDATA_YOUTUBE_MOST_DISCUSSED_FEED"
              glib:nick="most-discussed-feed">
        <doc xml:space="preserve">This feed contains the YouTube videos
  that have received the most comments. Deprecated: 0.17.0: Google no
  longer supports this feed type, and it will return results equivalent to
  %GDATA_YOUTUBE_MOST_POPULAR_FEED.</doc>
      </member>
      <member name="most_linked_feed"
              value="6"
              c:identifier="GDATA_YOUTUBE_MOST_LINKED_FEED"
              glib:nick="most-linked-feed">
        <doc xml:space="preserve">This feed contains the YouTube videos that
  receive the most links from other websites. Deprecated: 0.17.0: Google
  no longer supports this feed type, and it will return results equivalent to
  %GDATA_YOUTUBE_MOST_POPULAR_FEED.</doc>
      </member>
      <member name="most_responded_feed"
              value="7"
              c:identifier="GDATA_YOUTUBE_MOST_RESPONDED_FEED"
              glib:nick="most-responded-feed">
        <doc xml:space="preserve">This feed contains YouTube videos that
  receive the most video responses. Deprecated: 0.17.0: Google no longer
  supports this feed type, and it will return results equivalent to
  %GDATA_YOUTUBE_MOST_POPULAR_FEED.</doc>
      </member>
      <member name="recently_featured_feed"
              value="8"
              c:identifier="GDATA_YOUTUBE_RECENTLY_FEATURED_FEED"
              glib:nick="recently-featured-feed">
        <doc xml:space="preserve">This feed contains videos recently
  featured on the YouTube home page or featured videos tab. Deprecated:
  0.17.0: Google no longer supports this feed type, and it will return
  results equivalent to %GDATA_YOUTUBE_MOST_POPULAR_FEED.</doc>
      </member>
      <member name="watch_on_mobile_feed"
              value="9"
              c:identifier="GDATA_YOUTUBE_WATCH_ON_MOBILE_FEED"
              glib:nick="watch-on-mobile-feed">
        <doc xml:space="preserve">This feed contains videos suitable for
  playback on mobile devices. Deprecated: 0.17.0: Google no longer
  supports this feed type, and it will return results equivalent to
  %GDATA_YOUTUBE_MOST_POPULAR_FEED.</doc>
      </member>
    </enumeration>
    <class name="YouTubeState"
           c:symbol-prefix="youtube_state"
           c:type="GDataYouTubeState"
           parent="Parsable"
           glib:type-name="GDataYouTubeState"
           glib:get-type="gdata_youtube_state_get_type"
           glib:type-struct="YouTubeStateClass">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeState structure are private and should never be accessed directly.</doc>
      <method name="get_help_uri"
              c:identifier="gdata_youtube_state_get_help_uri"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeState:help-uri property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the help URI, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeState</doc>
            <type name="YouTubeState" c:type="GDataYouTubeState*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_message"
              c:identifier="gdata_youtube_state_get_message"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeState:message property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the status message, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeState</doc>
            <type name="YouTubeState" c:type="GDataYouTubeState*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_name"
              c:identifier="gdata_youtube_state_get_name"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeState:name property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the status name</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeState</doc>
            <type name="YouTubeState" c:type="GDataYouTubeState*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_reason_code"
              c:identifier="gdata_youtube_state_get_reason_code"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeState:reason-code property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the status reason code, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeState</doc>
            <type name="YouTubeState" c:type="GDataYouTubeState*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="help-uri"
                version="0.4.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A URI for a YouTube Help Center page that may help the developer or the video owner to diagnose
the reason that an upload failed or was rejected.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_yt:state"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="message"
                version="0.4.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">A human-readable description of why the video failed to upload.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_yt:state"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="name"
                version="0.4.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The name of the status of the unpublished video. Valid values are: "processing", "restricted", "deleted", "rejected" and "failed".

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_yt:state"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="reason-code"
                version="0.4.0"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The reason code explaining why the video failed to upload.

For more information, see the
&lt;ulink type="http" url="http://code.google.com/apis/youtube/2.0/reference.html#youtube_data_api_tag_yt:state"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <field name="parent">
        <type name="Parsable" c:type="GDataParsable"/>
      </field>
      <field name="priv">
        <type name="YouTubeStatePrivate" c:type="GDataYouTubeStatePrivate*"/>
      </field>
    </class>
    <record name="YouTubeStateClass"
            c:type="GDataYouTubeStateClass"
            glib:is-gtype-struct-for="YouTubeState"
            version="0.4.0">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeStateClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="ParsableClass" c:type="GDataParsableClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="YouTubeStatePrivate"
            c:type="GDataYouTubeStatePrivate"
            disguised="1">
    </record>
    <enumeration name="YouTubeUploader"
                 version="0.3.0"
                 deprecated="1"
                 deprecated-version="0.17.0"
                 glib:type-name="GDataYouTubeUploader"
                 glib:get-type="gdata_youtube_uploader_get_type"
                 c:type="GDataYouTubeUploader">
      <doc xml:space="preserve">Video uploaders, allowing queries to be limited to returning videos uploaded by YouTube partners.</doc>
      <doc-deprecated xml:space="preserve">No longer supported by Google. There is no
  replacement.</doc-deprecated>
      <member name="all"
              value="0"
              c:identifier="GDATA_YOUTUBE_UPLOADER_ALL"
              glib:nick="all">
        <doc xml:space="preserve">retrieve all videos, regardless of who uploaded them</doc>
      </member>
      <member name="partner"
              value="1"
              c:identifier="GDATA_YOUTUBE_UPLOADER_PARTNER"
              glib:nick="partner">
        <doc xml:space="preserve">retrieve only videos uploaded by YouTube partners</doc>
      </member>
    </enumeration>
    <class name="YouTubeVideo"
           c:symbol-prefix="youtube_video"
           c:type="GDataYouTubeVideo"
           parent="Entry"
           glib:type-name="GDataYouTubeVideo"
           glib:get-type="gdata_youtube_video_get_type"
           glib:type-struct="YouTubeVideoClass">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeVideo structure are private and should never be accessed directly.</doc>
      <implements name="Commentable"/>
      <constructor name="new" c:identifier="gdata_youtube_video_new">
        <doc xml:space="preserve">Creates a new #GDataYouTubeVideo with the given ID and default properties.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GDataYouTubeVideo; unref with g_object_unref()</doc>
          <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
        </return-value>
        <parameters>
          <parameter name="id"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the video's ID, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </constructor>
      <function name="get_video_id_from_uri"
                c:identifier="gdata_youtube_video_get_video_id_from_uri"
                version="0.4.0">
        <doc xml:space="preserve">Extracts a video ID from a YouTube video player URI. The video ID is in the same form as returned by
gdata_youtube_video_get_video_id(), and the @video_uri should be in the same form as returned by
gdata_youtube_video_get_player_uri().

The function will validate whether the URI actually points to a hostname containing &lt;literal&gt;youtube&lt;/literal&gt;
(e.g. &lt;literal&gt;youtube.com&lt;/literal&gt;), and will return %NULL if it doesn't.

For example:
&lt;informalexample&gt;&lt;programlisting&gt;
video_id = gdata_youtube_video_get_video_id_from_uri ("http://www.youtube.com/watch?v=BH_vwsyCrTc&amp;feature=featured");
g_message ("Video ID: %s", video_id); /&lt;!-- --&gt;* Should print: BH_vwsyCrTc *&lt;!-- --&gt;/
g_free (video_id);
&lt;/programlisting&gt;&lt;/informalexample&gt;</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">the video ID, or %NULL; free with g_free()</doc>
          <type name="utf8" c:type="gchar*"/>
        </return-value>
        <parameters>
          <parameter name="video_uri" transfer-ownership="none">
            <doc xml:space="preserve">a YouTube video player URI</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </function>
      <method name="get_access_control"
              c:identifier="gdata_youtube_video_get_access_control"
              version="0.7.0">
        <doc xml:space="preserve">Gets the permission associated with the given @action on the #GDataYouTubeVideo. If the given @action
doesn't have a permission set on the video, %GDATA_YOUTUBE_PERMISSION_DENIED is returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the permission associated with @action, or %GDATA_YOUTUBE_PERMISSION_DENIED</doc>
          <type name="YouTubePermission" c:type="GDataYouTubePermission"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="action" transfer-ownership="none">
            <doc xml:space="preserve">the action whose permission should be returned</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_aspect_ratio"
              c:identifier="gdata_youtube_video_get_aspect_ratio"
              version="0.4.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:aspect-ratio property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the aspect ratio property, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_category"
              c:identifier="gdata_youtube_video_get_category">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:category property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataMediaCategory giving the video's single and mandatory category</doc>
          <type name="MediaCategory" c:type="GDataMediaCategory*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_coordinates"
              c:identifier="gdata_youtube_video_get_coordinates"
              version="0.8.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:latitude and #GDataYouTubeVideo:longitude properties, setting the out parameters to them. If either latitude or
longitude is %NULL, that parameter will not be set. If the coordinates are unset, @latitude and @longitude will be set to %G_MAXDOUBLE.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="latitude"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the latitude, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
          <parameter name="longitude"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the longitude, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_credit"
              c:identifier="gdata_youtube_video_get_credit"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:credit property.</doc>
        <doc-deprecated xml:space="preserve">This is no longer supported by Google, and will
  always return %NULL. There is no replacement.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataMediaCredit giving information on whom to credit for the video, or %NULL</doc>
          <type name="YouTubeCredit" c:type="GDataYouTubeCredit*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_description"
              c:identifier="gdata_youtube_video_get_description">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:description property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the video's long text description, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_duration"
              c:identifier="gdata_youtube_video_get_duration">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:duration property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the video duration in seconds, or &lt;code class="literal"&gt;0&lt;/code&gt; if unknown</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_favorite_count"
              c:identifier="gdata_youtube_video_get_favorite_count">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:favorite-count property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the number of users who have added the video to their favorites list</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_keywords"
              c:identifier="gdata_youtube_video_get_keywords">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:keywords property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a %NULL-terminated array of words associated with the video</doc>
          <array c:type="gchar**">
            <type name="utf8"/>
          </array>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_location"
              c:identifier="gdata_youtube_video_get_location">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:location property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a string describing the video's location, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_media_rating"
              c:identifier="gdata_youtube_video_get_media_rating"
              version="0.10.0">
        <doc xml:space="preserve">Returns the rating of the given type for the video, if one exists. For example, this could be a film rating awarded by the MPAA; or a simple
rating specifying whether the video contains adult content.

The valid values for @rating_type are: %GDATA_YOUTUBE_RATING_TYPE_MPAA and %GDATA_YOUTUBE_RATING_TYPE_V_CHIP.
Further values may be added in future; if an unknown rating type is passed to the function, %NULL will be returned.

The possible return values depend on what's passed to @rating_type. Valid values for each rating type are listed in the documentation for the
rating types.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the rating of the video for the given @rating_type, or %NULL if the video isn't rated with that type (or the type is unknown)</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="rating_type" transfer-ownership="none">
            <doc xml:space="preserve">the type of rating to retrieve</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_player_uri"
              c:identifier="gdata_youtube_video_get_player_uri">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:player-uri property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a URI where the video is playable in a web browser, or %NULL</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_rating" c:identifier="gdata_youtube_video_get_rating">
        <doc xml:space="preserve">Gets various properties of the ratings on the video.

Note that this property may not be retrieved when querying for multiple
videos at once, but is guaranteed to be retrieved when querying with
gdata_service_query_single_entry_async().</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="min"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the minimum rating value, or %NULL</doc>
            <type name="guint" c:type="guint*"/>
          </parameter>
          <parameter name="max"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the maximum rating value, or %NULL</doc>
            <type name="guint" c:type="guint*"/>
          </parameter>
          <parameter name="count"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the number of ratings, or %NULL</doc>
            <type name="guint" c:type="guint*"/>
          </parameter>
          <parameter name="average"
                     direction="out"
                     caller-allocates="1"
                     transfer-ownership="none"
                     optional="1"
                     allow-none="1">
            <doc xml:space="preserve">return location for the average rating value, or %NULL</doc>
            <type name="gdouble" c:type="gdouble*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_recorded"
              c:identifier="gdata_youtube_video_get_recorded"
              version="0.3.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:recorded property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the time the video was recorded, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_state" c:identifier="gdata_youtube_video_get_state">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:state property.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#status.uploadStatus"&gt;online documentation&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataYouTubeState showing the state of the video, or %NULL</doc>
          <type name="YouTubeState" c:type="GDataYouTubeState*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_thumbnails"
              c:identifier="gdata_youtube_video_get_thumbnails">
        <doc xml:space="preserve">Gets a list of the thumbnails available for the video.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GList of #GDataMediaThumbnail&lt;!-- --&gt;s, or %NULL</doc>
          <type name="GLib.List" c:type="GList*">
            <type name="MediaThumbnail"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_uploaded"
              c:identifier="gdata_youtube_video_get_uploaded">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:uploaded property. If the property is unset, &lt;code class="literal"&gt;-1&lt;/code&gt; will be returned.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the UNIX timestamp for the time the video was uploaded, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
          <type name="gint64" c:type="gint64"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_video_id"
              c:identifier="gdata_youtube_video_get_video_id"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:video-id property.</doc>
        <doc-deprecated xml:space="preserve">This is now equal to #GDataEntry:id.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the video's unique and permanent ID</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_view_count"
              c:identifier="gdata_youtube_video_get_view_count">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:view-count property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the number of times the video has been viewed</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_draft"
              c:identifier="gdata_youtube_video_is_draft"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:is-draft property.</doc>
        <doc-deprecated xml:space="preserve">This is now equal to
  gdata_youtube_video_is_private().</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the video is a draft, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_private" c:identifier="gdata_youtube_video_is_private">
        <doc xml:space="preserve">Gets the #GDataYouTubeVideo:is-private property.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the video is private, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="is_restricted_in_country"
              c:identifier="gdata_youtube_video_is_restricted_in_country"
              version="0.4.0">
        <doc xml:space="preserve">Checks whether viewing of the video is restricted in @country, either by its content rating, or by the request of the producer.
The return value from this function is purely informational, and no obligation is assumed.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if the video is restricted in @country, %FALSE otherwise</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="country" transfer-ownership="none">
            <doc xml:space="preserve">an ISO 3166 two-letter country code to check</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="look_up_content"
              c:identifier="gdata_youtube_video_look_up_content"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Looks up a #GDataYouTubeContent from the video with the given MIME type. The video's list of contents is
a list of URIs to various formats of the video itself, such as its SWF URI or RTSP stream.</doc>
        <doc-deprecated xml:space="preserve">This is no longer supported by Google, and will
  always return %NULL. To view a video, open the URI returned by
  gdata_youtube_video_get_player_uri() in a web browser.</doc-deprecated>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GDataYouTubeContent matching @type, or %NULL</doc>
          <type name="YouTubeContent" c:type="GDataYouTubeContent*"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="type" transfer-ownership="none">
            <doc xml:space="preserve">the MIME type of the content desired</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_access_control"
              c:identifier="gdata_youtube_video_set_access_control"
              version="0.7.0">
        <doc xml:space="preserve">Sets the permission associated with @action on the #GDataYouTubeVideo, allowing restriction or derestriction of various
operations on YouTube videos.

Note that only %GDATA_YOUTUBE_ACTION_RATE and %GDATA_YOUTUBE_ACTION_COMMENT actions can have the %GDATA_YOUTUBE_PERMISSION_MODERATED permission.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="action" transfer-ownership="none">
            <doc xml:space="preserve">the action whose permission is being set</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="permission" transfer-ownership="none">
            <doc xml:space="preserve">the permission to give to the action</doc>
            <type name="YouTubePermission" c:type="GDataYouTubePermission"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_aspect_ratio"
              c:identifier="gdata_youtube_video_set_aspect_ratio"
              version="0.4.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeVideo:aspect-ratio property to specify the video's aspect ratio.
If @aspect_ratio is %NULL, the property will be unset.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="aspect_ratio"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the aspect ratio property, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_category"
              c:identifier="gdata_youtube_video_set_category">
        <doc xml:space="preserve">Sets the #GDataYouTubeVideo:category property to the new category, @category, and increments its reference count.

@category must not be %NULL. For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#snippet.categoryId"&gt;online documentation&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="category" transfer-ownership="none">
            <doc xml:space="preserve">a new #GDataMediaCategory</doc>
            <type name="MediaCategory" c:type="GDataMediaCategory*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_coordinates"
              c:identifier="gdata_youtube_video_set_coordinates"
              version="0.8.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeVideo:latitude and #GDataYouTubeVideo:longitude properties to @latitude and @longitude respectively.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="latitude" transfer-ownership="none">
            <doc xml:space="preserve">the video's new latitude coordinate, or %G_MAXDOUBLE</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
          <parameter name="longitude" transfer-ownership="none">
            <doc xml:space="preserve">the video's new longitude coordinate, or %G_MAXDOUBLE</doc>
            <type name="gdouble" c:type="gdouble"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_description"
              c:identifier="gdata_youtube_video_set_description">
        <doc xml:space="preserve">Sets the #GDataYouTubeVideo:description property to the new description, @description.

Set @description to %NULL to unset the video's description.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="description"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the video's new description, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_draft"
              c:identifier="gdata_youtube_video_set_is_draft"
              deprecated="1"
              deprecated-version="0.17.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeVideo:is-draft property to decide whether the video is a draft.</doc>
        <doc-deprecated xml:space="preserve">This is now equivalent to
  gdata_youtube_video_set_is_private().</doc-deprecated>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="is_draft" transfer-ownership="none">
            <doc xml:space="preserve">whether the video is a draft</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_is_private"
              c:identifier="gdata_youtube_video_set_is_private">
        <doc xml:space="preserve">Sets the #GDataYouTubeVideo:is-private property to decide whether the video is publicly viewable.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="is_private" transfer-ownership="none">
            <doc xml:space="preserve">whether the video is private</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_keywords"
              c:identifier="gdata_youtube_video_set_keywords">
        <doc xml:space="preserve">Sets the #GDataYouTubeVideo:keywords property to the new keyword list, @keywords.

@keywords must not be %NULL. For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#snippet.tags[]"&gt;online documentation&lt;/ulink&gt;.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="keywords" transfer-ownership="none">
            <doc xml:space="preserve">a new %NULL-terminated array of keywords</doc>
            <array c:type="gchar**">
              <type name="utf8" c:type="gchar*"/>
            </array>
          </parameter>
        </parameters>
      </method>
      <method name="set_location"
              c:identifier="gdata_youtube_video_set_location">
        <doc xml:space="preserve">Sets the #GDataYouTubeVideo:location property to the new location string, @location.

Set @location to %NULL to unset the property in the video.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="location"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a new location, or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_recorded"
              c:identifier="gdata_youtube_video_set_recorded"
              version="0.3.0">
        <doc xml:space="preserve">Sets the #GDataYouTubeVideo:recorded property to the new recorded time, @recorded.

Set @recorded to &lt;code class="literal"&gt;-1&lt;/code&gt; to unset the video's recorded time.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="self" transfer-ownership="none">
            <doc xml:space="preserve">a #GDataYouTubeVideo</doc>
            <type name="YouTubeVideo" c:type="GDataYouTubeVideo*"/>
          </instance-parameter>
          <parameter name="recorded" transfer-ownership="none">
            <doc xml:space="preserve">the video's new recorded time, or &lt;code class="literal"&gt;-1&lt;/code&gt;</doc>
            <type name="gint64" c:type="gint64"/>
          </parameter>
        </parameters>
      </method>
      <property name="aspect-ratio"
                version="0.4.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The aspect ratio of the video. A %NULL value means the aspect ratio is unknown (it could still be a widescreen video). A value of
%GDATA_YOUTUBE_ASPECT_RATIO_WIDESCREEN means the video is definitely widescreen.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="average-rating" transfer-ownership="none">
        <doc xml:space="preserve">The average rating of the video, over all the ratings it's received.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#statistics.likeCount"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="category" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">Specifies a genre or developer tag that describes the video.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#snippet.categoryId"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="MediaCategory"/>
      </property>
      <property name="credit"
                deprecated="1"
                deprecated-version="0.17.0"
                transfer-ownership="none">
        <doc xml:space="preserve">Identifies the owner of the video.</doc>
        <doc-deprecated xml:space="preserve">This is no longer supported by Google, and
  will always be %NULL. There is no replacement.</doc-deprecated>
        <type name="YouTubeCredit"/>
      </property>
      <property name="description" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">A summary or description of the video.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#snippet.description"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="duration" transfer-ownership="none">
        <doc xml:space="preserve">The duration of the video in seconds.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#contentDetails.duration"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="favorite-count" transfer-ownership="none">
        <doc xml:space="preserve">The number of users who have added the video to their favorites.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#statistics.favoriteCount"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="is-draft"
                deprecated="1"
                deprecated-version="0.17.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Indicates whether the video is in draft, or unpublished, status.</doc>
        <doc-deprecated xml:space="preserve">This is now equal to
  #GDataYouTubeVideo:is-private.</doc-deprecated>
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="is-private" writable="1" transfer-ownership="none">
        <type name="gboolean" c:type="gboolean"/>
      </property>
      <property name="keywords" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">A %NULL-terminated array of words associated with the video.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#snippet.tags[]"&gt;online documentation&lt;/ulink&gt;.</doc>
        <array>
          <type name="utf8"/>
        </array>
      </property>
      <property name="latitude"
                version="0.8.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The location as a latitude coordinate associated with this video. Valid latitudes range from &lt;code class="literal"&gt;-90.0&lt;/code&gt;
to &lt;code class="literal"&gt;90.0&lt;/code&gt; inclusive. Set to a value
outside this range to unset the location.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/youtube/v3/docs/videos#recordingDetails.location.latitude"&gt;
online documentation&lt;/ulink&gt;.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="location" writable="1" transfer-ownership="none">
        <doc xml:space="preserve">Descriptive text about the location where the video was taken.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#recordingDetails.locationDescription"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="longitude"
                version="0.8.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">The location as a longitude coordinate associated with this video. Valid longitudes range from &lt;code class="literal"&gt;-180.0&lt;/code&gt;
to &lt;code class="literal"&gt;180.0&lt;/code&gt; inclusive. Set to a value
outside this range to unset the location.

For more information, see the
&lt;ulink type="http" url="https://developers.google.com/youtube/v3/docs/videos#recordingDetails.location.longitude"&gt;
online documentation&lt;/ulink&gt;.</doc>
        <type name="gdouble" c:type="gdouble"/>
      </property>
      <property name="max-rating" transfer-ownership="none">
        <doc xml:space="preserve">The maximum allowed rating for the video.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#statistics.likeCount"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="min-rating" transfer-ownership="none">
        <doc xml:space="preserve">The minimum allowed rating for the video.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#statistics.likeCount"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="player-uri" transfer-ownership="none">
        <doc xml:space="preserve">A URI for a browser-based media player for the full-length video (i.e. the video's page on YouTube).</doc>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="rating-count" transfer-ownership="none">
        <doc xml:space="preserve">The number of times the video has been rated.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#statistics.likeCount"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <property name="recorded"
                version="0.3.0"
                writable="1"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies the time the video was originally recorded.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#recordingDetails.recordingDate"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="state" transfer-ownership="none">
        <doc xml:space="preserve">Information describing the state of the video. If this is non-%NULL, the video is not playable.
It points to a #GDataYouTubeState.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#status.uploadStatus"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="YouTubeState"/>
      </property>
      <property name="uploaded" transfer-ownership="none">
        <doc xml:space="preserve">Specifies the time the video was originally uploaded to YouTube.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#snippet.publishedAt"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="gint64" c:type="gint64"/>
      </property>
      <property name="video-id"
                deprecated="1"
                deprecated-version="0.17.0"
                transfer-ownership="none">
        <doc xml:space="preserve">Specifies a unique ID which YouTube uses to identify the video. For example: &lt;literal&gt;qz8EfkS4KK0&lt;/literal&gt;.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#id"&gt;online documentation&lt;/ulink&gt;.</doc>
        <doc-deprecated xml:space="preserve">This is now equal to #GDataEntry:id.</doc-deprecated>
        <type name="utf8" c:type="gchar*"/>
      </property>
      <property name="view-count" transfer-ownership="none">
        <doc xml:space="preserve">The number of times the video has been viewed.

For more information, see the &lt;ulink type="http"
url="https://developers.google.com/youtube/v3/docs/videos#statistics.viewCount"&gt;online documentation&lt;/ulink&gt;.</doc>
        <type name="guint" c:type="guint"/>
      </property>
      <field name="parent">
        <type name="Entry" c:type="GDataEntry"/>
      </field>
      <field name="priv">
        <type name="YouTubeVideoPrivate" c:type="GDataYouTubeVideoPrivate*"/>
      </field>
    </class>
    <record name="YouTubeVideoClass"
            c:type="GDataYouTubeVideoClass"
            glib:is-gtype-struct-for="YouTubeVideo">
      <doc xml:space="preserve">All the fields in the #GDataYouTubeVideoClass structure are private and should never be accessed directly.</doc>
      <field name="parent" readable="0" private="1">
        <type name="EntryClass" c:type="GDataEntryClass"/>
      </field>
      <field name="_g_reserved0" introspectable="0">
        <callback name="_g_reserved0">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
      <field name="_g_reserved1" introspectable="0">
        <callback name="_g_reserved1">
          <return-value transfer-ownership="none">
            <type name="none" c:type="void"/>
          </return-value>
        </callback>
      </field>
    </record>
    <record name="YouTubeVideoPrivate"
            c:type="GDataYouTubeVideoPrivate"
            disguised="1">
    </record>
    <function name="client_login_authorizer_error_quark"
              c:identifier="gdata_client_login_authorizer_error_quark"
              moved-to="ClientLoginAuthorizerError.quark">
      <return-value transfer-ownership="none">
        <type name="GLib.Quark" c:type="GQuark"/>
      </return-value>
    </function>
    <function name="color_from_hexadecimal"
              c:identifier="gdata_color_from_hexadecimal"
              moved-to="Color.from_hexadecimal">
      <doc xml:space="preserve">Parses @hexadecimal and returns a #GDataColor describing it in @color.

@hexadecimal should be in the form &lt;literal&gt;#&lt;replaceable&gt;rr&lt;/replaceable&gt;&lt;replaceable&gt;gg&lt;/replaceable&gt;&lt;replaceable&gt;bb&lt;/replaceable&gt;&lt;/literal&gt;,
where &lt;replaceable&gt;rr&lt;/replaceable&gt; is a two-digit hexadecimal red intensity value, &lt;replaceable&gt;gg&lt;/replaceable&gt; is green
and &lt;replaceable&gt;bb&lt;/replaceable&gt; is blue. The hash is optional.</doc>
      <return-value transfer-ownership="none">
        <doc xml:space="preserve">%TRUE on success, %FALSE otherwise</doc>
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="hexadecimal" transfer-ownership="none">
          <doc xml:space="preserve">a hexadecimal color string</doc>
          <type name="utf8" c:type="const gchar*"/>
        </parameter>
        <parameter name="color"
                   direction="out"
                   caller-allocates="1"
                   transfer-ownership="none">
          <doc xml:space="preserve">a #GDataColor</doc>
          <type name="Color" c:type="GDataColor*"/>
        </parameter>
      </parameters>
    </function>
    <function name="documents_service_error_quark"
              c:identifier="gdata_documents_service_error_quark"
              moved-to="DocumentsServiceError.quark">
      <return-value transfer-ownership="none">
        <type name="GLib.Quark" c:type="GQuark"/>
      </return-value>
    </function>
    <function name="parser_error_quark"
              c:identifier="gdata_parser_error_quark"
              moved-to="ParserError.quark">
      <return-value transfer-ownership="none">
        <type name="GLib.Quark" c:type="GQuark"/>
      </return-value>
    </function>
    <function name="service_error_quark"
              c:identifier="gdata_service_error_quark"
              moved-to="ServiceError.quark">
      <return-value transfer-ownership="none">
        <type name="GLib.Quark" c:type="GQuark"/>
      </return-value>
    </function>
    <function name="youtube_service_error_quark"
              c:identifier="gdata_youtube_service_error_quark"
              moved-to="YouTubeServiceError.quark">
      <return-value transfer-ownership="none">
        <type name="GLib.Quark" c:type="GQuark"/>
      </return-value>
    </function>
  </namespace>
</repository>