/ 
WWW-Google-Contacts-0.09
/ WWW::Google::Contacts::Contact

NAME

WWW::Google::Contacts::Contact

VERSION

version 0.09

SYNOPSIS

use WWW::Google::Contacts;

my $google = WWW::Google::Contacts->new( username => "your.username", password => "your.password" );

my $contact = $google->new_contact;
$contact->full_name("Emmett Brown");

METHODS

$contact->create

Writes the contact to your Google account.

$contact->retrieve

Fetches contact details from Google account.

$contact->update

Updates existing contact in your Google account.

$contact->delete

Deletes contact from your Google account.

$contact->create_or_update

Creates or updates contact, depending on if it already exists

ATTRIBUTES

All these attributes are gettable and settable on Contact objects.

given_name
$contact->given_name("Arnold");
additional_name
$contact->additional_name("J");
family_name
$contact->family_name("Rimmer");
name_prefix
$contact->name_prefix("Mrs");
name_suffix
$contact->name_suffix("III");
full_name

If this is set to what seems like "$given_name $family_name", those attributes will be automatically set.

email

Explicitly setting all email details:

$contact->email({
  type => "work",
  value => 'shenanigans@example.com',
  display_name => 'Shenanigans',
  primary => 1,
});

If you're just setting the email value, type will default to "work" and leave other fields empty.

$contact->email( 'smeghead@reddwarf.net' );
phone_number

Explicitly setting all phone details:

$contact->phone_number({
  type => "mobile",
  value => "+449812323",
});

Just setting the value will set type to default value "mobile".

$contact->phone_number( "+1666666" );
im

You can specify all IM details:

$contact->im({
  type => "home",
  protocol => "MSN",
  value => 'some.email@example.com',
});

Or you can just choose to give the IM address:

$contact->im( 'some.email@example.com' );
notes

Arbitrary notes about your friend.

$contact->notes( "He's a lumberjack, but he's ok" );
...tba

Sorry, haven't documented all attributes yet :(

AUTHOR

Magnus Erixzon <magnus@erixzon.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Magnus Erixzon / Fayland Lam.

This is free software; you can redistribute it and/or modify it under the same terms as perl itself.

AUTHORS

  • Fayland Lam <fayland@gmail.com>

  • Magnus Erixzon <magnus@erixzon.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Fayland Lam.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.