diff options
Diffstat (limited to 'gdata/services/contacts/gdata-contacts-contact.c')
| -rw-r--r-- | gdata/services/contacts/gdata-contacts-contact.c | 120 |
1 files changed, 120 insertions, 0 deletions
diff --git a/gdata/services/contacts/gdata-contacts-contact.c b/gdata/services/contacts/gdata-contacts-contact.c index eb4148d0..5637c40e 100644 --- a/gdata/services/contacts/gdata-contacts-contact.c +++ b/gdata/services/contacts/gdata-contacts-contact.c @@ -144,6 +144,7 @@ * </example> * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ #include <config.h> @@ -158,6 +159,8 @@ #include "gdata-private.h" #include "gdata-comparable.h" +G_GNUC_BEGIN_IGNORE_DEPRECATIONS + /* The maximum number of extended properties the server allows us. See * http://code.google.com/apis/contacts/docs/2.0/reference.html#ProjectionsAndExtended. * When updating this, make sure to update the API documentation for gdata_contacts_contact_get_extended_property() @@ -265,6 +268,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * Atom Publishing Protocol specification</ulink>. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_EDITED, g_param_spec_int64 ("edited", @@ -278,6 +282,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * Whether the entry has been deleted. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_DELETED, g_param_spec_boolean ("deleted", @@ -291,6 +296,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The ETag of the contact's photo, if the contact has a photo; %NULL otherwise. * * Since: 0.9.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_PHOTO_ETAG, g_param_spec_string ("photo-etag", @@ -304,6 +310,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The contact's name in a structured representation. * * Since: 0.5.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_NAME, g_param_spec_object ("name", @@ -317,6 +324,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The contact's chosen nickname. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_NICKNAME, g_param_spec_string ("nickname", @@ -330,6 +338,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The name to file the contact under for sorting purposes. * * Since: 0.11.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_FILE_AS, g_param_spec_string ("file-as", @@ -343,6 +352,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The contact's birthday. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_BIRTHDAY, g_param_spec_boxed ("birthday", @@ -356,6 +366,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * Whether the contact's birthday includes their year of birth. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_BIRTHDAY_HAS_YEAR, g_param_spec_boolean ("birthday-has-year", @@ -369,6 +380,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * Billing information for the contact, such as their billing name and address. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_BILLING_INFORMATION, g_param_spec_string ("billing-information", @@ -382,6 +394,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The name or address of a directory server associated with the contact. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_DIRECTORY_SERVER, g_param_spec_string ("directory-server", @@ -395,6 +408,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The gender of the contact. For example: %GDATA_CONTACTS_GENDER_MALE or %GDATA_CONTACTS_GENDER_FEMALE. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_GENDER, g_param_spec_string ("gender", @@ -408,6 +422,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The initials of the contact. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_INITIALS, g_param_spec_string ("initials", @@ -421,6 +436,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The maiden name of the contact. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_MAIDEN_NAME, g_param_spec_string ("maiden-name", @@ -434,6 +450,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * A mileage associated with the contact, such as one for reimbursement purposes. It can be in any format. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_MILEAGE, g_param_spec_string ("mileage", @@ -447,6 +464,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The contact's occupation. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_OCCUPATION, g_param_spec_string ("occupation", @@ -460,6 +478,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The contact's importance. For example: %GDATA_CONTACTS_PRIORITY_NORMAL or %GDATA_CONTACTS_PRIORITY_HIGH. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_PRIORITY, g_param_spec_string ("priority", @@ -473,6 +492,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The sensitivity of the contact's data. For example: %GDATA_CONTACTS_SENSITIVITY_NORMAL or %GDATA_CONTACTS_SENSITIVITY_PRIVATE. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_SENSITIVITY, g_param_spec_string ("sensitivity", @@ -487,6 +507,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * whereas #GDataContactsContact:nickname should be used for nicknames. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_SHORT_NAME, g_param_spec_string ("short-name", @@ -500,6 +521,7 @@ gdata_contacts_contact_class_init (GDataContactsContactClass *klass) * The subject of the contact. (i.e. The contact's relevance to the address book.) * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ g_object_class_install_property (gobject_class, PROP_SUBJECT, g_param_spec_string ("subject", @@ -1255,6 +1277,7 @@ get_entry_uri (const gchar *id) * Return value: a new #GDataContactsContact; unref with g_object_unref() * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataContactsContact * gdata_contacts_contact_new (const gchar *id) @@ -1271,6 +1294,7 @@ gdata_contacts_contact_new (const gchar *id) * Return value: the UNIX timestamp for the time the contact was last edited, or <code class="literal">-1</code> * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ gint64 gdata_contacts_contact_get_edited (GDataContactsContact *self) @@ -1288,6 +1312,7 @@ gdata_contacts_contact_get_edited (GDataContactsContact *self) * Return value: (transfer none): the contact's name, or %NULL * * Since: 0.5.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataGDName * gdata_contacts_contact_get_name (GDataContactsContact *self) @@ -1306,6 +1331,7 @@ gdata_contacts_contact_get_name (GDataContactsContact *self) * @name must not be %NULL, though all its properties may be %NULL. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_name (GDataContactsContact *self, GDataGDName *name) @@ -1331,6 +1357,7 @@ gdata_contacts_contact_set_name (GDataContactsContact *self, GDataGDName *name) * Return value: the contact's nickname, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_nickname (GDataContactsContact *self) @@ -1349,6 +1376,7 @@ gdata_contacts_contact_get_nickname (GDataContactsContact *self) * If @nickname is %NULL, the contact's nickname will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_nickname (GDataContactsContact *self, const gchar *nickname) @@ -1369,6 +1397,7 @@ gdata_contacts_contact_set_nickname (GDataContactsContact *self, const gchar *ni * Return value: the name the contact's filed under, or %NULL * * Since: 0.11.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_file_as (GDataContactsContact *self) @@ -1387,6 +1416,7 @@ gdata_contacts_contact_get_file_as (GDataContactsContact *self) * If @file_as is %NULL, the contact will be filed under their full name. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_file_as (GDataContactsContact *self, const gchar *file_as) @@ -1411,6 +1441,7 @@ gdata_contacts_contact_set_file_as (GDataContactsContact *self, const gchar *fil * Return value: whether the contact's birthday has the year set * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ gboolean gdata_contacts_contact_get_birthday (GDataContactsContact *self, GDate *birthday) @@ -1434,6 +1465,7 @@ gdata_contacts_contact_get_birthday (GDataContactsContact *self, GDate *birthday * If @birthday is %NULL, the contact's birthday will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_birthday (GDataContactsContact *self, GDate *birthday, gboolean birthday_has_year) @@ -1463,6 +1495,7 @@ gdata_contacts_contact_set_birthday (GDataContactsContact *self, GDate *birthday * Return value: the contact's billing information, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_billing_information (GDataContactsContact *self) @@ -1481,6 +1514,7 @@ gdata_contacts_contact_get_billing_information (GDataContactsContact *self) * If @billing_information is %NULL, the contact's billing information will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_billing_information (GDataContactsContact *self, const gchar *billing_information) @@ -1502,6 +1536,7 @@ gdata_contacts_contact_set_billing_information (GDataContactsContact *self, cons * Return value: the name or address of a directory server associated with the contact, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_directory_server (GDataContactsContact *self) @@ -1520,6 +1555,7 @@ gdata_contacts_contact_get_directory_server (GDataContactsContact *self) * If @directory_server is %NULL, the contact's directory server will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_directory_server (GDataContactsContact *self, const gchar *directory_server) @@ -1541,6 +1577,7 @@ gdata_contacts_contact_set_directory_server (GDataContactsContact *self, const g * Return value: the gender of the contact, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_gender (GDataContactsContact *self) @@ -1559,6 +1596,7 @@ gdata_contacts_contact_get_gender (GDataContactsContact *self) * If @gender is %NULL, the contact's gender will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_gender (GDataContactsContact *self, const gchar *gender) @@ -1580,6 +1618,7 @@ gdata_contacts_contact_set_gender (GDataContactsContact *self, const gchar *gend * Return value: the initials of the contact, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_initials (GDataContactsContact *self) @@ -1598,6 +1637,7 @@ gdata_contacts_contact_get_initials (GDataContactsContact *self) * If @initials is %NULL, the contact's initials will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_initials (GDataContactsContact *self, const gchar *initials) @@ -1618,6 +1658,7 @@ gdata_contacts_contact_set_initials (GDataContactsContact *self, const gchar *in * Return value: the maiden name of the contact, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_maiden_name (GDataContactsContact *self) @@ -1636,6 +1677,7 @@ gdata_contacts_contact_get_maiden_name (GDataContactsContact *self) * If @maiden_name is %NULL, the contact's maiden name will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_maiden_name (GDataContactsContact *self, const gchar *maiden_name) @@ -1656,6 +1698,7 @@ gdata_contacts_contact_set_maiden_name (GDataContactsContact *self, const gchar * Return value: a mileage associated with the contact, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_mileage (GDataContactsContact *self) @@ -1674,6 +1717,7 @@ gdata_contacts_contact_get_mileage (GDataContactsContact *self) * If @mileage is %NULL, the contact's mileage will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_mileage (GDataContactsContact *self, const gchar *mileage) @@ -1694,6 +1738,7 @@ gdata_contacts_contact_set_mileage (GDataContactsContact *self, const gchar *mil * Return value: the contact's occupation, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_occupation (GDataContactsContact *self) @@ -1712,6 +1757,7 @@ gdata_contacts_contact_get_occupation (GDataContactsContact *self) * If @occupation is %NULL, the contact's occupation will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_occupation (GDataContactsContact *self, const gchar *occupation) @@ -1732,6 +1778,7 @@ gdata_contacts_contact_set_occupation (GDataContactsContact *self, const gchar * * Return value: the contact's priority, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_priority (GDataContactsContact *self) @@ -1750,6 +1797,7 @@ gdata_contacts_contact_get_priority (GDataContactsContact *self) * If @priority is %NULL, the contact's priority will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_priority (GDataContactsContact *self, const gchar *priority) @@ -1771,6 +1819,7 @@ gdata_contacts_contact_set_priority (GDataContactsContact *self, const gchar *pr * Return value: the contact's sensitivity, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_sensitivity (GDataContactsContact *self) @@ -1789,6 +1838,7 @@ gdata_contacts_contact_get_sensitivity (GDataContactsContact *self) * If @sensitivity is %NULL, the contact's sensitivity will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_sensitivity (GDataContactsContact *self, const gchar *sensitivity) @@ -1810,6 +1860,7 @@ gdata_contacts_contact_set_sensitivity (GDataContactsContact *self, const gchar * Return value: the contact's short name, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_short_name (GDataContactsContact *self) @@ -1828,6 +1879,7 @@ gdata_contacts_contact_get_short_name (GDataContactsContact *self) * If @short_name is %NULL, the contact's short name will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_short_name (GDataContactsContact *self, const gchar *short_name) @@ -1848,6 +1900,7 @@ gdata_contacts_contact_set_short_name (GDataContactsContact *self, const gchar * * Return value: the contact's subject, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_subject (GDataContactsContact *self) @@ -1866,6 +1919,7 @@ gdata_contacts_contact_get_subject (GDataContactsContact *self) * If @subject is %NULL, the contact's subject will be removed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_subject (GDataContactsContact *self, const gchar *subject) @@ -1891,6 +1945,7 @@ gdata_contacts_contact_set_subject (GDataContactsContact *self, const gchar *sub * Duplicate e-mail addresses will not be added to the list. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_email_address (GDataContactsContact *self, GDataGDEmailAddress *email_address) @@ -1911,6 +1966,7 @@ gdata_contacts_contact_add_email_address (GDataContactsContact *self, GDataGDEma * Return value: (element-type GData.GDEmailAddress) (transfer none): a #GList of #GDataGDEmailAddress<!-- -->es, or %NULL * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_email_addresses (GDataContactsContact *self) @@ -1928,6 +1984,7 @@ gdata_contacts_contact_get_email_addresses (GDataContactsContact *self) * Return value: (transfer none): a #GDataGDEmailAddress, or %NULL * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataGDEmailAddress * gdata_contacts_contact_get_primary_email_address (GDataContactsContact *self) @@ -1951,6 +2008,7 @@ gdata_contacts_contact_get_primary_email_address (GDataContactsContact *self) * Removes all e-mail addresses from the contact. * * Since: 0.4.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_email_addresses (GDataContactsContact *self) @@ -1977,6 +2035,7 @@ gdata_contacts_contact_remove_all_email_addresses (GDataContactsContact *self) * Duplicate IM addresses will not be added to the list. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_im_address (GDataContactsContact *self, GDataGDIMAddress *im_address) @@ -1997,6 +2056,7 @@ gdata_contacts_contact_add_im_address (GDataContactsContact *self, GDataGDIMAddr * Return value: (element-type GData.GDIMAddress) (transfer none): a #GList of #GDataGDIMAddress<!-- -->es, or %NULL * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_im_addresses (GDataContactsContact *self) @@ -2014,6 +2074,7 @@ gdata_contacts_contact_get_im_addresses (GDataContactsContact *self) * Return value: (transfer none): a #GDataGDIMAddress, or %NULL * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataGDIMAddress * gdata_contacts_contact_get_primary_im_address (GDataContactsContact *self) @@ -2037,6 +2098,7 @@ gdata_contacts_contact_get_primary_im_address (GDataContactsContact *self) * Removes all IM addresses from the contact. * * Since: 0.4.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_im_addresses (GDataContactsContact *self) @@ -2063,6 +2125,7 @@ gdata_contacts_contact_remove_all_im_addresses (GDataContactsContact *self) * Duplicate phone numbers will not be added to the list. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_phone_number (GDataContactsContact *self, GDataGDPhoneNumber *phone_number) @@ -2083,6 +2146,7 @@ gdata_contacts_contact_add_phone_number (GDataContactsContact *self, GDataGDPhon * Return value: (element-type GData.GDPhoneNumber) (transfer none): a #GList of #GDataGDPhoneNumbers, or %NULL * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_phone_numbers (GDataContactsContact *self) @@ -2100,6 +2164,7 @@ gdata_contacts_contact_get_phone_numbers (GDataContactsContact *self) * Return value: (transfer none): a #GDataGDPhoneNumber, or %NULL * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataGDPhoneNumber * gdata_contacts_contact_get_primary_phone_number (GDataContactsContact *self) @@ -2123,6 +2188,7 @@ gdata_contacts_contact_get_primary_phone_number (GDataContactsContact *self) * Removes all phone numbers from the contact. * * Since: 0.4.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_phone_numbers (GDataContactsContact *self) @@ -2149,6 +2215,7 @@ gdata_contacts_contact_remove_all_phone_numbers (GDataContactsContact *self) * Duplicate postal addresses will not be added to the list. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_postal_address (GDataContactsContact *self, GDataGDPostalAddress *postal_address) @@ -2169,6 +2236,7 @@ gdata_contacts_contact_add_postal_address (GDataContactsContact *self, GDataGDPo * Return value: (element-type GData.GDPostalAddress) (transfer none): a #GList of #GDataGDPostalAddress<!-- -->es, or %NULL * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_postal_addresses (GDataContactsContact *self) @@ -2186,6 +2254,7 @@ gdata_contacts_contact_get_postal_addresses (GDataContactsContact *self) * Return value: (transfer none): a #GDataGDPostalAddress, or %NULL * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataGDPostalAddress * gdata_contacts_contact_get_primary_postal_address (GDataContactsContact *self) @@ -2209,6 +2278,7 @@ gdata_contacts_contact_get_primary_postal_address (GDataContactsContact *self) * Removes all postal addresses from the contact. * * Since: 0.4.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_postal_addresses (GDataContactsContact *self) @@ -2235,6 +2305,7 @@ gdata_contacts_contact_remove_all_postal_addresses (GDataContactsContact *self) * Duplicate organizations will not be added to the list. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_organization (GDataContactsContact *self, GDataGDOrganization *organization) @@ -2255,6 +2326,7 @@ gdata_contacts_contact_add_organization (GDataContactsContact *self, GDataGDOrga * Return value: (element-type GData.GDOrganization) (transfer none): a #GList of #GDataGDOrganizations, or %NULL * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_organizations (GDataContactsContact *self) @@ -2272,6 +2344,7 @@ gdata_contacts_contact_get_organizations (GDataContactsContact *self) * Return value: (transfer none): a #GDataGDOrganization, or %NULL * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataGDOrganization * gdata_contacts_contact_get_primary_organization (GDataContactsContact *self) @@ -2295,6 +2368,7 @@ gdata_contacts_contact_get_primary_organization (GDataContactsContact *self) * Removes all organizations from the contact. * * Since: 0.4.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_organizations (GDataContactsContact *self) @@ -2317,6 +2391,7 @@ gdata_contacts_contact_remove_all_organizations (GDataContactsContact *self) * Duplicate jots will be added to the list, and multiple jots with the same relation type can be added to a single contact. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_jot (GDataContactsContact *self, GDataGContactJot *jot) @@ -2336,6 +2411,7 @@ gdata_contacts_contact_add_jot (GDataContactsContact *self, GDataGContactJot *jo * Return value: (element-type GData.GContactJot) (transfer none): a #GList of #GDataGContactJots, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_jots (GDataContactsContact *self) @@ -2351,6 +2427,7 @@ gdata_contacts_contact_get_jots (GDataContactsContact *self) * Removes all jots from the contact. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_jots (GDataContactsContact *self) @@ -2374,6 +2451,7 @@ gdata_contacts_contact_remove_all_jots (GDataContactsContact *self) * Though it may not make sense for some relation types to be repeated, adding them is allowed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_relation (GDataContactsContact *self, GDataGContactRelation *relation) @@ -2393,6 +2471,7 @@ gdata_contacts_contact_add_relation (GDataContactsContact *self, GDataGContactRe * Return value: (element-type GData.GContactRelation) (transfer none): a #GList of #GDataGContactRelations, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_relations (GDataContactsContact *self) @@ -2408,6 +2487,7 @@ gdata_contacts_contact_get_relations (GDataContactsContact *self) * Removes all relations from the contact. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_relations (GDataContactsContact *self) @@ -2431,6 +2511,7 @@ gdata_contacts_contact_remove_all_relations (GDataContactsContact *self) * relation types or labels. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_website (GDataContactsContact *self, GDataGContactWebsite *website) @@ -2451,6 +2532,7 @@ gdata_contacts_contact_add_website (GDataContactsContact *self, GDataGContactWeb * Return value: (element-type GData.GContactWebsite) (transfer none): a #GList of #GDataGContactWebsites, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_websites (GDataContactsContact *self) @@ -2468,6 +2550,7 @@ gdata_contacts_contact_get_websites (GDataContactsContact *self) * Return value: (transfer none): a #GDataGContactWebsite, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataGContactWebsite * gdata_contacts_contact_get_primary_website (GDataContactsContact *self) @@ -2491,6 +2574,7 @@ gdata_contacts_contact_get_primary_website (GDataContactsContact *self) * Removes all websites from the contact. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_websites (GDataContactsContact *self) @@ -2514,6 +2598,7 @@ gdata_contacts_contact_remove_all_websites (GDataContactsContact *self) * Though it may not make sense for some event types to be repeated, adding them is allowed. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_event (GDataContactsContact *self, GDataGContactEvent *event) @@ -2533,6 +2618,7 @@ gdata_contacts_contact_add_event (GDataContactsContact *self, GDataGContactEvent * Return value: (element-type GData.GContactEvent) (transfer none): a #GList of #GDataGContactEvents, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_events (GDataContactsContact *self) @@ -2548,6 +2634,7 @@ gdata_contacts_contact_get_events (GDataContactsContact *self) * Removes all events from the contact. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_events (GDataContactsContact *self) @@ -2571,6 +2658,7 @@ gdata_contacts_contact_remove_all_events (GDataContactsContact *self) * relation types or labels. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_calendar (GDataContactsContact *self, GDataGContactCalendar *calendar) @@ -2591,6 +2679,7 @@ gdata_contacts_contact_add_calendar (GDataContactsContact *self, GDataGContactCa * Return value: (element-type GData.GContactCalendar) (transfer none): a #GList of #GDataGContactCalendars, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_calendars (GDataContactsContact *self) @@ -2608,6 +2697,7 @@ gdata_contacts_contact_get_calendars (GDataContactsContact *self) * Return value: (transfer none): a #GDataGContactCalendar, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataGContactCalendar * gdata_contacts_contact_get_primary_calendar (GDataContactsContact *self) @@ -2631,6 +2721,7 @@ gdata_contacts_contact_get_primary_calendar (GDataContactsContact *self) * Removes all calendars from the contact. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_calendars (GDataContactsContact *self) @@ -2653,6 +2744,7 @@ gdata_contacts_contact_remove_all_calendars (GDataContactsContact *self) * Duplicate IDs will not be added to the list. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_external_id (GDataContactsContact *self, GDataGContactExternalID *external_id) @@ -2673,6 +2765,7 @@ gdata_contacts_contact_add_external_id (GDataContactsContact *self, GDataGContac * Return value: (element-type GData.GContactExternalID) (transfer none): a #GList of #GDataGContactExternalIDs, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_external_ids (GDataContactsContact *self) @@ -2688,6 +2781,7 @@ gdata_contacts_contact_get_external_ids (GDataContactsContact *self) * Removes all external IDs from the contact. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_external_ids (GDataContactsContact *self) @@ -2710,6 +2804,7 @@ gdata_contacts_contact_remove_all_external_ids (GDataContactsContact *self) * Duplicate hobbies will not be added to the list. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_hobby (GDataContactsContact *self, const gchar *hobby) @@ -2730,6 +2825,7 @@ gdata_contacts_contact_add_hobby (GDataContactsContact *self, const gchar *hobby * Return value: (element-type utf8) (transfer none): a #GList of hobby strings, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_hobbies (GDataContactsContact *self) @@ -2745,6 +2841,7 @@ gdata_contacts_contact_get_hobbies (GDataContactsContact *self) * Removes all hobbies from the contact. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_hobbies (GDataContactsContact *self) @@ -2767,6 +2864,7 @@ gdata_contacts_contact_remove_all_hobbies (GDataContactsContact *self) * Duplicate languages will not be added to the list. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_language (GDataContactsContact *self, GDataGContactLanguage *language) @@ -2787,6 +2885,7 @@ gdata_contacts_contact_add_language (GDataContactsContact *self, GDataGContactLa * Return value: (element-type GData.GContactLanguage) (transfer none): a #GList of #GDataGContactLanguages, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_languages (GDataContactsContact *self) @@ -2802,6 +2901,7 @@ gdata_contacts_contact_get_languages (GDataContactsContact *self) * Removes all languages from the contact. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_all_languages (GDataContactsContact *self) @@ -2825,6 +2925,7 @@ gdata_contacts_contact_remove_all_languages (GDataContactsContact *self) * Return value: the property's value, or %NULL * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_extended_property (GDataContactsContact *self, const gchar *name) @@ -2843,6 +2944,7 @@ gdata_contacts_contact_get_extended_property (GDataContactsContact *self, const * Return value: (transfer none): a #GHashTable of extended properties * * Since: 0.4.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GHashTable * gdata_contacts_contact_get_extended_properties (GDataContactsContact *self) @@ -2870,6 +2972,7 @@ gdata_contacts_contact_get_extended_properties (GDataContactsContact *self) * Return value: %TRUE if the property was updated or deleted successfully, %FALSE otherwise * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ gboolean gdata_contacts_contact_set_extended_property (GDataContactsContact *self, const gchar *name, const gchar *value) @@ -2909,6 +3012,7 @@ gdata_contacts_contact_set_extended_property (GDataContactsContact *self, const * Return value: the field's value, or %NULL * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_user_defined_field (GDataContactsContact *self, const gchar *name) @@ -2927,6 +3031,7 @@ gdata_contacts_contact_get_user_defined_field (GDataContactsContact *self, const * Return value: (transfer none): a #GHashTable of user-defined fields * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GHashTable * gdata_contacts_contact_get_user_defined_fields (GDataContactsContact *self) @@ -2949,6 +3054,7 @@ gdata_contacts_contact_get_user_defined_fields (GDataContactsContact *self) * To unset a field, set @value to %NULL. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_user_defined_field (GDataContactsContact *self, const gchar *name, const gchar *value) @@ -2973,6 +3079,7 @@ gdata_contacts_contact_set_user_defined_field (GDataContactsContact *self, const * Adds the contact to the given group. @href should be a URI. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_add_group (GDataContactsContact *self, const gchar *href) @@ -2990,6 +3097,7 @@ gdata_contacts_contact_add_group (GDataContactsContact *self, const gchar *href) * Removes the contact from the given group. @href should be a URI. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_remove_group (GDataContactsContact *self, const gchar *href) @@ -3014,6 +3122,7 @@ gdata_contacts_contact_remove_group (GDataContactsContact *self, const gchar *hr * Return value: %TRUE if the contact has recently been removed from the group, %FALSE otherwise * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ gboolean gdata_contacts_contact_is_group_deleted (GDataContactsContact *self, const gchar *href) @@ -3032,6 +3141,7 @@ gdata_contacts_contact_is_group_deleted (GDataContactsContact *self, const gchar * Return value: (element-type utf8) (transfer container): a #GList of constant group ID URIs, or %NULL; free with g_list_free() * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GList * gdata_contacts_contact_get_groups (GDataContactsContact *self) @@ -3070,6 +3180,7 @@ gdata_contacts_contact_get_groups (GDataContactsContact *self) * Return value: %TRUE if the contact has been deleted, %FALSE otherwise * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ gboolean gdata_contacts_contact_is_deleted (GDataContactsContact *self) @@ -3089,6 +3200,7 @@ gdata_contacts_contact_is_deleted (GDataContactsContact *self) * Return value: the contact's photo's ETag if it exists, %NULL otherwise * * Since: 0.9.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_contact_get_photo_etag (GDataContactsContact *self) @@ -3118,6 +3230,7 @@ gdata_contacts_contact_get_photo_etag (GDataContactsContact *self) * Return value: (transfer full) (array length=length): the image data, or %NULL; free with g_free() * * Since: 0.8.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ guint8 * gdata_contacts_contact_get_photo (GDataContactsContact *self, GDataContactsService *service, gsize *length, gchar **content_type, @@ -3238,6 +3351,7 @@ get_photo_thread (GTask *task, gpointer source_object, gpointer task_data, GCanc * If there is an error getting the photo, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned by gdata_contacts_contact_get_photo_finish(). * * Since: 0.8.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_get_photo_async (GDataContactsContact *self, GDataContactsService *service, GCancellable *cancellable, @@ -3273,6 +3387,7 @@ gdata_contacts_contact_get_photo_async (GDataContactsContact *self, GDataContact * Return value: (transfer full) (array length=length): the image data, or %NULL; free with g_free() * * Since: 0.8.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ guint8 * gdata_contacts_contact_get_photo_finish (GDataContactsContact *self, GAsyncResult *async_result, gsize *length, gchar **content_type, GError **error) @@ -3326,6 +3441,7 @@ gdata_contacts_contact_get_photo_finish (GDataContactsContact *self, GAsyncResul * Return value: %TRUE on success, %FALSE otherwise * * Since: 0.8.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ gboolean gdata_contacts_contact_set_photo (GDataContactsContact *self, GDataContactsService *service, const guint8 *data, gsize length, @@ -3430,6 +3546,7 @@ set_photo_thread (GTask *task, gpointer source_object, gpointer task_data, GCanc * If there is an error setting the photo, a %GDATA_SERVICE_ERROR_PROTOCOL_ERROR error will be returned by gdata_contacts_contact_set_photo_finish(). * * Since: 0.8.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_contact_set_photo_async (GDataContactsContact *self, GDataContactsService *service, const guint8 *data, gsize length, @@ -3469,6 +3586,7 @@ gdata_contacts_contact_set_photo_async (GDataContactsContact *self, GDataContact * Return value: %TRUE on success, %FALSE otherwise * * Since: 0.8.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ gboolean gdata_contacts_contact_set_photo_finish (GDataContactsContact *self, GAsyncResult *async_result, GError **error) @@ -3481,3 +3599,5 @@ gdata_contacts_contact_set_photo_finish (GDataContactsContact *self, GAsyncResul return g_task_propagate_boolean (G_TASK (async_result), error); } + +G_GNUC_END_IGNORE_DEPRECATIONS |