<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GDataContactsContact: GData Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GData Reference Manual">
<link rel="up" href="ch15.html" title="Google Contacts API">
<link rel="prev" href="GDataContactsQuery.html" title="GDataContactsQuery">
<link rel="next" href="GDataContactsGroup.html" title="GDataContactsGroup">
<meta name="generator" content="GTK-Doc V1.26.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
<a href="#GDataContactsContact.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
<a href="#GDataContactsContact.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span>
<a href="#GDataContactsContact.properties" class="shortcut">Properties</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="ch15.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GDataContactsQuery.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GDataContactsGroup.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GDataContactsContact"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GDataContactsContact.top_of_page"></a>GDataContactsContact</span></h2>
<p>GDataContactsContact — GData Contacts contact object</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GDataContactsContact.stability-level"></a><h2>Stability Level</h2>
<acronym title="The intention of a Stable interface is to enable arbitrary third parties to
develop applications to these interfaces, release them, and have confidence that
they will run on all minor releases of the product (after the one in which the
interface was introduced, and within the same major release). Even at a major
release, incompatible changes are expected to be rare, and to have strong
justifications.
"><span class="acronym">Stable</span></acronym>, unless otherwise indicated
</div>
<div class="refsect1">
<a name="GDataContactsContact.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="returnvalue">GDataContactsContact</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-new" title="gdata_contacts_contact_new ()">gdata_contacts_contact_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GDataGDName.html" title="GDataGDName"><span class="returnvalue">GDataGDName</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-name" title="gdata_contacts_contact_get_name ()">gdata_contacts_contact_get_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-name" title="gdata_contacts_contact_set_name ()">gdata_contacts_contact_set_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-short-name" title="gdata_contacts_contact_get_short_name ()">gdata_contacts_contact_get_short_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-short-name" title="gdata_contacts_contact_set_short_name ()">gdata_contacts_contact_set_short_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-initials" title="gdata_contacts_contact_get_initials ()">gdata_contacts_contact_get_initials</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-initials" title="gdata_contacts_contact_set_initials ()">gdata_contacts_contact_set_initials</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-maiden-name" title="gdata_contacts_contact_get_maiden_name ()">gdata_contacts_contact_get_maiden_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-maiden-name" title="gdata_contacts_contact_set_maiden_name ()">gdata_contacts_contact_set_maiden_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-nickname" title="gdata_contacts_contact_get_nickname ()">gdata_contacts_contact_get_nickname</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-nickname" title="gdata_contacts_contact_set_nickname ()">gdata_contacts_contact_set_nickname</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-file-as" title="gdata_contacts_contact_get_file_as ()">gdata_contacts_contact_get_file_as</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-file-as" title="gdata_contacts_contact_set_file_as ()">gdata_contacts_contact_set_file_as</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-birthday" title="gdata_contacts_contact_get_birthday ()">gdata_contacts_contact_get_birthday</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-birthday" title="gdata_contacts_contact_set_birthday ()">gdata_contacts_contact_set_birthday</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-gender" title="gdata_contacts_contact_get_gender ()">gdata_contacts_contact_get_gender</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-gender" title="gdata_contacts_contact_set_gender ()">gdata_contacts_contact_set_gender</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-mileage" title="gdata_contacts_contact_get_mileage ()">gdata_contacts_contact_get_mileage</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-mileage" title="gdata_contacts_contact_set_mileage ()">gdata_contacts_contact_set_mileage</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-occupation" title="gdata_contacts_contact_get_occupation ()">gdata_contacts_contact_get_occupation</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-occupation" title="gdata_contacts_contact_set_occupation ()">gdata_contacts_contact_set_occupation</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-subject" title="gdata_contacts_contact_get_subject ()">gdata_contacts_contact_get_subject</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-subject" title="gdata_contacts_contact_set_subject ()">gdata_contacts_contact_set_subject</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-priority" title="gdata_contacts_contact_get_priority ()">gdata_contacts_contact_get_priority</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-priority" title="gdata_contacts_contact_set_priority ()">gdata_contacts_contact_set_priority</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-sensitivity" title="gdata_contacts_contact_get_sensitivity ()">gdata_contacts_contact_get_sensitivity</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-sensitivity" title="gdata_contacts_contact_set_sensitivity ()">gdata_contacts_contact_set_sensitivity</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-directory-server" title="gdata_contacts_contact_get_directory_server ()">gdata_contacts_contact_get_directory_server</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-directory-server" title="gdata_contacts_contact_set_directory_server ()">gdata_contacts_contact_set_directory_server</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-billing-information" title="gdata_contacts_contact_get_billing_information ()">gdata_contacts_contact_get_billing_information</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-billing-information" title="gdata_contacts_contact_set_billing_information ()">gdata_contacts_contact_set_billing_information</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-email-addresses" title="gdata_contacts_contact_get_email_addresses ()">gdata_contacts_contact_get_email_addresses</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GDataGDEmailAddress.html" title="GDataGDEmailAddress"><span class="returnvalue">GDataGDEmailAddress</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-primary-email-address" title="gdata_contacts_contact_get_primary_email_address ()">gdata_contacts_contact_get_primary_email_address</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-email-address" title="gdata_contacts_contact_add_email_address ()">gdata_contacts_contact_add_email_address</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-email-addresses" title="gdata_contacts_contact_remove_all_email_addresses ()">gdata_contacts_contact_remove_all_email_addresses</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-im-addresses" title="gdata_contacts_contact_get_im_addresses ()">gdata_contacts_contact_get_im_addresses</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GDataGDIMAddress.html" title="GDataGDIMAddress"><span class="returnvalue">GDataGDIMAddress</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-primary-im-address" title="gdata_contacts_contact_get_primary_im_address ()">gdata_contacts_contact_get_primary_im_address</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-im-address" title="gdata_contacts_contact_add_im_address ()">gdata_contacts_contact_add_im_address</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-im-addresses" title="gdata_contacts_contact_remove_all_im_addresses ()">gdata_contacts_contact_remove_all_im_addresses</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-postal-addresses" title="gdata_contacts_contact_get_postal_addresses ()">gdata_contacts_contact_get_postal_addresses</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GDataGDPostalAddress.html" title="GDataGDPostalAddress"><span class="returnvalue">GDataGDPostalAddress</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-primary-postal-address" title="gdata_contacts_contact_get_primary_postal_address ()">gdata_contacts_contact_get_primary_postal_address</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-postal-address" title="gdata_contacts_contact_add_postal_address ()">gdata_contacts_contact_add_postal_address</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-postal-addresses" title="gdata_contacts_contact_remove_all_postal_addresses ()">gdata_contacts_contact_remove_all_postal_addresses</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-phone-numbers" title="gdata_contacts_contact_get_phone_numbers ()">gdata_contacts_contact_get_phone_numbers</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GDataGDPhoneNumber.html" title="GDataGDPhoneNumber"><span class="returnvalue">GDataGDPhoneNumber</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-primary-phone-number" title="gdata_contacts_contact_get_primary_phone_number ()">gdata_contacts_contact_get_primary_phone_number</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-phone-number" title="gdata_contacts_contact_add_phone_number ()">gdata_contacts_contact_add_phone_number</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-phone-numbers" title="gdata_contacts_contact_remove_all_phone_numbers ()">gdata_contacts_contact_remove_all_phone_numbers</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-organizations" title="gdata_contacts_contact_get_organizations ()">gdata_contacts_contact_get_organizations</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GDataGDOrganization.html" title="GDataGDOrganization"><span class="returnvalue">GDataGDOrganization</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-primary-organization" title="gdata_contacts_contact_get_primary_organization ()">gdata_contacts_contact_get_primary_organization</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-organization" title="gdata_contacts_contact_add_organization ()">gdata_contacts_contact_add_organization</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-organizations" title="gdata_contacts_contact_remove_all_organizations ()">gdata_contacts_contact_remove_all_organizations</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-jot" title="gdata_contacts_contact_add_jot ()">gdata_contacts_contact_add_jot</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-jots" title="gdata_contacts_contact_get_jots ()">gdata_contacts_contact_get_jots</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-jots" title="gdata_contacts_contact_remove_all_jots ()">gdata_contacts_contact_remove_all_jots</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-relation" title="gdata_contacts_contact_add_relation ()">gdata_contacts_contact_add_relation</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-relations" title="gdata_contacts_contact_get_relations ()">gdata_contacts_contact_get_relations</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-relations" title="gdata_contacts_contact_remove_all_relations ()">gdata_contacts_contact_remove_all_relations</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-website" title="gdata_contacts_contact_add_website ()">gdata_contacts_contact_add_website</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-websites" title="gdata_contacts_contact_get_websites ()">gdata_contacts_contact_get_websites</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GDataGContactWebsite.html" title="GDataGContactWebsite"><span class="returnvalue">GDataGContactWebsite</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-primary-website" title="gdata_contacts_contact_get_primary_website ()">gdata_contacts_contact_get_primary_website</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-websites" title="gdata_contacts_contact_remove_all_websites ()">gdata_contacts_contact_remove_all_websites</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-event" title="gdata_contacts_contact_add_event ()">gdata_contacts_contact_add_event</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-events" title="gdata_contacts_contact_get_events ()">gdata_contacts_contact_get_events</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-events" title="gdata_contacts_contact_remove_all_events ()">gdata_contacts_contact_remove_all_events</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-calendar" title="gdata_contacts_contact_add_calendar ()">gdata_contacts_contact_add_calendar</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-calendars" title="gdata_contacts_contact_get_calendars ()">gdata_contacts_contact_get_calendars</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GDataGContactCalendar.html" title="GDataGContactCalendar"><span class="returnvalue">GDataGContactCalendar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-primary-calendar" title="gdata_contacts_contact_get_primary_calendar ()">gdata_contacts_contact_get_primary_calendar</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-calendars" title="gdata_contacts_contact_remove_all_calendars ()">gdata_contacts_contact_remove_all_calendars</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-external-id" title="gdata_contacts_contact_add_external_id ()">gdata_contacts_contact_add_external_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-external-ids" title="gdata_contacts_contact_get_external_ids ()">gdata_contacts_contact_get_external_ids</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-external-ids" title="gdata_contacts_contact_remove_all_external_ids ()">gdata_contacts_contact_remove_all_external_ids</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-hobby" title="gdata_contacts_contact_add_hobby ()">gdata_contacts_contact_add_hobby</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-hobbies" title="gdata_contacts_contact_get_hobbies ()">gdata_contacts_contact_get_hobbies</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-hobbies" title="gdata_contacts_contact_remove_all_hobbies ()">gdata_contacts_contact_remove_all_hobbies</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-language" title="gdata_contacts_contact_add_language ()">gdata_contacts_contact_add_language</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-languages" title="gdata_contacts_contact_get_languages ()">gdata_contacts_contact_get_languages</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-all-languages" title="gdata_contacts_contact_remove_all_languages ()">gdata_contacts_contact_remove_all_languages</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-groups" title="gdata_contacts_contact_get_groups ()">gdata_contacts_contact_get_groups</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-add-group" title="gdata_contacts_contact_add_group ()">gdata_contacts_contact_add_group</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-group" title="gdata_contacts_contact_remove_group ()">gdata_contacts_contact_remove_group</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-is-group-deleted" title="gdata_contacts_contact_is_group_deleted ()">gdata_contacts_contact_is_group_deleted</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-extended-property" title="gdata_contacts_contact_get_extended_property ()">gdata_contacts_contact_get_extended_property</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-extended-properties" title="gdata_contacts_contact_get_extended_properties ()">gdata_contacts_contact_get_extended_properties</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-extended-property" title="gdata_contacts_contact_set_extended_property ()">gdata_contacts_contact_set_extended_property</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-user-defined-field" title="gdata_contacts_contact_get_user_defined_field ()">gdata_contacts_contact_get_user_defined_field</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-user-defined-fields" title="gdata_contacts_contact_get_user_defined_fields ()">gdata_contacts_contact_get_user_defined_fields</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-user-defined-field" title="gdata_contacts_contact_set_user_defined_field ()">gdata_contacts_contact_set_user_defined_field</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-edited" title="gdata_contacts_contact_get_edited ()">gdata_contacts_contact_get_edited</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-is-deleted" title="gdata_contacts_contact_is_deleted ()">gdata_contacts_contact_is_deleted</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo-etag" title="gdata_contacts_contact_get_photo_etag ()">gdata_contacts_contact_get_photo_etag</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#guint8"><span class="returnvalue">guint8</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo" title="gdata_contacts_contact_get_photo ()">gdata_contacts_contact_get_photo</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo-async" title="gdata_contacts_contact_get_photo_async ()">gdata_contacts_contact_get_photo_async</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#guint8"><span class="returnvalue">guint8</span></a> *
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo-finish" title="gdata_contacts_contact_get_photo_finish ()">gdata_contacts_contact_get_photo_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-photo" title="gdata_contacts_contact_set_photo ()">gdata_contacts_contact_set_photo</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-photo-async" title="gdata_contacts_contact_set_photo_async ()">gdata_contacts_contact_set_photo_async</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-photo-finish" title="gdata_contacts_contact_set_photo_finish ()">gdata_contacts_contact_set_photo_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GDataContactsContact.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--billing-information" title="The “billing-information” property">billing-information</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--birthday" title="The “birthday” property">birthday</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--birthday-has-year" title="The “birthday-has-year” property">birthday-has-year</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--deleted" title="The “deleted” property">deleted</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--directory-server" title="The “directory-server” property">directory-server</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a></td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--edited" title="The “edited” property">edited</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--file-as" title="The “file-as” property">file-as</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--gender" title="The “gender” property">gender</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--initials" title="The “initials” property">initials</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--maiden-name" title="The “maiden-name” property">maiden-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--mileage" title="The “mileage” property">mileage</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GDataGDName.html" title="GDataGDName"><span class="type">GDataGDName</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--name" title="The “name” property">name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--nickname" title="The “nickname” property">nickname</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--occupation" title="The “occupation” property">occupation</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--photo-etag" title="The “photo-etag” property">photo-etag</a></td>
<td class="property_flags">Read</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--priority" title="The “priority” property">priority</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--sensitivity" title="The “sensitivity” property">sensitivity</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--short-name" title="The “short-name” property">short-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td>
<td class="property_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact--subject" title="The “subject” property">subject</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GDataContactsContact.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-GENDER-MALE:CAPS" title="GDATA_CONTACTS_GENDER_MALE">GDATA_CONTACTS_GENDER_MALE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-GENDER-FEMALE:CAPS" title="GDATA_CONTACTS_GENDER_FEMALE">GDATA_CONTACTS_GENDER_FEMALE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-PRIORITY-LOW:CAPS" title="GDATA_CONTACTS_PRIORITY_LOW">GDATA_CONTACTS_PRIORITY_LOW</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-PRIORITY-NORMAL:CAPS" title="GDATA_CONTACTS_PRIORITY_NORMAL">GDATA_CONTACTS_PRIORITY_NORMAL</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-PRIORITY-HIGH:CAPS" title="GDATA_CONTACTS_PRIORITY_HIGH">GDATA_CONTACTS_PRIORITY_HIGH</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-SENSITIVITY-CONFIDENTIAL:CAPS" title="GDATA_CONTACTS_SENSITIVITY_CONFIDENTIAL">GDATA_CONTACTS_SENSITIVITY_CONFIDENTIAL</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-SENSITIVITY-NORMAL:CAPS" title="GDATA_CONTACTS_SENSITIVITY_NORMAL">GDATA_CONTACTS_SENSITIVITY_NORMAL</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-SENSITIVITY-PERSONAL:CAPS" title="GDATA_CONTACTS_SENSITIVITY_PERSONAL">GDATA_CONTACTS_SENSITIVITY_PERSONAL</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-SENSITIVITY-PRIVATE:CAPS" title="GDATA_CONTACTS_SENSITIVITY_PRIVATE">GDATA_CONTACTS_SENSITIVITY_PRIVATE</a></td>
</tr>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="GDataContactsContact.html#GDataContactsContact-struct" title="GDataContactsContact">GDataContactsContact</a></td>
</tr>
<tr>
<td class="datatype_keyword"> </td>
<td class="function_name"><a class="link" href="GDataContactsContact.html#GDataContactsContactClass" title="GDataContactsContactClass">GDataContactsContactClass</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GDataContactsContact.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<span class="lineart">╰──</span> <a class="link" href="GDataParsable.html" title="GDataParsable">GDataParsable</a>
<span class="lineart">╰──</span> <a class="link" href="GDataEntry.html" title="GDataEntry">GDataEntry</a>
<span class="lineart">╰──</span> GDataContactsContact
</pre>
</div>
<div class="refsect1">
<a name="GDataContactsContact.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include <gdata/services/contacts/gdata-contacts-contact.h>
</pre>
</div>
<div class="refsect1">
<a name="GDataContactsContact.description"></a><h2>Description</h2>
<p><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> is a subclass of <a class="link" href="GDataEntry.html" title="GDataEntry"><span class="type">GDataEntry</span></a> to represent a contact from a Google address book.</p>
<p>For more details of Google Contacts' GData API, see the <a class="ulink" href="http://code.google.com/apis/contacts/docs/2.0/reference.html" target="_top">
online documentation</a>.</p>
<p>In addition to all the standard properties available for a contact, <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> supports two kinds of additional property: extended
properties and user-defined fields. Extended properties, set with <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-extended-property" title="gdata_contacts_contact_set_extended_property ()"><code class="function">gdata_contacts_contact_set_extended_property()</code></a> and retrieved with
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-extended-property" title="gdata_contacts_contact_get_extended_property ()"><code class="function">gdata_contacts_contact_get_extended_property()</code></a>, are provided as a method of storing client-specific data which shouldn't be seen or be editable
by the user, such as IDs and cache times. User-defined fields, set with <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-user-defined-field" title="gdata_contacts_contact_set_user_defined_field ()"><code class="function">gdata_contacts_contact_set_user_defined_field()</code></a> and retrieved with
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-user-defined-field" title="gdata_contacts_contact_get_user_defined_field ()"><code class="function">gdata_contacts_contact_get_user_defined_field()</code></a>, store fields defined by the user, and editable by them in the interface (both the interface of
the appliation using libgdata, and the Google Contacts web interface).</p>
<div class="example">
<a name="id-1.5.4.4.9.5"></a><p class="title"><b>Example 23. Getting a Contact's Photo</b></p>
<div class="example-contents">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="usertype">GDataContactsService</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">service</span><span class="symbol">;</span>
<span class="usertype">GDataContactsContact</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">contact</span><span class="symbol">;</span>
<span class="usertype">guint8</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">data</span><span class="symbol">;</span>
<span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">content_type </span><span class="symbol">=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
<span class="usertype">gsize</span><span class="normal"> length </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
<span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
<span class="comment">/* Create a service and return the contact whose photo we're getting. */</span>
<span class="normal">service </span><span class="symbol">=</span><span class="normal"> </span><span class="function">create_contacts_service</span><span class="normal"> </span><span class="symbol">();</span>
<span class="normal">contact </span><span class="symbol">=</span><span class="normal"> </span><span class="function">query_user_for_contact</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">service</span><span class="symbol">);</span>
<span class="comment">/* Get the photo. This should almost always be done asynchronously. */</span>
<span class="normal">data </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GDataContactsContact.html#gdata-contacts-contact-get-photo">gdata_contacts_contact_get_photo</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contact</span><span class="symbol">,</span><span class="normal"> service</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">length</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">content_type</span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">error</span><span class="symbol">);</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contact</span><span class="symbol">);</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">service</span><span class="symbol">);</span>
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error </span><span class="symbol">!=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="function"><a href="../glib/glib-Message-Logging.html#g-error">g_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Error getting a contact's photo: %s"</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">-></span><span class="normal">message</span><span class="symbol">);</span>
<span class="normal"> </span><span class="function"><a href="../glib/glib-Error-Reporting.html#g-error-free">g_error_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">);</span>
<span class="normal"> </span><span class="keyword">return</span><span class="symbol">;</span>
<span class="cbracket">}</span>
<span class="comment">/* Do something with the photo, stored in data, length and content_type. */</span>
<span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">content_type</span><span class="symbol">);</span>
<span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
</div>
</div>
<br class="example-break"><div class="example">
<a name="id-1.5.4.4.9.6"></a><p class="title"><b>Example 24. Setting a Contact's Photo</b></p>
<div class="example-contents">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="usertype">GDataContactsService</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">service</span><span class="symbol">;</span>
<span class="usertype">GDataContactsContact</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">contact</span><span class="symbol">;</span>
<span class="usertype">guint8</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">data</span><span class="symbol">;</span>
<span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">content_type </span><span class="symbol">=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
<span class="usertype">gsize</span><span class="normal"> length </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
<span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
<span class="comment">/* Create a service and return the contact whose photo we're getting, as well as the details of the new photo. */</span>
<span class="normal">service </span><span class="symbol">=</span><span class="normal"> </span><span class="function">create_contacts_service</span><span class="normal"> </span><span class="symbol">();</span>
<span class="normal">contact </span><span class="symbol">=</span><span class="normal"> </span><span class="function">query_user_for_contact</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">service</span><span class="symbol">);</span>
<span class="normal">data </span><span class="symbol">=</span><span class="normal"> </span><span class="function">query_user_for_new_photo</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contact</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">content_type</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">length</span><span class="symbol">);</span>
<span class="comment">/* Set the photo. This should almost always be done asynchronously. To delete the photo, just pass NULL as the photo data. */</span>
<span class="function"><a href="GDataContactsContact.html#gdata-contacts-contact-set-photo">gdata_contacts_contact_set_photo</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contact</span><span class="symbol">,</span><span class="normal"> service</span><span class="symbol">,</span><span class="normal"> data</span><span class="symbol">,</span><span class="normal"> length</span><span class="symbol">,</span><span class="normal"> content_type</span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">error</span><span class="symbol">);</span>
<span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">data</span><span class="symbol">);</span>
<span class="function"><a href="../glib/glib-Memory-Allocation.html#g-free">g_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">content_type</span><span class="symbol">);</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contact</span><span class="symbol">);</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">service</span><span class="symbol">);</span>
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error </span><span class="symbol">!=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="function"><a href="../glib/glib-Message-Logging.html#g-error">g_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Error setting a contact's photo: %s"</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">-></span><span class="normal">message</span><span class="symbol">);</span>
<span class="normal"> </span><span class="function"><a href="../glib/glib-Error-Reporting.html#g-error-free">g_error_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">);</span>
<span class="normal"> </span><span class="keyword">return</span><span class="symbol">;</span>
<span class="cbracket">}</span></pre></td>
</tr>
</tbody>
</table>
</div>
</div>
<br class="example-break"><div class="example">
<a name="id-1.5.4.4.9.7"></a><p class="title"><b>Example 25. Updating a Contact's Details</b></p>
<div class="example-contents">
<table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
<tbody>
<tr>
<td class="listing_lines" align="right"><pre>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38</pre></td>
<td class="listing_code"><pre class="programlisting"><span class="usertype">GDataContactsService</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">service</span><span class="symbol">;</span>
<span class="usertype">GDataContactsContact</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">contact</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">updated_contact</span><span class="symbol">;</span>
<span class="usertype">GDataGDEmailAddress</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">email_address</span><span class="symbol">;</span>
<span class="usertype">GDataGDIMAddress</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">im_address</span><span class="symbol">;</span>
<span class="usertype">GError</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">error </span><span class="symbol">=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
<span class="comment">/* Create a service and return the contact whose details we're updating. */</span>
<span class="normal">service </span><span class="symbol">=</span><span class="normal"> </span><span class="function">create_contacts_service</span><span class="normal"> </span><span class="symbol">();</span>
<span class="normal">contact </span><span class="symbol">=</span><span class="normal"> </span><span class="function">query_user_for_contact</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">service</span><span class="symbol">);</span>
<span class="comment">/* Update the contact's details. We set their nickname to "Fat Tony", add a new e-mail address, and replace all their existing IM</span>
<span class="comment"> * addresses with a single new one. */</span>
<span class="function"><a href="GDataContactsContact.html#gdata-contacts-contact-set-nickname">gdata_contacts_contact_set_nickname</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contact</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"Fat Tony"</span><span class="symbol">);</span>
<span class="normal">email_address </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GDataGDEmailAddress.html#gdata-gd-email-address-new">gdata_gd_email_address_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"tony@gmail.com"</span><span class="symbol">,</span><span class="normal"> <a href="GDataGDEmailAddress.html#GDATA-GD-EMAIL-ADDRESS-HOME:CAPS">GDATA_GD_EMAIL_ADDRESS_HOME</a></span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS">FALSE</a></span><span class="symbol">);</span>
<span class="function"><a href="GDataContactsContact.html#gdata-contacts-contact-add-email-address">gdata_contacts_contact_add_email_address</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contact</span><span class="symbol">,</span><span class="normal"> email_address</span><span class="symbol">);</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">email_address</span><span class="symbol">);</span>
<span class="function"><a href="GDataContactsContact.html#gdata-contacts-contact-remove-all-im-addresses">gdata_contacts_contact_remove_all_im_addresses</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contact</span><span class="symbol">);</span>
<span class="normal">im_address </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GDataGDIMAddress.html#gdata-gd-im-address-new">gdata_gd_im_address_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"tony.work@gmail.com"</span><span class="symbol">,</span><span class="normal"> <a href="GDataGDIMAddress.html#GDATA-GD-IM-PROTOCOL-GOOGLE-TALK:CAPS">GDATA_GD_IM_PROTOCOL_GOOGLE_TALK</a></span><span class="symbol">,</span><span class="normal"> <a href="GDataGDIMAddress.html#GDATA-GD-IM-ADDRESS-WORK:CAPS">GDATA_GD_IM_ADDRESS_WORK</a></span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS">TRUE</a></span><span class="symbol">);</span>
<span class="function"><a href="GDataContactsContact.html#gdata-contacts-contact-add-im-address">gdata_contacts_contact_add_im_address</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contact</span><span class="symbol">,</span><span class="normal"> im_address</span><span class="symbol">);</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">im_address</span><span class="symbol">);</span>
<span class="comment">/* Send the updated contact to the server */</span>
<span class="normal">updated_contact </span><span class="symbol">=</span><span class="normal"> </span><span class="function">GDATA_CONTACTS_CONTACT</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="GDataService.html#gdata-service-update-entry">gdata_service_update_entry</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GDATA_SERVICE</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">service</span><span class="symbol">),</span><span class="normal"> </span><span class="function">GDATA_ENTRY</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contact</span><span class="symbol">),</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&</span><span class="normal">error</span><span class="symbol">));</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">contact</span><span class="symbol">);</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">service</span><span class="symbol">);</span>
<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error </span><span class="symbol">!=</span><span class="normal"> <a href="../glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">)</span><span class="normal"> </span><span class="cbracket">{</span>
<span class="normal"> </span><span class="function"><a href="../glib/glib-Message-Logging.html#g-error">g_error</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Error updating a contact's details: %s"</span><span class="symbol">,</span><span class="normal"> error</span><span class="symbol">-></span><span class="normal">message</span><span class="symbol">);</span>
<span class="normal"> </span><span class="function"><a href="../glib/glib-Error-Reporting.html#g-error-free">g_error_free</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">error</span><span class="symbol">);</span>
<span class="normal"> </span><span class="keyword">return</span><span class="symbol">;</span>
<span class="cbracket">}</span>
<span class="comment">/* Do something with the updated contact, such as update them in the UI, or store their ID for future use. */</span>
<span class="function"><a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">updated_contact</span><span class="symbol">);</span></pre></td>
</tr>
</tbody>
</table>
</div>
</div>
<br class="example-break">
</div>
<div class="refsect1">
<a name="GDataContactsContact.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gdata-contacts-contact-new"></a><h3>gdata_contacts_contact_new ()</h3>
<pre class="programlisting"><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="returnvalue">GDataContactsContact</span></a> *
gdata_contacts_contact_new (<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>);</pre>
<p>Creates a new <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> with the given ID and default properties.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>id</p></td>
<td class="parameter_description"><p>the contact's ID, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-new.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a>; unref with <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-name"></a><h3>gdata_contacts_contact_get_name ()</h3>
<pre class="programlisting"><a class="link" href="GDataGDName.html" title="GDataGDName"><span class="returnvalue">GDataGDName</span></a> *
gdata_contacts_contact_get_name (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--name" title="The “name” property"><span class="type">“name”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-name.returns"></a><h4>Returns</h4>
<p>the contact's name, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix07.html#api-index-0.5.0">0.5.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-name"></a><h3>gdata_contacts_contact_set_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_name (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGDName.html" title="GDataGDName"><span class="type">GDataGDName</span></a> *name</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--name" title="The “name” property"><span class="type">“name”</span></a> property to <em class="parameter"><code>name</code></em>
, and increments its reference count.</p>
<p><em class="parameter"><code>name</code></em>
must not be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, though all its properties may be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>the new <a class="link" href="GDataGDName.html" title="GDataGDName"><span class="type">GDataGDName</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-short-name"></a><h3>gdata_contacts_contact_get_short_name ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_short_name (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--short-name" title="The “short-name” property"><span class="type">“short-name”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-short-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-short-name.returns"></a><h4>Returns</h4>
<p> the contact's short name, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-short-name"></a><h3>gdata_contacts_contact_set_short_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_short_name (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *short_name</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--short-name" title="The “short-name” property"><span class="type">“short-name”</span></a> property to <em class="parameter"><code>short_name</code></em>
.</p>
<p>If <em class="parameter"><code>short_name</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's short name will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-short-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>short_name</p></td>
<td class="parameter_description"><p>the contact's new short name, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-initials"></a><h3>gdata_contacts_contact_get_initials ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_initials (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--initials" title="The “initials” property"><span class="type">“initials”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-initials.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-initials.returns"></a><h4>Returns</h4>
<p> the initials of the contact, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-initials"></a><h3>gdata_contacts_contact_set_initials ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_initials (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *initials</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--initials" title="The “initials” property"><span class="type">“initials”</span></a> property to <em class="parameter"><code>initials</code></em>
.</p>
<p>If <em class="parameter"><code>initials</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's initials will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-initials.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>initials</p></td>
<td class="parameter_description"><p>the new initials of the contact, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-maiden-name"></a><h3>gdata_contacts_contact_get_maiden_name ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_maiden_name
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--maiden-name" title="The “maiden-name” property"><span class="type">“maiden-name”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-maiden-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-maiden-name.returns"></a><h4>Returns</h4>
<p> the maiden name of the contact, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-maiden-name"></a><h3>gdata_contacts_contact_set_maiden_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_maiden_name
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *maiden_name</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--maiden-name" title="The “maiden-name” property"><span class="type">“maiden-name”</span></a> property to <em class="parameter"><code>maiden_name</code></em>
.</p>
<p>If <em class="parameter"><code>maiden_name</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's maiden name will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-maiden-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>maiden_name</p></td>
<td class="parameter_description"><p>the new maiden name of the contact, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-nickname"></a><h3>gdata_contacts_contact_get_nickname ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_nickname (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--nickname" title="The “nickname” property"><span class="type">“nickname”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-nickname.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-nickname.returns"></a><h4>Returns</h4>
<p> the contact's nickname, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-nickname"></a><h3>gdata_contacts_contact_set_nickname ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_nickname (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *nickname</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--nickname" title="The “nickname” property"><span class="type">“nickname”</span></a> property to <em class="parameter"><code>nickname</code></em>
.</p>
<p>If <em class="parameter"><code>nickname</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's nickname will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-nickname.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>nickname</p></td>
<td class="parameter_description"><p>the new nickname, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-file-as"></a><h3>gdata_contacts_contact_get_file_as ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_file_as (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--file-as" title="The “file-as” property"><span class="type">“file-as”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-file-as.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-file-as.returns"></a><h4>Returns</h4>
<p> the name the contact's filed under, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix14.html#api-index-0.11.0">0.11.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-file-as"></a><h3>gdata_contacts_contact_set_file_as ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_file_as (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *file_as</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--file-as" title="The “file-as” property"><span class="type">“file-as”</span></a> property to <em class="parameter"><code>file_as</code></em>
.</p>
<p>If <em class="parameter"><code>file_as</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact will be filed under their full name.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-file-as.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>file_as</p></td>
<td class="parameter_description"><p>the new name to file the contact under, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-birthday"></a><h3>gdata_contacts_contact_get_birthday ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gdata_contacts_contact_get_birthday (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *birthday</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--birthday" title="The “birthday” property"><span class="type">“birthday”</span></a> and <a class="link" href="GDataContactsContact.html#GDataContactsContact--birthday-has-year" title="The “birthday-has-year” property"><span class="type">“birthday-has-year”</span></a> properties. If <em class="parameter"><code>birthday</code></em>
is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>,
<a class="link" href="GDataContactsContact.html#GDataContactsContact--birthday" title="The “birthday” property"><span class="type">“birthday”</span></a> is returned in it. The function returns the value of <a class="link" href="GDataContactsContact.html#GDataContactsContact--birthday-has-year" title="The “birthday-has-year” property"><span class="type">“birthday-has-year”</span></a>,
which specifies whether the year in <em class="parameter"><code>birthday</code></em>
is meaningful. Contacts may not have the year of their birth set, in which
case, the function would return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, and the year in <em class="parameter"><code>birthday</code></em>
should be ignored.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-birthday.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>birthday</p></td>
<td class="parameter_description"><p>return location for the birthday, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-birthday.returns"></a><h4>Returns</h4>
<p> whether the contact's birthday has the year set</p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-birthday"></a><h3>gdata_contacts_contact_set_birthday ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_birthday (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a href="../glib/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *birthday</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> birthday_has_year</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--birthday" title="The “birthday” property"><span class="type">“birthday”</span></a> property to <em class="parameter"><code>birthday</code></em>
and the <a class="link" href="GDataContactsContact.html#GDataContactsContact--birthday-has-year" title="The “birthday-has-year” property"><span class="type">“birthday-has-year”</span></a> property to <em class="parameter"><code>birthday_has_year</code></em>
.
See <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-birthday" title="gdata_contacts_contact_get_birthday ()"><code class="function">gdata_contacts_contact_get_birthday()</code></a> for an explanation of the interation between these two properties.</p>
<p>If <em class="parameter"><code>birthday</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's birthday will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-birthday.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>birthday</p></td>
<td class="parameter_description"><p>the new birthday, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>birthday_has_year</p></td>
<td class="parameter_description"><p><a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>birthday</code></em>
's year is relevant, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-gender"></a><h3>gdata_contacts_contact_get_gender ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_gender (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--gender" title="The “gender” property"><span class="type">“gender”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-gender.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-gender.returns"></a><h4>Returns</h4>
<p> the gender of the contact, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-gender"></a><h3>gdata_contacts_contact_set_gender ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_gender (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *gender</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--gender" title="The “gender” property"><span class="type">“gender”</span></a> property to <em class="parameter"><code>gender</code></em>
.</p>
<p>If <em class="parameter"><code>gender</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's gender will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-gender.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>gender</p></td>
<td class="parameter_description"><p>the new gender of the contact, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-mileage"></a><h3>gdata_contacts_contact_get_mileage ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_mileage (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--mileage" title="The “mileage” property"><span class="type">“mileage”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-mileage.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-mileage.returns"></a><h4>Returns</h4>
<p> a mileage associated with the contact, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-mileage"></a><h3>gdata_contacts_contact_set_mileage ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_mileage (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *mileage</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--mileage" title="The “mileage” property"><span class="type">“mileage”</span></a> property to <em class="parameter"><code>mileage</code></em>
.</p>
<p>If <em class="parameter"><code>mileage</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's mileage will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-mileage.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mileage</p></td>
<td class="parameter_description"><p>the new mileage associated with the contact, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-occupation"></a><h3>gdata_contacts_contact_get_occupation ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_occupation (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--occupation" title="The “occupation” property"><span class="type">“occupation”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-occupation.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-occupation.returns"></a><h4>Returns</h4>
<p> the contact's occupation, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-occupation"></a><h3>gdata_contacts_contact_set_occupation ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_occupation (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *occupation</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--occupation" title="The “occupation” property"><span class="type">“occupation”</span></a> property to <em class="parameter"><code>occupation</code></em>
.</p>
<p>If <em class="parameter"><code>occupation</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's occupation will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-occupation.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>occupation</p></td>
<td class="parameter_description"><p>the contact's new occupation, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-subject"></a><h3>gdata_contacts_contact_get_subject ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_subject (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--subject" title="The “subject” property"><span class="type">“subject”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-subject.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-subject.returns"></a><h4>Returns</h4>
<p> the contact's subject, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-subject"></a><h3>gdata_contacts_contact_set_subject ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_subject (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *subject</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--subject" title="The “subject” property"><span class="type">“subject”</span></a> property to <em class="parameter"><code>subject</code></em>
.</p>
<p>If <em class="parameter"><code>subject</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's subject will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-subject.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>subject</p></td>
<td class="parameter_description"><p>the contact's new subject, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-priority"></a><h3>gdata_contacts_contact_get_priority ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_priority (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--priority" title="The “priority” property"><span class="type">“priority”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-priority.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-priority.returns"></a><h4>Returns</h4>
<p> the contact's priority, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-priority"></a><h3>gdata_contacts_contact_set_priority ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_priority (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *priority</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--priority" title="The “priority” property"><span class="type">“priority”</span></a> property to <em class="parameter"><code>priority</code></em>
.</p>
<p>If <em class="parameter"><code>priority</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's priority will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-priority.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>priority</p></td>
<td class="parameter_description"><p>the contact's new priority, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-sensitivity"></a><h3>gdata_contacts_contact_get_sensitivity ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_sensitivity
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--sensitivity" title="The “sensitivity” property"><span class="type">“sensitivity”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-sensitivity.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-sensitivity.returns"></a><h4>Returns</h4>
<p> the contact's sensitivity, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-sensitivity"></a><h3>gdata_contacts_contact_set_sensitivity ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_sensitivity
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *sensitivity</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--sensitivity" title="The “sensitivity” property"><span class="type">“sensitivity”</span></a> property to <em class="parameter"><code>sensitivity</code></em>
.</p>
<p>If <em class="parameter"><code>sensitivity</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's sensitivity will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-sensitivity.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>sensitivity</p></td>
<td class="parameter_description"><p>the contact's new sensitivity, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-directory-server"></a><h3>gdata_contacts_contact_get_directory_server ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_directory_server
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--directory-server" title="The “directory-server” property"><span class="type">“directory-server”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-directory-server.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-directory-server.returns"></a><h4>Returns</h4>
<p> the name or address of a directory server associated with the contact, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-directory-server"></a><h3>gdata_contacts_contact_set_directory_server ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_directory_server
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *directory_server</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--directory-server" title="The “directory-server” property"><span class="type">“directory-server”</span></a> property to <em class="parameter"><code>directory_server</code></em>
.</p>
<p>If <em class="parameter"><code>directory_server</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's directory server will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-directory-server.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>directory_server</p></td>
<td class="parameter_description"><p>the new name or address of a directory server associated with the contact, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-billing-information"></a><h3>gdata_contacts_contact_get_billing_information ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_billing_information
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--billing-information" title="The “billing-information” property"><span class="type">“billing-information”</span></a> property.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-billing-information.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-billing-information.returns"></a><h4>Returns</h4>
<p> the contact's billing information, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-billing-information"></a><h3>gdata_contacts_contact_set_billing_information ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_billing_information
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *billing_information</code></em>);</pre>
<p>Sets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--billing-information" title="The “billing-information” property"><span class="type">“billing-information”</span></a> property to <em class="parameter"><code>billing_information</code></em>
.</p>
<p>If <em class="parameter"><code>billing_information</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the contact's billing information will be removed.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-billing-information.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>billing_information</p></td>
<td class="parameter_description"><p>the new billing information for the contact, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-email-addresses"></a><h3>gdata_contacts_contact_get_email_addresses ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_email_addresses
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the e-mail addresses owned by the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-email-addresses.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-email-addresses.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GDataGDEmailAddress.html" title="GDataGDEmailAddress"><span class="type">GDataGDEmailAddress</span></a>es, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GData.GDEmailAddress][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-primary-email-address"></a><h3>gdata_contacts_contact_get_primary_email_address ()</h3>
<pre class="programlisting"><a class="link" href="GDataGDEmailAddress.html" title="GDataGDEmailAddress"><span class="returnvalue">GDataGDEmailAddress</span></a> *
gdata_contacts_contact_get_primary_email_address
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the contact's primary e-mail address, if one exists.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-email-address.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-email-address.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GDataGDEmailAddress.html" title="GDataGDEmailAddress"><span class="type">GDataGDEmailAddress</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-email-address"></a><h3>gdata_contacts_contact_add_email_address ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_email_address
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGDEmailAddress.html" title="GDataGDEmailAddress"><span class="type">GDataGDEmailAddress</span></a> *email_address</code></em>);</pre>
<p>Adds an e-mail address to the contact's list of e-mail addresses and increments its reference count.</p>
<p>Note that only one e-mail address per contact may be marked as "primary". Insertion and update operations
(with <a class="link" href="GDataContactsService.html#gdata-contacts-service-insert-contact" title="gdata_contacts_service_insert_contact ()"><code class="function">gdata_contacts_service_insert_contact()</code></a>) will return an error if more than one e-mail address
is marked as primary.</p>
<p>Duplicate e-mail addresses will not be added to the list.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-email-address.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>email_address</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataGDEmailAddress.html" title="GDataGDEmailAddress"><span class="type">GDataGDEmailAddress</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-email-addresses"></a><h3>gdata_contacts_contact_remove_all_email_addresses ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_email_addresses
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all e-mail addresses from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-email-addresses.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-im-addresses"></a><h3>gdata_contacts_contact_get_im_addresses ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_im_addresses
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the IM addresses owned by the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-im-addresses.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-im-addresses.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GDataGDIMAddress.html" title="GDataGDIMAddress"><span class="type">GDataGDIMAddress</span></a>es, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GData.GDIMAddress][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-primary-im-address"></a><h3>gdata_contacts_contact_get_primary_im_address ()</h3>
<pre class="programlisting"><a class="link" href="GDataGDIMAddress.html" title="GDataGDIMAddress"><span class="returnvalue">GDataGDIMAddress</span></a> *
gdata_contacts_contact_get_primary_im_address
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the contact's primary IM address, if one exists.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-im-address.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-im-address.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GDataGDIMAddress.html" title="GDataGDIMAddress"><span class="type">GDataGDIMAddress</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-im-address"></a><h3>gdata_contacts_contact_add_im_address ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_im_address (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGDIMAddress.html" title="GDataGDIMAddress"><span class="type">GDataGDIMAddress</span></a> *im_address</code></em>);</pre>
<p>Adds an IM (instant messaging) address to the contact's list of IM addresses and increments its reference count.</p>
<p>Note that only one IM address per contact may be marked as "primary". Insertion and update operations
(with <a class="link" href="GDataContactsService.html#gdata-contacts-service-insert-contact" title="gdata_contacts_service_insert_contact ()"><code class="function">gdata_contacts_service_insert_contact()</code></a>) will return an error if more than one IM address
is marked as primary.</p>
<p>Duplicate IM addresses will not be added to the list.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-im-address.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>im_address</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataGDIMAddress.html" title="GDataGDIMAddress"><span class="type">GDataGDIMAddress</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-im-addresses"></a><h3>gdata_contacts_contact_remove_all_im_addresses ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_im_addresses
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all IM addresses from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-im-addresses.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-postal-addresses"></a><h3>gdata_contacts_contact_get_postal_addresses ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_postal_addresses
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the postal addresses owned by the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-postal-addresses.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-postal-addresses.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GDataGDPostalAddress.html" title="GDataGDPostalAddress"><span class="type">GDataGDPostalAddress</span></a>es, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GData.GDPostalAddress][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-primary-postal-address"></a><h3>gdata_contacts_contact_get_primary_postal_address ()</h3>
<pre class="programlisting"><a class="link" href="GDataGDPostalAddress.html" title="GDataGDPostalAddress"><span class="returnvalue">GDataGDPostalAddress</span></a> *
gdata_contacts_contact_get_primary_postal_address
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the contact's primary postal address, if one exists.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-postal-address.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-postal-address.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GDataGDPostalAddress.html" title="GDataGDPostalAddress"><span class="type">GDataGDPostalAddress</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-postal-address"></a><h3>gdata_contacts_contact_add_postal_address ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_postal_address
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGDPostalAddress.html" title="GDataGDPostalAddress"><span class="type">GDataGDPostalAddress</span></a> *postal_address</code></em>);</pre>
<p>Adds a postal address to the contact's list of postal addresses and increments its reference count.</p>
<p>Note that only one postal address per contact may be marked as "primary". Insertion and update operations
(with <a class="link" href="GDataContactsService.html#gdata-contacts-service-insert-contact" title="gdata_contacts_service_insert_contact ()"><code class="function">gdata_contacts_service_insert_contact()</code></a>) will return an error if more than one postal address
is marked as primary.</p>
<p>Duplicate postal addresses will not be added to the list.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-postal-address.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>postal_address</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataGDPostalAddress.html" title="GDataGDPostalAddress"><span class="type">GDataGDPostalAddress</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-postal-addresses"></a><h3>gdata_contacts_contact_remove_all_postal_addresses ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_postal_addresses
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all postal addresses from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-postal-addresses.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-phone-numbers"></a><h3>gdata_contacts_contact_get_phone_numbers ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_phone_numbers
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the phone numbers owned by the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-phone-numbers.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-phone-numbers.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GDataGDPhoneNumber.html" title="GDataGDPhoneNumber"><span class="type">GDataGDPhoneNumber</span></a>s, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GData.GDPhoneNumber][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-primary-phone-number"></a><h3>gdata_contacts_contact_get_primary_phone_number ()</h3>
<pre class="programlisting"><a class="link" href="GDataGDPhoneNumber.html" title="GDataGDPhoneNumber"><span class="returnvalue">GDataGDPhoneNumber</span></a> *
gdata_contacts_contact_get_primary_phone_number
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the contact's primary phone number, if one exists.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-phone-number.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-phone-number.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GDataGDPhoneNumber.html" title="GDataGDPhoneNumber"><span class="type">GDataGDPhoneNumber</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-phone-number"></a><h3>gdata_contacts_contact_add_phone_number ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_phone_number
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGDPhoneNumber.html" title="GDataGDPhoneNumber"><span class="type">GDataGDPhoneNumber</span></a> *phone_number</code></em>);</pre>
<p>Adds a phone number to the contact's list of phone numbers and increments its reference count</p>
<p>Note that only one phone number per contact may be marked as "primary". Insertion and update operations
(with <a class="link" href="GDataContactsService.html#gdata-contacts-service-insert-contact" title="gdata_contacts_service_insert_contact ()"><code class="function">gdata_contacts_service_insert_contact()</code></a>) will return an error if more than one phone number
is marked as primary.</p>
<p>Duplicate phone numbers will not be added to the list.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-phone-number.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>phone_number</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataGDPhoneNumber.html" title="GDataGDPhoneNumber"><span class="type">GDataGDPhoneNumber</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-phone-numbers"></a><h3>gdata_contacts_contact_remove_all_phone_numbers ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_phone_numbers
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all phone numbers from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-phone-numbers.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-organizations"></a><h3>gdata_contacts_contact_get_organizations ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_organizations
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the organizations to which the contact belongs.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-organizations.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-organizations.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GDataGDOrganization.html" title="GDataGDOrganization"><span class="type">GDataGDOrganization</span></a>s, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GData.GDOrganization][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-primary-organization"></a><h3>gdata_contacts_contact_get_primary_organization ()</h3>
<pre class="programlisting"><a class="link" href="GDataGDOrganization.html" title="GDataGDOrganization"><span class="returnvalue">GDataGDOrganization</span></a> *
gdata_contacts_contact_get_primary_organization
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the contact's primary organization, if one exists.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-organization.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-organization.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GDataGDOrganization.html" title="GDataGDOrganization"><span class="type">GDataGDOrganization</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-organization"></a><h3>gdata_contacts_contact_add_organization ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_organization
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGDOrganization.html" title="GDataGDOrganization"><span class="type">GDataGDOrganization</span></a> *organization</code></em>);</pre>
<p>Adds an organization to the contact's list of organizations (e.g. employers) and increments its reference count.</p>
<p>Note that only one organization per contact may be marked as "primary". Insertion and update operations
(with <a class="link" href="GDataContactsService.html#gdata-contacts-service-insert-contact" title="gdata_contacts_service_insert_contact ()"><code class="function">gdata_contacts_service_insert_contact()</code></a>) will return an error if more than one organization
is marked as primary.</p>
<p>Duplicate organizations will not be added to the list.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-organization.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>organization</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataGDOrganization.html" title="GDataGDOrganization"><span class="type">GDataGDOrganization</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-organizations"></a><h3>gdata_contacts_contact_remove_all_organizations ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_organizations
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all organizations from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-organizations.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-jot"></a><h3>gdata_contacts_contact_add_jot ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_jot (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGContactJot.html" title="GDataGContactJot"><span class="type">GDataGContactJot</span></a> *jot</code></em>);</pre>
<p>Adds a jot to the contact's list of jots and increments its reference count.</p>
<p>Duplicate jots will be added to the list, and multiple jots with the same relation type can be added to a single contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-jot.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>jot</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataGContactJot.html" title="GDataGContactJot"><span class="type">GDataGContactJot</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-jots"></a><h3>gdata_contacts_contact_get_jots ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_jots (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the jots attached to the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-jots.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-jots.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GDataGContactJot.html" title="GDataGContactJot"><span class="type">GDataGContactJot</span></a>s, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GData.GContactJot][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-jots"></a><h3>gdata_contacts_contact_remove_all_jots ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_jots
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all jots from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-jots.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-relation"></a><h3>gdata_contacts_contact_add_relation ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_relation (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGContactRelation.html" title="GDataGContactRelation"><span class="type">GDataGContactRelation</span></a> *relation</code></em>);</pre>
<p>Adds a relation to the contact's list of relations and increments its reference count.</p>
<p>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.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-relation.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>relation</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataGContactRelation.html" title="GDataGContactRelation"><span class="type">GDataGContactRelation</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-relations"></a><h3>gdata_contacts_contact_get_relations ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_relations (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the relations of the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-relations.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-relations.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GDataGContactRelation.html" title="GDataGContactRelation"><span class="type">GDataGContactRelation</span></a>s, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GData.GContactRelation][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-relations"></a><h3>gdata_contacts_contact_remove_all_relations ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_relations
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all relations from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-relations.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-website"></a><h3>gdata_contacts_contact_add_website ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_website (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGContactWebsite.html" title="GDataGContactWebsite"><span class="type">GDataGContactWebsite</span></a> *website</code></em>);</pre>
<p>Adds a website to the contact's list of websites and increments its reference count.</p>
<p>Duplicate websites will not be added to the list, though the same URI may appear in several <a class="link" href="GDataGContactWebsite.html" title="GDataGContactWebsite"><span class="type">GDataGContactWebsite</span></a>s with different
relation types or labels.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-website.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>website</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataGContactWebsite.html" title="GDataGContactWebsite"><span class="type">GDataGContactWebsite</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-websites"></a><h3>gdata_contacts_contact_get_websites ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_websites (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the websites of the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-websites.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-websites.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GDataGContactWebsite.html" title="GDataGContactWebsite"><span class="type">GDataGContactWebsite</span></a>s, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GData.GContactWebsite][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-primary-website"></a><h3>gdata_contacts_contact_get_primary_website ()</h3>
<pre class="programlisting"><a class="link" href="GDataGContactWebsite.html" title="GDataGContactWebsite"><span class="returnvalue">GDataGContactWebsite</span></a> *
gdata_contacts_contact_get_primary_website
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the contact's primary website, if one exists.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-website.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-website.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GDataGContactWebsite.html" title="GDataGContactWebsite"><span class="type">GDataGContactWebsite</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-websites"></a><h3>gdata_contacts_contact_remove_all_websites ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_websites
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all websites from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-websites.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-event"></a><h3>gdata_contacts_contact_add_event ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_event (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGContactEvent.html" title="GDataGContactEvent"><span class="type">GDataGContactEvent</span></a> *event</code></em>);</pre>
<p>Adds an event to the contact's list of events and increments its reference count.</p>
<p>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.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-event.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>event</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataGContactEvent.html" title="GDataGContactEvent"><span class="type">GDataGContactEvent</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-events"></a><h3>gdata_contacts_contact_get_events ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_events (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the events of the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-events.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-events.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GDataGContactEvent.html" title="GDataGContactEvent"><span class="type">GDataGContactEvent</span></a>s, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GData.GContactEvent][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-events"></a><h3>gdata_contacts_contact_remove_all_events ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_events
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all events from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-events.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-calendar"></a><h3>gdata_contacts_contact_add_calendar ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_calendar (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGContactCalendar.html" title="GDataGContactCalendar"><span class="type">GDataGContactCalendar</span></a> *calendar</code></em>);</pre>
<p>Adds a calendar to the contact's list of calendars and increments its reference count.</p>
<p>Duplicate calendars will not be added to the list, though the same URI may appear in several <a class="link" href="GDataGContactCalendar.html" title="GDataGContactCalendar"><span class="type">GDataGContactCalendar</span></a>s with different
relation types or labels.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-calendar.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>calendar</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataGContactCalendar.html" title="GDataGContactCalendar"><span class="type">GDataGContactCalendar</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-calendars"></a><h3>gdata_contacts_contact_get_calendars ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_calendars (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the calendars of the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-calendars.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-calendars.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GDataGContactCalendar.html" title="GDataGContactCalendar"><span class="type">GDataGContactCalendar</span></a>s, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GData.GContactCalendar][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-primary-calendar"></a><h3>gdata_contacts_contact_get_primary_calendar ()</h3>
<pre class="programlisting"><a class="link" href="GDataGContactCalendar.html" title="GDataGContactCalendar"><span class="returnvalue">GDataGContactCalendar</span></a> *
gdata_contacts_contact_get_primary_calendar
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the contact's primary calendar, if one exists.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-calendar.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-primary-calendar.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GDataGContactCalendar.html" title="GDataGContactCalendar"><span class="type">GDataGContactCalendar</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-calendars"></a><h3>gdata_contacts_contact_remove_all_calendars ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_calendars
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all calendars from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-calendars.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-external-id"></a><h3>gdata_contacts_contact_add_external_id ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_external_id
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGContactExternalID.html" title="GDataGContactExternalID"><span class="type">GDataGContactExternalID</span></a> *external_id</code></em>);</pre>
<p>Adds an external ID to the contact's list of external IDs and increments its reference count.</p>
<p>Duplicate IDs will not be added to the list.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-external-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>external_id</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataGContactExternalID.html" title="GDataGContactExternalID"><span class="type">GDataGContactExternalID</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-external-ids"></a><h3>gdata_contacts_contact_get_external_ids ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_external_ids
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the external IDs of the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-external-ids.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-external-ids.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GDataGContactExternalID.html" title="GDataGContactExternalID"><span class="type">GDataGContactExternalID</span></a>s, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GData.GContactExternalID][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-external-ids"></a><h3>gdata_contacts_contact_remove_all_external_ids ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_external_ids
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all external IDs from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-external-ids.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-hobby"></a><h3>gdata_contacts_contact_add_hobby ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_hobby (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *hobby</code></em>);</pre>
<p>Adds a hobby to the contact's list of hobbies, copying it in the process.</p>
<p>Duplicate hobbies will not be added to the list.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-hobby.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>hobby</p></td>
<td class="parameter_description"><p>a hobby to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-hobbies"></a><h3>gdata_contacts_contact_get_hobbies ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_hobbies (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the hobbies of the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-hobbies.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-hobbies.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of hobby strings, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-hobbies"></a><h3>gdata_contacts_contact_remove_all_hobbies ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_hobbies
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all hobbies from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-hobbies.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-language"></a><h3>gdata_contacts_contact_add_language ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_language (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataGContactLanguage.html" title="GDataGContactLanguage"><span class="type">GDataGContactLanguage</span></a> *language</code></em>);</pre>
<p>Adds a language to the contact's list of languages and increments its reference count.</p>
<p>Duplicate languages will not be added to the list.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-language.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>language</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataGContactLanguage.html" title="GDataGContactLanguage"><span class="type">GDataGContactLanguage</span></a> to add</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-languages"></a><h3>gdata_contacts_contact_get_languages ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_languages (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the languages of the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-languages.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-languages.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a class="link" href="GDataGContactLanguage.html" title="GDataGContactLanguage"><span class="type">GDataGContactLanguage</span></a>s, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GData.GContactLanguage][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-all-languages"></a><h3>gdata_contacts_contact_remove_all_languages ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_all_languages
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Removes all languages from the contact.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-all-languages.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-groups"></a><h3>gdata_contacts_contact_get_groups ()</h3>
<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
gdata_contacts_contact_get_groups (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets a list of the groups to which the contact belongs.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-groups.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-groups.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of constant group ID URIs, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; free with <a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-add-group"></a><h3>gdata_contacts_contact_add_group ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_add_group (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *href</code></em>);</pre>
<p>Adds the contact to the given group. <em class="parameter"><code>href</code></em>
should be a URI.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-add-group.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>href</p></td>
<td class="parameter_description"><p>the group's ID URI</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-remove-group"></a><h3>gdata_contacts_contact_remove_group ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_remove_group (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *href</code></em>);</pre>
<p>Removes the contact from the given group. <em class="parameter"><code>href</code></em>
should be a URI.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-remove-group.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>href</p></td>
<td class="parameter_description"><p>the group's ID URI</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-is-group-deleted"></a><h3>gdata_contacts_contact_is_group_deleted ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gdata_contacts_contact_is_group_deleted
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *href</code></em>);</pre>
<p>Returns whether the contact has recently been removed from the given group on the server. This
will always return <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> unless <a class="link" href="GDataContactsQuery.html#GDataContactsQuery--show-deleted" title="The “show-deleted” property"><span class="type">“show-deleted”</span></a> has been set to
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for the query which returned the contact.</p>
<p>If you've just removed a contact from a group locally using <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-remove-group" title="gdata_contacts_contact_remove_group ()"><code class="function">gdata_contacts_contact_remove_group()</code></a>, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will still be returned by this function,
as the change hasn't been sent to the server.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-is-group-deleted.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>href</p></td>
<td class="parameter_description"><p>the group's ID URI</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-is-group-deleted.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the contact has recently been removed from the group, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-extended-property"></a><h3>gdata_contacts_contact_get_extended_property ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_extended_property
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
<p>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.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-extended-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>the property name; an arbitrary, unique string</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-extended-property.returns"></a><h4>Returns</h4>
<p> the property's value, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-extended-properties"></a><h3>gdata_contacts_contact_get_extended_properties ()</h3>
<pre class="programlisting"><a href="../glib/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
gdata_contacts_contact_get_extended_properties
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the full list of extended properties of the contact; a hash table mapping property name to value.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-extended-properties.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-extended-properties.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> of extended properties. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix06.html#api-index-0.4.0">0.4.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-extended-property"></a><h3>gdata_contacts_contact_set_extended_property ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gdata_contacts_contact_set_extended_property
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
<p>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.</p>
<p>To unset a property, set <em class="parameter"><code>value</code></em>
to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or an empty string.</p>
<p>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 <a class="ulink" href="http://code.google.com/apis/contacts/docs/2.0/reference.html#ProjectionsAndExtended" target="_top">online documentation</a>.
<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned if you attempt to add more than 10 extended properties.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-extended-property.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>the property name; an arbitrary, unique string</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the property value, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-set-extended-property.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the property was updated or deleted successfully, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-user-defined-field"></a><h3>gdata_contacts_contact_get_user_defined_field ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_user_defined_field
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
<p>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.</p>
<p>The <em class="parameter"><code>name</code></em>
of the field may not be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, but may be an empty string.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-user-defined-field.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>the field name; an arbitrary, case-sensitive, unique string</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-user-defined-field.returns"></a><h4>Returns</h4>
<p> the field's value, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-user-defined-fields"></a><h3>gdata_contacts_contact_get_user_defined_fields ()</h3>
<pre class="programlisting"><a href="../glib/glib-Hash-Tables.html#GHashTable"><span class="returnvalue">GHashTable</span></a> *
gdata_contacts_contact_get_user_defined_fields
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the full list of user-defined fields of the contact; a hash table mapping field name to value.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-user-defined-fields.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-user-defined-fields.returns"></a><h4>Returns</h4>
<p>a <a href="../glib/glib-Hash-Tables.html#GHashTable"><span class="type">GHashTable</span></a> of user-defined fields. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-user-defined-field"></a><h3>gdata_contacts_contact_set_user_defined_field ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_user_defined_field
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
<p>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.</p>
<p>The <em class="parameter"><code>name</code></em>
of the field may not be <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, but may be an empty string.</p>
<p>To unset a field, set <em class="parameter"><code>value</code></em>
to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-user-defined-field.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>the field name; an arbitrary, case-sensitive, unique string</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>the field value, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-edited"></a><h3>gdata_contacts_contact_get_edited ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gint64"><span class="returnvalue">gint64</span></a>
gdata_contacts_contact_get_edited (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Gets the <a class="link" href="GDataContactsContact.html#GDataContactsContact--edited" title="The “edited” property"><span class="type">“edited”</span></a> property. If the property is unset, <code class="code">-1</code> will be returned.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-edited.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-edited.returns"></a><h4>Returns</h4>
<p> the UNIX timestamp for the time the contact was last edited, or <code class="code">-1</code></p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-is-deleted"></a><h3>gdata_contacts_contact_is_deleted ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gdata_contacts_contact_is_deleted (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Returns whether the contact has recently been deleted. This will always return
<a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> unless <a class="link" href="GDataContactsQuery.html#GDataContactsQuery--show-deleted" title="The “show-deleted” property"><span class="type">“show-deleted”</span></a> has been set to
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> for the query which returned the contact; then this function will return
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> only if the contact has been deleted.</p>
<p>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 <a class="link" href="GDataQuery.html#GDataQuery--updated-min" title="The “updated-min” property"><span class="type">“updated-min”</span></a> and
<a class="link" href="GDataContactsQuery.html#GDataContactsQuery--show-deleted" title="The “show-deleted” property"><span class="type">“show-deleted”</span></a>).</p>
<div class="refsect3">
<a name="gdata-contacts-contact-is-deleted.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-is-deleted.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the contact has been deleted, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-photo-etag"></a><h3>gdata_contacts_contact_get_photo_etag ()</h3>
<pre class="programlisting">const <a href="../glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gdata_contacts_contact_get_photo_etag (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>);</pre>
<p>Returns the ETag for the contact's attached photo, if it exists. If it does exist, the contact's photo can be retrieved using
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo" title="gdata_contacts_contact_get_photo ()"><code class="function">gdata_contacts_contact_get_photo()</code></a>. If it doesn't exist, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned, and the contact doesn't have a photo (so calling
<a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo" title="gdata_contacts_contact_get_photo ()"><code class="function">gdata_contacts_contact_get_photo()</code></a> will also return <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>)</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-photo-etag.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-photo-etag.returns"></a><h4>Returns</h4>
<p> the contact's photo's ETag if it exists, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="ix11.html#api-index-0.9.0">0.9.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-photo"></a><h3>gdata_contacts_contact_get_photo ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint8"><span class="returnvalue">guint8</span></a> *
gdata_contacts_contact_get_photo (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataContactsService.html" title="GDataContactsService"><span class="type">GDataContactsService</span></a> *service</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **content_type</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Downloads and returns the contact's photo, if they have one. If the contact doesn't
have a photo (i.e. <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo-etag" title="gdata_contacts_contact_get_photo_etag ()"><code class="function">gdata_contacts_contact_get_photo_etag()</code></a> returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, but
no error is set in <em class="parameter"><code>error</code></em>
.</p>
<p>If <em class="parameter"><code>cancellable</code></em>
is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by triggering the <em class="parameter"><code>cancellable</code></em>
object from another thread.
If the operation was cancelled, the error <code class="literal">G_IO_ERROR_CANCELLED</code> will be returned.</p>
<p>If there is an error getting the photo, a <a class="link" href="GDataService.html#GDATA-SERVICE-ERROR-PROTOCOL-ERROR:CAPS"><code class="literal">GDATA_SERVICE_ERROR_PROTOCOL_ERROR</code></a> error will be returned.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-photo.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsService.html" title="GDataContactsService"><span class="type">GDataContactsService</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>length</p></td>
<td class="parameter_description"><p>return location for the image length, in bytes. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>content_type</p></td>
<td class="parameter_description"><p>return location for the image's content type, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; free with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-photo.returns"></a><h4>Returns</h4>
<p>the image data, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; free with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix10.html#api-index-0.8.0">0.8.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-photo-async"></a><h3>gdata_contacts_contact_get_photo_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_get_photo_async
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataContactsService.html" title="GDataContactsService"><span class="type">GDataContactsService</span></a> *service</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Downloads and returns the contact's photo, if they have one, asynchronously. <em class="parameter"><code>self</code></em>
and <em class="parameter"><code>service</code></em>
are both reffed when this function is called, so
can safely be unreffed after this function returns.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
will be called. You can then call <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo-finish" title="gdata_contacts_contact_get_photo_finish ()"><code class="function">gdata_contacts_contact_get_photo_finish()</code></a> to get the results of the
operation.</p>
<p>For more details, see <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo" title="gdata_contacts_contact_get_photo ()"><code class="function">gdata_contacts_contact_get_photo()</code></a>, which is the synchronous version of this function.</p>
<p>If <em class="parameter"><code>cancellable</code></em>
is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by triggering the <em class="parameter"><code>cancellable</code></em>
object from another thread.
If the operation was cancelled, the error <code class="literal">G_IO_ERROR_CANCELLED</code> will be returned by <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo-finish" title="gdata_contacts_contact_get_photo_finish ()"><code class="function">gdata_contacts_contact_get_photo_finish()</code></a>.</p>
<p>If there is an error getting the photo, a <a class="link" href="GDataService.html#GDATA-SERVICE-ERROR-PROTOCOL-ERROR:CAPS"><code class="literal">GDATA_SERVICE_ERROR_PROTOCOL_ERROR</code></a> error will be returned by <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo-finish" title="gdata_contacts_contact_get_photo_finish ()"><code class="function">gdata_contacts_contact_get_photo_finish()</code></a>.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-get-photo-async.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsService.html" title="GDataContactsService"><span class="type">GDataContactsService</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>a <span class="type">GAsyncReadyCallback</span> to call when the photo has been retrieved, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to pass to the <em class="parameter"><code>callback</code></em>
function. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix10.html#api-index-0.8.0">0.8.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-get-photo-finish"></a><h3>gdata_contacts_contact_get_photo_finish ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#guint8"><span class="returnvalue">guint8</span></a> *
gdata_contacts_contact_get_photo_finish
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *async_result</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> *length</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **content_type</code></em>,
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Finishes an asynchronous contact photo retrieval operation started with <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo-async" title="gdata_contacts_contact_get_photo_async ()"><code class="function">gdata_contacts_contact_get_photo_async()</code></a>. If the contact doesn't have a
photo (i.e. <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-get-photo-etag" title="gdata_contacts_contact_get_photo_etag ()"><code class="function">gdata_contacts_contact_get_photo_etag()</code></a> returns <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>), <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned, but no error is set in <em class="parameter"><code>error</code></em>
.</p>
<p>If there is an error getting the photo, a <a class="link" href="GDataService.html#GDATA-SERVICE-ERROR-PROTOCOL-ERROR:CAPS"><code class="literal">GDATA_SERVICE_ERROR_PROTOCOL_ERROR</code></a> error will be returned. <em class="parameter"><code>length</code></em>
will be set to</p>
<code class="code">0</code> and <em class="parameter"><code>content_type</code></em> will be set to <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
<div class="refsect3">
<a name="gdata-contacts-contact-get-photo-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>async_result</p></td>
<td class="parameter_description"><p>a <span class="type">GAsyncResult</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>length</p></td>
<td class="parameter_description"><p>return location for the image length, in bytes. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>content_type</p></td>
<td class="parameter_description"><p>return location for the image's content type, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; free with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-get-photo-finish.returns"></a><h4>Returns</h4>
<p>the image data, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>; free with <a href="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=length]</span></p>
</div>
<p class="since">Since: <a class="link" href="ix10.html#api-index-0.8.0">0.8.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-photo"></a><h3>gdata_contacts_contact_set_photo ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gdata_contacts_contact_set_photo (<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataContactsService.html" title="GDataContactsService"><span class="type">GDataContactsService</span></a> *service</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *data</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *content_type</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Sets the contact's photo to <em class="parameter"><code>data</code></em>
or, if <em class="parameter"><code>data</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, deletes the contact's photo. <em class="parameter"><code>content_type</code></em>
must be specified if <em class="parameter"><code>data</code></em>
is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
<p>If <em class="parameter"><code>cancellable</code></em>
is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by triggering the <em class="parameter"><code>cancellable</code></em>
object from another thread.
If the operation was cancelled, the error <code class="literal">G_IO_ERROR_CANCELLED</code> will be returned.</p>
<p>If there is an error setting the photo, a <a class="link" href="GDataService.html#GDATA-SERVICE-ERROR-PROTOCOL-ERROR:CAPS"><code class="literal">GDATA_SERVICE_ERROR_PROTOCOL_ERROR</code></a> error will be returned.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-photo.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsService.html" title="GDataContactsService"><span class="type">GDataContactsService</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p>the image data, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>length</p></td>
<td class="parameter_description"><p>the image length, in bytes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>content_type</p></td>
<td class="parameter_description"><p>the content type of the image, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-set-photo.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="ix10.html#api-index-0.8.0">0.8.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-photo-async"></a><h3>gdata_contacts_contact_set_photo_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdata_contacts_contact_set_photo_async
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GDataContactsService.html" title="GDataContactsService"><span class="type">GDataContactsService</span></a> *service</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#guint8"><span class="type">guint8</span></a> *data</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>,
<em class="parameter"><code>const <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *content_type</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Sets the contact's photo to <em class="parameter"><code>data</code></em>
or, if <em class="parameter"><code>data</code></em>
is <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, deletes the contact's photo. <em class="parameter"><code>content_type</code></em>
must be specified if <em class="parameter"><code>data</code></em>
is non-<a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <em class="parameter"><code>self</code></em>
,
<em class="parameter"><code>service</code></em>
, <em class="parameter"><code>data</code></em>
and <em class="parameter"><code>content_type</code></em>
are all reffed and copied when this function is called, so can safely be unreffed after this function returns.</p>
<p>When the operation is finished, <em class="parameter"><code>callback</code></em>
will be called. You can then call <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-photo-finish" title="gdata_contacts_contact_set_photo_finish ()"><code class="function">gdata_contacts_contact_set_photo_finish()</code></a> to get the results of the
operation.</p>
<p>For more details, see <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-photo" title="gdata_contacts_contact_set_photo ()"><code class="function">gdata_contacts_contact_set_photo()</code></a>, which is the synchronous version of this function.</p>
<p>If <em class="parameter"><code>cancellable</code></em>
is not <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, then the operation can be cancelled by triggering the <em class="parameter"><code>cancellable</code></em>
object from another thread.
If the operation was cancelled, the error <code class="literal">G_IO_ERROR_CANCELLED</code> will be returned by <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-photo-finish" title="gdata_contacts_contact_set_photo_finish ()"><code class="function">gdata_contacts_contact_set_photo_finish()</code></a>.</p>
<p>If there is an error setting the photo, a <a class="link" href="GDataService.html#GDATA-SERVICE-ERROR-PROTOCOL-ERROR:CAPS"><code class="literal">GDATA_SERVICE_ERROR_PROTOCOL_ERROR</code></a> error will be returned by <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-photo-finish" title="gdata_contacts_contact_set_photo_finish ()"><code class="function">gdata_contacts_contact_set_photo_finish()</code></a>.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-photo-async.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>service</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsService.html" title="GDataContactsService"><span class="type">GDataContactsService</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>data</p></td>
<td class="parameter_description"><p>the image data, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>length</p></td>
<td class="parameter_description"><p>the image length, in bytes</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>content_type</p></td>
<td class="parameter_description"><p>the content type of the image, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional <span class="type">GCancellable</span> object, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>a <span class="type">GAsyncReadyCallback</span> to call when the photo has been set, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>data to pass to the <em class="parameter"><code>callback</code></em>
function. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: <a class="link" href="ix10.html#api-index-0.8.0">0.8.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="gdata-contacts-contact-set-photo-finish"></a><h3>gdata_contacts_contact_set_photo_finish ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gdata_contacts_contact_set_photo_finish
(<em class="parameter"><code><a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *async_result</code></em>,
<em class="parameter"><code><a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Finishes an asynchronous contact photo setting operation started with <a class="link" href="GDataContactsContact.html#gdata-contacts-contact-set-photo-async" title="gdata_contacts_contact_set_photo_async ()"><code class="function">gdata_contacts_contact_set_photo_async()</code></a>.</p>
<p>If there is an error setting the photo, a <a class="link" href="GDataService.html#GDATA-SERVICE-ERROR-PROTOCOL-ERROR:CAPS"><code class="literal">GDATA_SERVICE_ERROR_PROTOCOL_ERROR</code></a> error will be returned.</p>
<div class="refsect3">
<a name="gdata-contacts-contact-set-photo-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>a <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>async_result</p></td>
<td class="parameter_description"><p>a <span class="type">GAsyncResult</span></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>a <a href="../glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gdata-contacts-contact-set-photo-finish.returns"></a><h4>Returns</h4>
<p> <a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on success, <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
</div>
<p class="since">Since: <a class="link" href="ix10.html#api-index-0.8.0">0.8.0</a></p>
</div>
</div>
<div class="refsect1">
<a name="GDataContactsContact.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GDATA-CONTACTS-GENDER-MALE:CAPS"></a><h3>GDATA_CONTACTS_GENDER_MALE</h3>
<pre class="programlisting">#define GDATA_CONTACTS_GENDER_MALE "male"
</pre>
<p>The contact is male.</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDATA-CONTACTS-GENDER-FEMALE:CAPS"></a><h3>GDATA_CONTACTS_GENDER_FEMALE</h3>
<pre class="programlisting">#define GDATA_CONTACTS_GENDER_FEMALE "female"
</pre>
<p>The contact is female.</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDATA-CONTACTS-PRIORITY-LOW:CAPS"></a><h3>GDATA_CONTACTS_PRIORITY_LOW</h3>
<pre class="programlisting">#define GDATA_CONTACTS_PRIORITY_LOW "low"
</pre>
<p>The contact is of low importance.</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDATA-CONTACTS-PRIORITY-NORMAL:CAPS"></a><h3>GDATA_CONTACTS_PRIORITY_NORMAL</h3>
<pre class="programlisting">#define GDATA_CONTACTS_PRIORITY_NORMAL "normal"
</pre>
<p>The contact is of normal importance.</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDATA-CONTACTS-PRIORITY-HIGH:CAPS"></a><h3>GDATA_CONTACTS_PRIORITY_HIGH</h3>
<pre class="programlisting">#define GDATA_CONTACTS_PRIORITY_HIGH "high"
</pre>
<p>The contact is of high importance.</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDATA-CONTACTS-SENSITIVITY-CONFIDENTIAL:CAPS"></a><h3>GDATA_CONTACTS_SENSITIVITY_CONFIDENTIAL</h3>
<pre class="programlisting">#define GDATA_CONTACTS_SENSITIVITY_CONFIDENTIAL "confidential"
</pre>
<p>The contact's data is confidential.</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDATA-CONTACTS-SENSITIVITY-NORMAL:CAPS"></a><h3>GDATA_CONTACTS_SENSITIVITY_NORMAL</h3>
<pre class="programlisting">#define GDATA_CONTACTS_SENSITIVITY_NORMAL "normal"
</pre>
<p>The contact's data is of normal sensitivity.</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDATA-CONTACTS-SENSITIVITY-PERSONAL:CAPS"></a><h3>GDATA_CONTACTS_SENSITIVITY_PERSONAL</h3>
<pre class="programlisting">#define GDATA_CONTACTS_SENSITIVITY_PERSONAL "personal"
</pre>
<p>The contact's data is personal.</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDATA-CONTACTS-SENSITIVITY-PRIVATE:CAPS"></a><h3>GDATA_CONTACTS_SENSITIVITY_PRIVATE</h3>
<pre class="programlisting">#define GDATA_CONTACTS_SENSITIVITY_PRIVATE "private"
</pre>
<p>The contact's data is private.</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact-struct"></a><h3>GDataContactsContact</h3>
<pre class="programlisting">typedef struct _GDataContactsContact GDataContactsContact;</pre>
<p>All the fields in the <a class="link" href="GDataContactsContact.html" title="GDataContactsContact"><span class="type">GDataContactsContact</span></a> structure are private and should never be accessed directly.</p>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContactClass"></a><h3>GDataContactsContactClass</h3>
<pre class="programlisting">typedef struct {
} GDataContactsContactClass;
</pre>
<p>All the fields in the <a class="link" href="GDataContactsContact.html#GDataContactsContactClass" title="GDataContactsContactClass"><span class="type">GDataContactsContactClass</span></a> structure are private and should never be accessed directly.</p>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
</div>
<div class="refsect1">
<a name="GDataContactsContact.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GDataContactsContact--billing-information"></a><h3>The <code class="literal">“billing-information”</code> property</h3>
<pre class="programlisting"> “billing-information” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>Billing information for the contact, such as their billing name and address.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--birthday"></a><h3>The <code class="literal">“birthday”</code> property</h3>
<pre class="programlisting"> “birthday” <a href="../glib/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *</pre>
<p>The contact's birthday.</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--birthday-has-year"></a><h3>The <code class="literal">“birthday-has-year”</code> property</h3>
<pre class="programlisting"> “birthday-has-year” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<p>Whether the contact's birthday includes their year of birth.</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--deleted"></a><h3>The <code class="literal">“deleted”</code> property</h3>
<pre class="programlisting"> “deleted” <a href="../glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre>
<p>Whether the entry has been deleted.</p>
<p>Flags: Read</p>
<p>Default value: FALSE</p>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--directory-server"></a><h3>The <code class="literal">“directory-server”</code> property</h3>
<pre class="programlisting"> “directory-server” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The name or address of a directory server associated with the contact.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--edited"></a><h3>The <code class="literal">“edited”</code> property</h3>
<pre class="programlisting"> “edited” <a href="../glib/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a></pre>
<p>The last time the contact was edited. If the contact has not been edited yet, the content indicates the time it was created.</p>
<p>For more information, see the <a class="ulink" href="http://www.atomenabled.org/developers/protocol/#appEdited" target="_top">
Atom Publishing Protocol specification</a>.</p>
<p>Flags: Read</p>
<p>Allowed values: >= -1</p>
<p>Default value: -1</p>
<p class="since">Since: <a class="link" href="ix04.html#api-index-0.2.0">0.2.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--file-as"></a><h3>The <code class="literal">“file-as”</code> property</h3>
<pre class="programlisting"> “file-as” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The name to file the contact under for sorting purposes.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix14.html#api-index-0.11.0">0.11.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--gender"></a><h3>The <code class="literal">“gender”</code> property</h3>
<pre class="programlisting"> “gender” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The gender of the contact. For example: <a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-GENDER-MALE:CAPS" title="GDATA_CONTACTS_GENDER_MALE"><code class="literal">GDATA_CONTACTS_GENDER_MALE</code></a> or <a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-GENDER-FEMALE:CAPS" title="GDATA_CONTACTS_GENDER_FEMALE"><code class="literal">GDATA_CONTACTS_GENDER_FEMALE</code></a>.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--initials"></a><h3>The <code class="literal">“initials”</code> property</h3>
<pre class="programlisting"> “initials” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The initials of the contact.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--maiden-name"></a><h3>The <code class="literal">“maiden-name”</code> property</h3>
<pre class="programlisting"> “maiden-name” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The maiden name of the contact.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--mileage"></a><h3>The <code class="literal">“mileage”</code> property</h3>
<pre class="programlisting"> “mileage” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>A mileage associated with the contact, such as one for reimbursement purposes. It can be in any format.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--name"></a><h3>The <code class="literal">“name”</code> property</h3>
<pre class="programlisting"> “name” <a class="link" href="GDataGDName.html" title="GDataGDName"><span class="type">GDataGDName</span></a> *</pre>
<p>The contact's name in a structured representation.</p>
<p>Flags: Read / Write</p>
<p class="since">Since: <a class="link" href="ix07.html#api-index-0.5.0">0.5.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--nickname"></a><h3>The <code class="literal">“nickname”</code> property</h3>
<pre class="programlisting"> “nickname” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The contact's chosen nickname.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--occupation"></a><h3>The <code class="literal">“occupation”</code> property</h3>
<pre class="programlisting"> “occupation” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The contact's occupation.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--photo-etag"></a><h3>The <code class="literal">“photo-etag”</code> property</h3>
<pre class="programlisting"> “photo-etag” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The ETag of the contact's photo, if the contact has a photo; <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> otherwise.</p>
<p>Flags: Read</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix11.html#api-index-0.9.0">0.9.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--priority"></a><h3>The <code class="literal">“priority”</code> property</h3>
<pre class="programlisting"> “priority” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The contact's importance. For example: <a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-PRIORITY-NORMAL:CAPS" title="GDATA_CONTACTS_PRIORITY_NORMAL"><code class="literal">GDATA_CONTACTS_PRIORITY_NORMAL</code></a> or <a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-PRIORITY-HIGH:CAPS" title="GDATA_CONTACTS_PRIORITY_HIGH"><code class="literal">GDATA_CONTACTS_PRIORITY_HIGH</code></a>.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--sensitivity"></a><h3>The <code class="literal">“sensitivity”</code> property</h3>
<pre class="programlisting"> “sensitivity” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The sensitivity of the contact's data. For example: <a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-SENSITIVITY-NORMAL:CAPS" title="GDATA_CONTACTS_SENSITIVITY_NORMAL"><code class="literal">GDATA_CONTACTS_SENSITIVITY_NORMAL</code></a> or <a class="link" href="GDataContactsContact.html#GDATA-CONTACTS-SENSITIVITY-PRIVATE:CAPS" title="GDATA_CONTACTS_SENSITIVITY_PRIVATE"><code class="literal">GDATA_CONTACTS_SENSITIVITY_PRIVATE</code></a>.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--short-name"></a><h3>The <code class="literal">“short-name”</code> property</h3>
<pre class="programlisting"> “short-name” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>A short name for the contact. This should be used for contracted versions of the contact's actual name,
whereas <a class="link" href="GDataContactsContact.html#GDataContactsContact--nickname" title="The “nickname” property"><span class="type">“nickname”</span></a> should be used for nicknames.</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GDataContactsContact--subject"></a><h3>The <code class="literal">“subject”</code> property</h3>
<pre class="programlisting"> “subject” <a href="../glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre>
<p>The subject of the contact. (i.e. The contact's relevance to the address book.)</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: <a class="link" href="ix09.html#api-index-0.7.0">0.7.0</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.26.1</div>
</body>
</html>