ContactsContact

---

Object Hierarchy:

Description:

Content:

Properties:

• public string billing_information { set; get; }
  Billing information for the contact, such as their billing name and address.
• public Date birthday { set; get; }
  The contact's birthday.
• public bool birthday_has_year { set; get; }
  Whether the contact's birthday includes their year of birth.
• public bool deleted { get; }
  Whether the entry has been deleted.
• public string directory_server { set; get; }
  The name or address of a directory server associated with the contact.
• public int64 edited { get; }
  The last time the contact was edited. If the contact has not been edited yet, the content indicates the time it was created.
• public string gender { set; get; }
  The gender of the contact. For example: MALE or FEMALE.
• public bool has_photo { get; }
• public string initials { set; get; }
  The initials of the contact.
• public string maiden_name { set; get; }
  The maiden name of the contact.
• public string mileage { set; get; }
  A mileage associated with the contact, such as one for reimbursement purposes. It can be in any format.
• public GDName name { set; get; }
  The contact's name in a structured representation.
• public string nickname { set; get; }
  The contact's chosen nickname.
• public string occupation { set; get; }
  The contact's occupation.
• public string priority { set; get; }
  The contact's importance. For example: NORMAL or HIGH.
• public string sensitivity { set; get; }
  The sensitivity of the contact's data. For example: NORMAL or PRIVATE.
• public string short_name { set; get; }
  A short name for the contact. This should be used for contracted versions of the contact's actual name, whereas nickname should be used for nicknames.
• public string subject { set; get; }
  The subject of the contact. (i.e. The contact's relevance to the address book.)

Creation methods:

• public ContactsContact (string? id)
  Creates a new ContactsContact with the given ID and default properties.

Methods:

• public void add_calendar (GContactCalendar calendar)
  Adds a calendar to the contact's list of calendars and increments its reference count.
• public void add_email_address (GDEmailAddress email_address)
  Adds an e-mail address to the contact's list of e-mail addresses and increments its reference count.
• public void add_event (GContactEvent event)
  Adds an event to the contact's list of events and increments its reference count.
• public void add_external_id (GContactExternalID external_id)
  Adds an external ID to the contact's list of external IDs and increments its reference count.
• public void add_group (string href)
  Adds the contact to the given group. href should be a URI.
• public void add_hobby (string hobby)
  Adds a hobby to the contact's list of hobbies, copying it in the process.
• public void add_im_address (GDIMAddress im_address)
  Adds an IM (instant messaging) address to the contact's list of IM addresses and increments its reference count.
• public void add_jot (GContactJot jot)
  Adds a jot to the contact's list of jots and increments its reference count.
• public void add_language (GContactLanguage language)
  Adds a language to the contact's list of languages and increments its reference count.
• public void add_organization (GDOrganization organization)
  Adds an organization to the contact's list of organizations (e.g. employers) and increments its reference count.
• public void add_phone_number (GDPhoneNumber phone_number)
  Adds a phone number to the contact's list of phone numbers and increments its reference count
• public void add_postal_address (GDPostalAddress postal_address)
  Adds a postal address to the contact's list of postal addresses and increments its reference count.
• public void add_relation (GContactRelation relation)
  Adds a relation to the contact's list of relations and increments its reference count.
• public void add_website (GContactWebsite website)
  Adds a website to the contact's list of websites and increments its reference count.
• public unowned string get_billing_information ()
  Gets the billing_information property.
• public bool get_birthday (out Date birthday)
  Gets the birthday and birthday_has_year properties. If birthday is non-%NULL, birthday is returned in it. The function returns the value of birthday_has_year, which specifies whether the year in birthday is meaningful. Contacts may not have the year of their birth set, in which case, the function would return false, and the year in birthday should be ignored.
• public unowned List<GContactCalendar> get_calendars ()
  Gets a list of the calendars of the contact.
• public unowned string get_directory_server ()
  Gets the directory_server property.
• public int64 get_edited ()
  Gets the edited property. If the property is unset, -1 will be returned.
• public unowned List<GDEmailAddress> get_email_addresses ()
  Gets a list of the e-mail addresses owned by the contact.
• public unowned List<GContactEvent> get_events ()
  Gets a list of the events of the contact.
• public weak HashTable<void*,void*> get_extended_properties ()
  Gets the full list of extended properties of the contact; a hash table mapping property name to value.
• public unowned string get_extended_property (string name)
  Gets the value of an extended property of the contact. Each contact can have up to 10 client-set extended properties to store data of the client's choosing.
• public unowned List<GContactExternalID> get_external_ids ()
  Gets a list of the external IDs of the contact.
• public unowned string get_gender ()
  Gets the gender property.
• public List<unowned string> get_groups ()
  Gets a list of the groups to which the contact belongs.
• public unowned List<string> get_hobbies ()
  Gets a list of the hobbies of the contact.
• public unowned List<GDIMAddress> get_im_addresses ()
  Gets a list of the IM addresses owned by the contact.
• public unowned string get_initials ()
  Gets the initials property.
• public unowned List<GContactJot> get_jots ()
  Gets a list of the jots attached to the contact.
• public unowned List<GContactLanguage> get_languages ()
  Gets a list of the languages of the contact.
• public unowned string get_maiden_name ()
  Gets the maiden_name property.
• public unowned string get_mileage ()
  Gets the mileage property.
• public weak GDName get_name ()
  Gets the name property.
• public unowned string get_nickname ()
  Gets the nickname property.
• public unowned string get_occupation ()
  Gets the occupation property.
• public unowned List<GDOrganization> get_organizations ()
  Gets a list of the organizations to which the contact belongs.
• public unowned List<GDPhoneNumber> get_phone_numbers ()
  Gets a list of the phone numbers owned by the contact.
• public uint8[] get_photo (ContactsService service, out string content_type, Cancellable? cancellable) throws Error
  Downloads and returns the contact's photo, if they have one. If the contact doesn't have a photo (i.e. gdata_contacts_contact_get_photo_etag returns null), null is returned, but no error is set in error.
• public async uint8 get_photo_async (ContactsService service, out size_t length, out string content_type) throws Error
  Downloads and returns the contact's photo, if they have one, asynchronously. self and service are both reffed when this function is called, so can safely be unreffed after this function returns.
• public unowned List<GDPostalAddress> get_postal_addresses ()
  Gets a list of the postal addresses owned by the contact.
• public weak GContactCalendar get_primary_calendar ()
  Gets the contact's primary calendar, if one exists.
• public weak GDEmailAddress get_primary_email_address ()
  Gets the contact's primary e-mail address, if one exists.
• public weak GDIMAddress get_primary_im_address ()
  Gets the contact's primary IM address, if one exists.
• public weak GDOrganization get_primary_organization ()
  Gets the contact's primary organization, if one exists.
• public weak GDPhoneNumber get_primary_phone_number ()
  Gets the contact's primary phone number, if one exists.
• public weak GDPostalAddress get_primary_postal_address ()
  Gets the contact's primary postal address, if one exists.
• public weak GContactWebsite get_primary_website ()
  Gets the contact's primary website, if one exists.
• public unowned string get_priority ()
  Gets the priority property.
• public unowned List<GContactRelation> get_relations ()
  Gets a list of the relations of the contact.
• public unowned string get_sensitivity ()
  Gets the sensitivity property.
• public unowned string get_short_name ()
  Gets the short_name property.
• public unowned string get_subject ()
  Gets the subject property.
• public unowned string get_user_defined_field (string name)
  Gets the value of a user-defined field of the contact. User-defined fields are settable by the user through the Google Contacts web interface, in contrast to extended properties, which are visible and settable only through the GData interface.
• public weak HashTable<void*,void*> get_user_defined_fields ()
  Gets the full list of user-defined fields of the contact; a hash table mapping field name to value.
• public unowned List<GContactWebsite> get_websites ()
  Gets a list of the websites of the contact.
• public bool is_deleted ()
  Returns whether the contact has recently been deleted. This will always return false unless show_deleted has been set to true for the query which returned the contact; then this function will return true only if the contact has been deleted.
• public bool is_group_deleted (string href)
  Returns whether the contact has recently been removed from the given group on the server. This will always return false unless show_deleted has been set to true for the query which returned the contact.
• public void remove_all_calendars ()
  Removes all calendars from the contact.
• public void remove_all_email_addresses ()
  Removes all e-mail addresses from the contact.
• public void remove_all_events ()
  Removes all events from the contact.
• public void remove_all_external_ids ()
  Removes all external IDs from the contact.
• public void remove_all_hobbies ()
  Removes all hobbies from the contact.
• public void remove_all_im_addresses ()
  Removes all IM addresses from the contact.
• public void remove_all_jots ()
  Removes all jots from the contact.
• public void remove_all_languages ()
  Removes all languages from the contact.
• public void remove_all_organizations ()
  Removes all organizations from the contact.
• public void remove_all_phone_numbers ()
  Removes all phone numbers from the contact.
• public void remove_all_postal_addresses ()
  Removes all postal addresses from the contact.
• public void remove_all_relations ()
  Removes all relations from the contact.
• public void remove_all_websites ()
  Removes all websites from the contact.
• public void remove_group (string href)
  Removes the contact from the given group. href should be a URI.
• public void set_billing_information (string? billing_information)
  Sets the billing_information property to billing_information.
• public void set_birthday (Date? birthday, bool birthday_has_year)
  Sets the birthday property to birthday and the birthday_has_year property to birthday_has_year. See get_birthday for an explanation of the interation between these two properties.
• public void set_directory_server (string? directory_server)
  Sets the directory_server property to directory_server.
• public bool set_extended_property (string name, string? value)
  Sets the value of a contact's extended property. Extended property names are unique (but of the client's choosing), and reusing the same property name will result in the old value of that property being overwritten.
