From c35a89f6fadb669c464e569a594160f90b2f0c26 Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Thu, 17 Jun 2021 13:13:28 +0100 Subject: contacts: Deprecate the entire Contacts API as Google is ending it MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Contacts API server will return error responses with increasing frequency until all responses are errors in December 2021. https://developers.google.com/contacts/v3/announcement They are replacing it with the People API (why can’t they provide backwards-compatibility?), but I don’t have the time to port the libgdata Contacts service to the new People API. More crucially, I don’t have time to maintain such a port in the future. https://developers.google.com/people Handily, the CardDAV API for accessing contact data is still explicitly supported by Google Contacts, so people should use that instead. At least it’s a standard protocol, with a variety of conformant implementations already released and maintained; and not just another here-today-gone-tomorrow Google REST API. https://developers.google.com/people/carddav Using CardDAV requires OAuth 2 authorization, just like the Contacts API did. So, bearing all the above in mind, the libgdata Contacts service is now deprecated in favour of using CardDAV. Signed-off-by: Philip Withnall Fixes: #42 --- gdata/gdata-goa-authorizer.c | 2 + gdata/services/contacts/gdata-contacts-contact.c | 120 +++++++++++++++++++++++ gdata/services/contacts/gdata-contacts-contact.h | 97 ++++++++++++++++++ gdata/services/contacts/gdata-contacts-group.c | 15 +++ gdata/services/contacts/gdata-contacts-group.h | 8 ++ gdata/services/contacts/gdata-contacts-query.c | 19 ++++ gdata/services/contacts/gdata-contacts-query.h | 11 +++ gdata/services/contacts/gdata-contacts-service.c | 21 ++++ gdata/services/contacts/gdata-contacts-service.h | 11 +++ gdata/tests/contacts.c | 4 + gdata/tests/oauth1-authorizer.c | 5 + 11 files changed, 313 insertions(+) diff --git a/gdata/gdata-goa-authorizer.c b/gdata/gdata-goa-authorizer.c index b6b33c71..b7ae12a0 100644 --- a/gdata/gdata-goa-authorizer.c +++ b/gdata/gdata-goa-authorizer.c @@ -181,9 +181,11 @@ gdata_goa_authorizer_set_goa_object (GDataGoaAuthorizer *self, GoaObject *goa_ob add_authorization_domains (self, GDATA_TYPE_CALENDAR_SERVICE); } + G_GNUC_BEGIN_IGNORE_DEPRECATIONS if (goa_object_peek_contacts (goa_object) != NULL) { add_authorization_domains (self, GDATA_TYPE_CONTACTS_SERVICE); } + G_GNUC_END_IGNORE_DEPRECATIONS if (goa_object_peek_documents (goa_object) != NULL || goa_object_peek_files (goa_object) != NULL) { add_authorization_domains (self, GDATA_TYPE_DOCUMENTS_SERVICE); 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 @@ * * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ #include @@ -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. * * 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 -1 * * 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 #GDataGDEmailAddresses, 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 #GDataGDIMAddresses, 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 #GDataGDPostalAddresses, 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 diff --git a/gdata/services/contacts/gdata-contacts-contact.h b/gdata/services/contacts/gdata-contacts-contact.h index b84daa73..29095412 100644 --- a/gdata/services/contacts/gdata-contacts-contact.h +++ b/gdata/services/contacts/gdata-contacts-contact.h @@ -159,145 +159,242 @@ typedef struct { void (*_g_reserved1) (void); } GDataContactsContactClass; +G_DEPRECATED GType gdata_contacts_contact_get_type (void) G_GNUC_CONST; +G_DEPRECATED GDataContactsContact *gdata_contacts_contact_new (const gchar *id) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; +G_DEPRECATED gint64 gdata_contacts_contact_get_edited (GDataContactsContact *self); +G_DEPRECATED gboolean gdata_contacts_contact_is_deleted (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED GDataGDName *gdata_contacts_contact_get_name (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_name (GDataContactsContact *self, GDataGDName *name); +G_DEPRECATED const gchar *gdata_contacts_contact_get_nickname (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_nickname (GDataContactsContact *self, const gchar *nickname); +G_DEPRECATED const gchar *gdata_contacts_contact_get_file_as (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_file_as (GDataContactsContact *self, const gchar *file_as); +G_DEPRECATED gboolean gdata_contacts_contact_get_birthday (GDataContactsContact *self, GDate *birthday) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_birthday (GDataContactsContact *self, GDate *birthday, gboolean birthday_has_year); +G_DEPRECATED const gchar *gdata_contacts_contact_get_billing_information (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_billing_information (GDataContactsContact *self, const gchar *billing_information); +G_DEPRECATED const gchar *gdata_contacts_contact_get_directory_server (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_directory_server (GDataContactsContact *self, const gchar *directory_server); +G_DEPRECATED const gchar *gdata_contacts_contact_get_gender (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_gender (GDataContactsContact *self, const gchar *gender); +G_DEPRECATED const gchar *gdata_contacts_contact_get_initials (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_initials (GDataContactsContact *self, const gchar *initials); +G_DEPRECATED const gchar *gdata_contacts_contact_get_maiden_name (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_maiden_name (GDataContactsContact *self, const gchar *maiden_name); +G_DEPRECATED const gchar *gdata_contacts_contact_get_mileage (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_mileage (GDataContactsContact *self, const gchar *mileage); +G_DEPRECATED const gchar *gdata_contacts_contact_get_occupation (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_occupation (GDataContactsContact *self, const gchar *occupation); +G_DEPRECATED const gchar *gdata_contacts_contact_get_priority (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_priority (GDataContactsContact *self, const gchar *priority); +G_DEPRECATED const gchar *gdata_contacts_contact_get_sensitivity (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_sensitivity (GDataContactsContact *self, const gchar *sensitivity); +G_DEPRECATED const gchar *gdata_contacts_contact_get_short_name (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_short_name (GDataContactsContact *self, const gchar *short_name); +G_DEPRECATED const gchar *gdata_contacts_contact_get_subject (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_subject (GDataContactsContact *self, const gchar *subject); +G_DEPRECATED void gdata_contacts_contact_add_email_address (GDataContactsContact *self, GDataGDEmailAddress *email_address); +G_DEPRECATED GList *gdata_contacts_contact_get_email_addresses (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED GDataGDEmailAddress *gdata_contacts_contact_get_primary_email_address (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_email_addresses (GDataContactsContact *self); +G_DEPRECATED void gdata_contacts_contact_add_im_address (GDataContactsContact *self, GDataGDIMAddress *im_address); +G_DEPRECATED GList *gdata_contacts_contact_get_im_addresses (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED GDataGDIMAddress *gdata_contacts_contact_get_primary_im_address (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_im_addresses (GDataContactsContact *self); +G_DEPRECATED void gdata_contacts_contact_add_phone_number (GDataContactsContact *self, GDataGDPhoneNumber *phone_number); +G_DEPRECATED GList *gdata_contacts_contact_get_phone_numbers (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED GDataGDPhoneNumber *gdata_contacts_contact_get_primary_phone_number (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_phone_numbers (GDataContactsContact *self); +G_DEPRECATED void gdata_contacts_contact_add_postal_address (GDataContactsContact *self, GDataGDPostalAddress *postal_address); +G_DEPRECATED GList *gdata_contacts_contact_get_postal_addresses (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED GDataGDPostalAddress *gdata_contacts_contact_get_primary_postal_address (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_postal_addresses (GDataContactsContact *self); +G_DEPRECATED void gdata_contacts_contact_add_organization (GDataContactsContact *self, GDataGDOrganization *organization); +G_DEPRECATED GList *gdata_contacts_contact_get_organizations (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED GDataGDOrganization *gdata_contacts_contact_get_primary_organization (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_organizations (GDataContactsContact *self); +G_DEPRECATED void gdata_contacts_contact_add_jot (GDataContactsContact *self, GDataGContactJot *jot); +G_DEPRECATED GList *gdata_contacts_contact_get_jots (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_jots (GDataContactsContact *self); +G_DEPRECATED void gdata_contacts_contact_add_relation (GDataContactsContact *self, GDataGContactRelation *relation); +G_DEPRECATED GList *gdata_contacts_contact_get_relations (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_relations (GDataContactsContact *self); +G_DEPRECATED void gdata_contacts_contact_add_website (GDataContactsContact *self, GDataGContactWebsite *website); +G_DEPRECATED GList *gdata_contacts_contact_get_websites (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED GDataGContactWebsite *gdata_contacts_contact_get_primary_website (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_websites (GDataContactsContact *self); +G_DEPRECATED void gdata_contacts_contact_add_event (GDataContactsContact *self, GDataGContactEvent *event); +G_DEPRECATED GList *gdata_contacts_contact_get_events (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_events (GDataContactsContact *self); +G_DEPRECATED void gdata_contacts_contact_add_calendar (GDataContactsContact *self, GDataGContactCalendar *calendar); +G_DEPRECATED GList *gdata_contacts_contact_get_calendars (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED GDataGContactCalendar *gdata_contacts_contact_get_primary_calendar (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_calendars (GDataContactsContact *self); +G_DEPRECATED void gdata_contacts_contact_add_external_id (GDataContactsContact *self, GDataGContactExternalID *external_id); +G_DEPRECATED GList *gdata_contacts_contact_get_external_ids (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_external_ids (GDataContactsContact *self); +G_DEPRECATED void gdata_contacts_contact_add_hobby (GDataContactsContact *self, const gchar *hobby); +G_DEPRECATED GList *gdata_contacts_contact_get_hobbies (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_hobbies (GDataContactsContact *self); +G_DEPRECATED void gdata_contacts_contact_add_language (GDataContactsContact *self, GDataGContactLanguage *language); +G_DEPRECATED GList *gdata_contacts_contact_get_languages (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_remove_all_languages (GDataContactsContact *self); +G_DEPRECATED const gchar *gdata_contacts_contact_get_extended_property (GDataContactsContact *self, const gchar *name) G_GNUC_PURE; +G_DEPRECATED GHashTable *gdata_contacts_contact_get_extended_properties (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED gboolean gdata_contacts_contact_set_extended_property (GDataContactsContact *self, const gchar *name, const gchar *value); +G_DEPRECATED const gchar *gdata_contacts_contact_get_user_defined_field (GDataContactsContact *self, const gchar *name) G_GNUC_PURE; +G_DEPRECATED GHashTable *gdata_contacts_contact_get_user_defined_fields (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_contact_set_user_defined_field (GDataContactsContact *self, const gchar *name, const gchar *value); +G_DEPRECATED void gdata_contacts_contact_add_group (GDataContactsContact *self, const gchar *href); +G_DEPRECATED void gdata_contacts_contact_remove_group (GDataContactsContact *self, const gchar *href); +G_DEPRECATED gboolean gdata_contacts_contact_is_group_deleted (GDataContactsContact *self, const gchar *href) G_GNUC_PURE; +G_DEPRECATED GList *gdata_contacts_contact_get_groups (GDataContactsContact *self) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; #include +G_DEPRECATED const gchar *gdata_contacts_contact_get_photo_etag (GDataContactsContact *self) G_GNUC_PURE; +G_DEPRECATED guint8 *gdata_contacts_contact_get_photo (GDataContactsContact *self, GDataContactsService *service, gsize *length, gchar **content_type, GCancellable *cancellable, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; +G_DEPRECATED void gdata_contacts_contact_get_photo_async (GDataContactsContact *self, GDataContactsService *service, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); +G_DEPRECATED guint8 *gdata_contacts_contact_get_photo_finish (GDataContactsContact *self, GAsyncResult *async_result, gsize *length, gchar **content_type, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; +G_DEPRECATED gboolean gdata_contacts_contact_set_photo (GDataContactsContact *self, GDataContactsService *service, const guint8 *data, gsize length, const gchar *content_type, GCancellable *cancellable, GError **error); +G_DEPRECATED void gdata_contacts_contact_set_photo_async (GDataContactsContact *self, GDataContactsService *service, const guint8 *data, gsize length, const gchar *content_type, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); +G_DEPRECATED gboolean gdata_contacts_contact_set_photo_finish (GDataContactsContact *self, GAsyncResult *async_result, GError **error); G_END_DECLS diff --git a/gdata/services/contacts/gdata-contacts-group.c b/gdata/services/contacts/gdata-contacts-group.c index 2059369a..f8954f37 100644 --- a/gdata/services/contacts/gdata-contacts-group.c +++ b/gdata/services/contacts/gdata-contacts-group.c @@ -90,6 +90,7 @@ * * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ #include @@ -103,6 +104,8 @@ #include "gdata-types.h" #include "gdata-private.h" +G_GNUC_BEGIN_IGNORE_DEPRECATIONS + /* The maximum number of extended properties the server allows us. See * http://code.google.com/apis/contacts/docs/3.0/reference.html#ProjectionsAndExtended. * When updating this, make sure to update the API documentation for gdata_contacts_group_get_extended_property() and @@ -159,6 +162,7 @@ gdata_contacts_group_class_init (GDataContactsGroupClass *klass) * Atom Publishing Protocol specification. * * 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_EDITED, g_param_spec_int64 ("edited", @@ -172,6 +176,7 @@ gdata_contacts_group_class_init (GDataContactsGroupClass *klass) * Whether the entry has been deleted. * * 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_DELETED, g_param_spec_boolean ("deleted", @@ -192,6 +197,7 @@ gdata_contacts_group_class_init (GDataContactsGroupClass *klass) * group ID. * * 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_SYSTEM_GROUP_ID, g_param_spec_string ("system-group-id", @@ -454,6 +460,7 @@ get_entry_uri (const gchar *id) * Return value: a new #GDataContactsGroup; unref with g_object_unref() * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataContactsGroup * gdata_contacts_group_new (const gchar *id) @@ -470,6 +477,7 @@ gdata_contacts_group_new (const gchar *id) * Return value: the UNIX timestamp for the time the file was last edited, or -1 * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ gint64 gdata_contacts_group_get_edited (GDataContactsGroup *self) @@ -487,6 +495,7 @@ gdata_contacts_group_get_edited (GDataContactsGroup *self) * Return value: the group's system group ID, 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_group_get_system_group_id (GDataContactsGroup *self) @@ -506,6 +515,7 @@ gdata_contacts_group_get_system_group_id (GDataContactsGroup *self) * Return value: the property'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_group_get_extended_property (GDataContactsGroup *self, const gchar *name) @@ -524,6 +534,7 @@ gdata_contacts_group_get_extended_property (GDataContactsGroup *self, const gcha * Return value: (transfer none): a #GHashTable of extended properties * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GHashTable * gdata_contacts_group_get_extended_properties (GDataContactsGroup *self) @@ -550,6 +561,7 @@ gdata_contacts_group_get_extended_properties (GDataContactsGroup *self) * Return value: %TRUE if the property was updated or deleted successfully, %FALSE otherwise * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ gboolean gdata_contacts_group_set_extended_property (GDataContactsGroup *self, const gchar *name, const gchar *value) @@ -588,6 +600,7 @@ gdata_contacts_group_set_extended_property (GDataContactsGroup *self, const gcha * Return value: %TRUE if the group has been deleted, %FALSE otherwise * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ gboolean gdata_contacts_group_is_deleted (GDataContactsGroup *self) @@ -595,3 +608,5 @@ gdata_contacts_group_is_deleted (GDataContactsGroup *self) g_return_val_if_fail (GDATA_IS_CONTACTS_GROUP (self), FALSE); return self->priv->deleted; } + +G_GNUC_END_IGNORE_DEPRECATIONS diff --git a/gdata/services/contacts/gdata-contacts-group.h b/gdata/services/contacts/gdata-contacts-group.h index b8deaed4..4332f42e 100644 --- a/gdata/services/contacts/gdata-contacts-group.h +++ b/gdata/services/contacts/gdata-contacts-group.h @@ -101,16 +101,24 @@ typedef struct { void (*_g_reserved1) (void); } GDataContactsGroupClass; +G_DEPRECATED GType gdata_contacts_group_get_type (void) G_GNUC_CONST; +G_DEPRECATED GDataContactsGroup *gdata_contacts_group_new (const gchar *id) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; +G_DEPRECATED gint64 gdata_contacts_group_get_edited (GDataContactsGroup *self); +G_DEPRECATED gboolean gdata_contacts_group_is_deleted (GDataContactsGroup *self) G_GNUC_PURE; +G_DEPRECATED const gchar *gdata_contacts_group_get_system_group_id (GDataContactsGroup *self) G_GNUC_PURE; +G_DEPRECATED const gchar *gdata_contacts_group_get_extended_property (GDataContactsGroup *self, const gchar *name) G_GNUC_PURE; +G_DEPRECATED GHashTable *gdata_contacts_group_get_extended_properties (GDataContactsGroup *self) G_GNUC_PURE; +G_DEPRECATED gboolean gdata_contacts_group_set_extended_property (GDataContactsGroup *self, const gchar *name, const gchar *value); G_END_DECLS diff --git a/gdata/services/contacts/gdata-contacts-query.c b/gdata/services/contacts/gdata-contacts-query.c index d0256559..9c8fc7f9 100644 --- a/gdata/services/contacts/gdata-contacts-query.c +++ b/gdata/services/contacts/gdata-contacts-query.c @@ -75,6 +75,7 @@ * * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ #include @@ -86,6 +87,8 @@ #include "gdata-query.h" #include "gdata-private.h" +G_GNUC_BEGIN_IGNORE_DEPRECATIONS + static void gdata_contacts_query_finalize (GObject *object); static void gdata_contacts_query_get_property (GObject *object, guint property_id, GValue *value, GParamSpec *pspec); static void gdata_contacts_query_set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec); @@ -125,6 +128,7 @@ gdata_contacts_query_class_init (GDataContactsQueryClass *klass) * Sorting criterion. The only supported value is lastmodified. * * 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_ORDER_BY, g_param_spec_string ("order-by", @@ -140,6 +144,7 @@ gdata_contacts_query_class_init (GDataContactsQueryClass *klass) * normally appear in query results. * * 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_SHOW_DELETED, g_param_spec_boolean ("show-deleted", @@ -153,6 +158,7 @@ gdata_contacts_query_class_init (GDataContactsQueryClass *klass) * Sorting order direction. Can be either ascending or descending. * * 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_SORT_ORDER, g_param_spec_string ("sort-order", @@ -167,6 +173,7 @@ gdata_contacts_query_class_init (GDataContactsQueryClass *klass) * should be a group ID URI. * * 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_GROUP, g_param_spec_string ("group", @@ -295,6 +302,7 @@ get_query_uri (GDataQuery *self, const gchar *feed_uri, GString *query_uri, gboo * Return value: a new #GDataContactsQuery * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataContactsQuery * gdata_contacts_query_new (const gchar *q) @@ -314,6 +322,7 @@ gdata_contacts_query_new (const gchar *q) * Return value: a new #GDataContactsQuery * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataContactsQuery * gdata_contacts_query_new_with_limits (const gchar *q, guint start_index, guint max_results) @@ -334,6 +343,7 @@ gdata_contacts_query_new_with_limits (const gchar *q, guint start_index, guint m * Return value: the order by property, or %NULL if it is unset * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_query_get_order_by (GDataContactsQuery *self) @@ -352,6 +362,7 @@ gdata_contacts_query_get_order_by (GDataContactsQuery *self) * Set @order_by to %NULL to unset the property in the query URI. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_query_set_order_by (GDataContactsQuery *self, const gchar *order_by) @@ -375,6 +386,7 @@ gdata_contacts_query_set_order_by (GDataContactsQuery *self, const gchar *order_ * Return value: %TRUE if deleted contacts should be shown, %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_query_show_deleted (GDataContactsQuery *self) @@ -391,6 +403,7 @@ gdata_contacts_query_show_deleted (GDataContactsQuery *self) * Sets the #GDataContactsQuery:show-deleted property of the #GDataContactsQuery. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_query_set_show_deleted (GDataContactsQuery *self, gboolean show_deleted) @@ -412,6 +425,7 @@ gdata_contacts_query_set_show_deleted (GDataContactsQuery *self, gboolean show_d * Return value: the sort order property, or %NULL if it is unset * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_query_get_sort_order (GDataContactsQuery *self) @@ -430,6 +444,7 @@ gdata_contacts_query_get_sort_order (GDataContactsQuery *self) * Set @sort_order to %NULL to unset the property in the query URI. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_query_set_sort_order (GDataContactsQuery *self, const gchar *sort_order) @@ -453,6 +468,7 @@ gdata_contacts_query_set_sort_order (GDataContactsQuery *self, const gchar *sort * Return value: the group property, or %NULL if it is unset * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ const gchar * gdata_contacts_query_get_group (GDataContactsQuery *self) @@ -471,6 +487,7 @@ gdata_contacts_query_get_group (GDataContactsQuery *self) * Set @group to %NULL to unset the property in the query URI. * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_query_set_group (GDataContactsQuery *self, const gchar *group) @@ -484,3 +501,5 @@ gdata_contacts_query_set_group (GDataContactsQuery *self, const gchar *group) /* Our current ETag will no longer be relevant */ gdata_query_set_etag (GDATA_QUERY (self), NULL); } + +G_GNUC_END_IGNORE_DEPRECATIONS diff --git a/gdata/services/contacts/gdata-contacts-query.h b/gdata/services/contacts/gdata-contacts-query.h index f2156458..a961b7fc 100644 --- a/gdata/services/contacts/gdata-contacts-query.h +++ b/gdata/services/contacts/gdata-contacts-query.h @@ -65,19 +65,30 @@ typedef struct { void (*_g_reserved1) (void); } GDataContactsQueryClass; +G_DEPRECATED GType gdata_contacts_query_get_type (void) G_GNUC_CONST; +G_DEPRECATED GDataContactsQuery *gdata_contacts_query_new (const gchar *q) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; +G_DEPRECATED GDataContactsQuery *gdata_contacts_query_new_with_limits (const gchar *q, guint start_index, guint max_results) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; +G_DEPRECATED const gchar *gdata_contacts_query_get_order_by (GDataContactsQuery *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_query_set_order_by (GDataContactsQuery *self, const gchar *order_by); +G_DEPRECATED gboolean gdata_contacts_query_show_deleted (GDataContactsQuery *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_query_set_show_deleted (GDataContactsQuery *self, gboolean show_deleted); +G_DEPRECATED const gchar *gdata_contacts_query_get_sort_order (GDataContactsQuery *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_query_set_sort_order (GDataContactsQuery *self, const gchar *sort_order); +G_DEPRECATED const gchar *gdata_contacts_query_get_group (GDataContactsQuery *self) G_GNUC_PURE; +G_DEPRECATED void gdata_contacts_query_set_group (GDataContactsQuery *self, const gchar *group); G_END_DECLS diff --git a/gdata/services/contacts/gdata-contacts-service.c b/gdata/services/contacts/gdata-contacts-service.c index 62d7c328..2c6de1c4 100644 --- a/gdata/services/contacts/gdata-contacts-service.c +++ b/gdata/services/contacts/gdata-contacts-service.c @@ -26,6 +26,12 @@ * #GDataContactsService is a subclass of #GDataService for communicating with the GData API of Google Contacts. It supports querying * for, inserting, editing and deleting contacts from a Google address book. * + * As of December 2021, the [Google Contacts API server will be + * disabled](https://developers.google.com/contacts/v3/announcement). This + * client-side API is deprecated. The + * [CardDAV interface](https://developers.google.com/people/carddav) should be + * used instead. + * * For more details of Google Contacts' GData API, see the * online documentation. * @@ -143,6 +149,7 @@ * * * Since: 0.2.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ #include @@ -157,6 +164,8 @@ #include "gdata-private.h" #include "gdata-query.h" +G_GNUC_BEGIN_IGNORE_DEPRECATIONS + static GList *get_authorization_domains (void); _GDATA_DEFINE_AUTHORIZATION_DOMAIN (contacts, "cp", "https://www.google.com/m8/feeds/") @@ -192,6 +201,7 @@ get_authorization_domains (void) * Return value: a new #GDataContactsService, or %NULL; unref with g_object_unref() * * Since: 0.9.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataContactsService * gdata_contacts_service_new (GDataAuthorizer *authorizer) @@ -215,6 +225,7 @@ gdata_contacts_service_new (GDataAuthorizer *authorizer) * Return value: (transfer none): the service's authorization domain * * Since: 0.9.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataAuthorizationDomain * gdata_contacts_service_get_primary_authorization_domain (void) @@ -238,6 +249,7 @@ gdata_contacts_service_get_primary_authorization_domain (void) * Return value: (transfer full): a #GDataFeed of query results; 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. */ GDataFeed * gdata_contacts_service_query_contacts (GDataContactsService *self, GDataQuery *query, GCancellable *cancellable, @@ -286,6 +298,7 @@ gdata_contacts_service_query_contacts (GDataContactsService *self, GDataQuery *q * and gdata_service_query_async(), which is the base asynchronous query function. * * Since: 0.9.1 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_service_query_contacts_async (GDataContactsService *self, GDataQuery *query, GCancellable *cancellable, @@ -334,6 +347,7 @@ gdata_contacts_service_query_contacts_async (GDataContactsService *self, GDataQu * Return value: (transfer full): an updated #GDataContactsContact, or %NULL; 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_service_insert_contact (GDataContactsService *self, GDataContactsContact *contact, GCancellable *cancellable, GError **error) @@ -372,6 +386,7 @@ gdata_contacts_service_insert_contact (GDataContactsService *self, GDataContacts * and gdata_service_insert_entry_async(), which is the base asynchronous insertion function. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_service_insert_contact_async (GDataContactsService *self, GDataContactsContact *contact, GCancellable *cancellable, @@ -405,6 +420,7 @@ gdata_contacts_service_insert_contact_async (GDataContactsService *self, GDataCo * Return value: (transfer full): a #GDataFeed of query results; unref with g_object_unref() * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataFeed * gdata_contacts_service_query_groups (GDataContactsService *self, GDataQuery *query, GCancellable *cancellable, @@ -453,6 +469,7 @@ gdata_contacts_service_query_groups (GDataContactsService *self, GDataQuery *que * which is the base asynchronous query function. * * Since: 0.9.1 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_service_query_groups_async (GDataContactsService *self, GDataQuery *query, GCancellable *cancellable, @@ -499,6 +516,7 @@ gdata_contacts_service_query_groups_async (GDataContactsService *self, GDataQuer * Return value: (transfer full): the inserted #GDataContactsGroup; unref with g_object_unref() * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ GDataContactsGroup * gdata_contacts_service_insert_group (GDataContactsService *self, GDataContactsGroup *group, GCancellable *cancellable, GError **error) @@ -550,6 +568,7 @@ gdata_contacts_service_insert_group (GDataContactsService *self, GDataContactsGr * gdata_service_insert_entry_async(), which is the base asynchronous insertion function. * * Since: 0.7.0 + * Deprecated: 0.18.0: The Google Contacts service is deprecated. Use Google’s CardDAV interface instead. */ void gdata_contacts_service_insert_group_async (GDataContactsService *self, GDataContactsGroup *group, GCancellable *cancellable, @@ -566,3 +585,5 @@ gdata_contacts_service_insert_group_async (GDataContactsService *self, GDataCont callback, user_data); g_free (request_uri); } + +G_GNUC_END_IGNORE_DEPRECATIONS diff --git a/gdata/services/contacts/gdata-contacts-service.h b/gdata/services/contacts/gdata-contacts-service.h index 100e38df..33895d9f 100644 --- a/gdata/services/contacts/gdata-contacts-service.h +++ b/gdata/services/contacts/gdata-contacts-service.h @@ -69,15 +69,20 @@ typedef struct { void (*_g_reserved5) (void); } GDataContactsServiceClass; +G_DEPRECATED GType gdata_contacts_service_get_type (void) G_GNUC_CONST; +G_DEPRECATED GDataContactsService *gdata_contacts_service_new (GDataAuthorizer *authorizer) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; +G_DEPRECATED GDataAuthorizationDomain *gdata_contacts_service_get_primary_authorization_domain (void) G_GNUC_CONST; +G_DEPRECATED GDataFeed *gdata_contacts_service_query_contacts (GDataContactsService *self, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; +G_DEPRECATED void gdata_contacts_service_query_contacts_async (GDataContactsService *self, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GDestroyNotify destroy_progress_user_data, @@ -85,23 +90,29 @@ void gdata_contacts_service_query_contacts_async (GDataContactsService *self, GD #include +G_DEPRECATED GDataContactsContact *gdata_contacts_service_insert_contact (GDataContactsService *self, GDataContactsContact *contact, GCancellable *cancellable, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; +G_DEPRECATED void gdata_contacts_service_insert_contact_async (GDataContactsService *self, GDataContactsContact *contact, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); #include +G_DEPRECATED GDataFeed *gdata_contacts_service_query_groups (GDataContactsService *self, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; +G_DEPRECATED void gdata_contacts_service_query_groups_async (GDataContactsService *self, GDataQuery *query, GCancellable *cancellable, GDataQueryProgressCallback progress_callback, gpointer progress_user_data, GDestroyNotify destroy_progress_user_data, GAsyncReadyCallback callback, gpointer user_data); +G_DEPRECATED GDataContactsGroup *gdata_contacts_service_insert_group (GDataContactsService *self, GDataContactsGroup *group, GCancellable *cancellable, GError **error) G_GNUC_WARN_UNUSED_RESULT G_GNUC_MALLOC; +G_DEPRECATED void gdata_contacts_service_insert_group_async (GDataContactsService *self, GDataContactsGroup *group, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); diff --git a/gdata/tests/contacts.c b/gdata/tests/contacts.c index f70cee25..b6f4de2d 100644 --- a/gdata/tests/contacts.c +++ b/gdata/tests/contacts.c @@ -25,6 +25,8 @@ #include "common.h" #include "gdata-dummy-authorizer.h" +G_GNUC_BEGIN_IGNORE_DEPRECATIONS + static UhmServer *mock_server = NULL; #undef CLIENT_ID /* from common.h */ @@ -2699,3 +2701,5 @@ main (int argc, char *argv[]) return retval; } + +G_GNUC_END_IGNORE_DEPRECATIONS diff --git a/gdata/tests/oauth1-authorizer.c b/gdata/tests/oauth1-authorizer.c index 63d50d9b..480de207 100644 --- a/gdata/tests/oauth1-authorizer.c +++ b/gdata/tests/oauth1-authorizer.c @@ -23,6 +23,9 @@ #include "common.h" +/* Uses the Contacts API for tests, but it’s deprecated */ +G_GNUC_BEGIN_IGNORE_DEPRECATIONS + static GThread *main_thread = NULL; static UhmServer *mock_server = NULL; @@ -1137,3 +1140,5 @@ main (int argc, char *argv[]) return g_test_run (); } + +G_GNUC_END_IGNORE_DEPRECATIONS -- cgit v1.2.1