• public void set_gender (string? gender)
  Sets the gender property to gender.
• public void set_initials (string? initials)
  Sets the initials property to initials.
• public void set_maiden_name (string? maiden_name)
  Sets the maiden_name property to maiden_name.
• public void set_mileage (string? mileage)
  Sets the mileage property to mileage.
• public void set_name (GDName name)
  Sets the name property to name , and increments its reference count.
• public void set_nickname (string? nickname)
  Sets the nickname property to nickname.
• public void set_occupation (string? occupation)
  Sets the occupation property to occupation.
• public bool set_photo (ContactsService service, uint8? data, size_t length, string? content_type, Cancellable? cancellable) throws Error
  Sets the contact's photo to data or, if data is null, deletes the contact's photo. content_type must be specified if data is non-%NULL.
• public async bool set_photo_async (ContactsService service, uint8? data, size_t length, string? content_type, Cancellable? cancellable) throws Error
  Sets the contact's photo to data or, if data is null, deletes the contact's photo. content_type must be specified if data is non-%NULL. self, service , data and content_type are all reffed and copied when this function is called, so can safely be unreffed after this function returns.
• public void set_priority (string? priority)
  Sets the priority property to priority.
• public void set_sensitivity (string? sensitivity)
  Sets the sensitivity property to sensitivity.
• public void set_short_name (string? short_name)
  Sets the short_name property to short_name.
• public void set_subject (string? subject)
  Sets the subject property to subject.
• public void set_user_defined_field (string name, string? value)
  Sets the value of a contact's user-defined field. User-defined field names are unique (but of the client's choosing), and reusing the same field name will result in the old value of that field being overwritten.