Google API – Get contact list
In our new tutorial I am going to tell you about inviting friends. I think that this is the most important part for every website, a key to success. Today I will show you how to create simple and effective Gmail contact importer using OAuth authorization and API. Also, I will tell about obtaining Google API access too.
As the first step – lets prepare our own project in Google API console, please open this link and create your project. Then we need goto ‘API Access’ section and click ‘Create an OAuth 2.0 client ID’ button. Now we should fill a name for our new project:
Click next, and, at the second step we should set URL of our destination page:
Finally, we’ve got our Client ID and secret (or – consumer key and secret):
Now – download the source files and lets start coding !
Live Demo
download in package
Step 1. PHP
Now, please create empty index.php file and put next code:
index.php
<?php
// disable warnings
if (version_compare(phpversion(), "5.3.0", ">=") == 1)
error_reporting(E_ALL & ~E_NOTICE & ~E_DEPRECATED);
else
error_reporting(E_ALL & ~E_NOTICE);
$sClientId = 'YOUR_GOOGLE_CLIENT_ID';
$sClientSecret = 'YOUR_GOOGLE_CLIENT_SECRET';
$sCallback = 'http://www.script-tutorials.com/demos/291/index.php'; // callback url, don't forget to change it to your!
$iMaxResults = 20; // max results
$sStep = 'auth'; // current step
// include GmailOath library https://code.google.com/p/rspsms/source/browse/trunk/system/plugins/GmailContacts/GmailOath.php?r=11
include_once('classes/GmailOath.php');
session_start();
// prepare new instances of GmailOath and GmailGetContacts
$oAuth = new GmailOath($sClientId, $sClientSecret, $argarray, false, $sCallback);
$oGetContacts = new GmailGetContacts();
if ($_GET && $_GET['oauth_token']) {
$sStep = 'fetch_contacts'; // fetch contacts step
// decode request token and secret
$sDecodedToken = $oAuth->rfc3986_decode($_GET['oauth_token']);
$sDecodedTokenSecret = $oAuth->rfc3986_decode($_SESSION['oauth_token_secret']);
// get 'oauth_verifier'
$oAuthVerifier = $oAuth->rfc3986_decode($_GET['oauth_verifier']);
// prepare access token, decode it, and obtain contact list
$oAccessToken = $oGetContacts->get_access_token($oAuth, $sDecodedToken, $sDecodedTokenSecret, $oAuthVerifier, false, true, true);
$sAccessToken = $oAuth->rfc3986_decode($oAccessToken['oauth_token']);
$sAccessTokenSecret = $oAuth->rfc3986_decode($oAccessToken['oauth_token_secret']);
$aContacts = $oGetContacts->GetContacts($oAuth, $sAccessToken, $sAccessTokenSecret, false, true, $iMaxResults);
// turn array with contacts into html string
$sContacts = $sContactName = '';
foreach($aContacts as $k => $aInfo) {
$sContactName = end($aInfo['title']);
$aLast = end($aContacts[$k]);
foreach($aLast as $aEmail) {
$sContacts .= '<p>' . $sContactName . '(' . $aEmail['address'] . ')</p>';
}
}
} else {
// prepare access token and set it into session
$oRequestToken = $oGetContacts->get_request_token($oAuth, false, true, true);
$_SESSION['oauth_token'] = $oRequestToken['oauth_token'];
$_SESSION['oauth_token_secret'] = $oRequestToken['oauth_token_secret'];
}
?>
<!DOCTYPE html>
<html lang="en" >
<head>
<meta charset="utf-8" />
<title>Google API - Get contact list | Script Tutorials</title>
<link href="css/main.css" rel="stylesheet" type="text/css" />
</head>
<body>
<header>
<h2>Google API - Get contact list</h2>
<a href="http://www.script-tutorials.com/google-api-get-contact-list/" class="stuts">Back to original tutorial on <span>Script Tutorials</span></a>
</header>
<img src="oauthLogo.png" class="google" alt="google" />
<?php if ($sStep == 'auth'): ?>
<center>
<h1>Step 1. OAuth</h1>
<h2>Please click <a href="https://www.google.com/accounts/OAuthAuthorizeToken?oauth_token=<?php echo $oAuth->rfc3986_decode($oRequestToken['oauth_token']) ?>">this link</a> in order to get access token to receive contacts</h2>
</center>
<?php elseif ($sStep == 'fetch_contacts'): ?>
<center>
<h1>Step 2. Results</h1>
<br />
<?= $sContacts ?>
</center>
<?php endif ?>
</body>
</html>
As you can see – in the beginning we include ‘GmailOath.php’ library. This library you can download here. Once you have downloaded it – pay attention to the code. As you can see – the main functionality is separated into 2 sections: authorization and fetching of contact list. As usual – I put my comments in this code to better understanding.
When we click authorization button, it will open google authorization page, where we should grant access for our application to get our contact list:
Live Demo
download in archive
Conclusion
If you have any suggestions about further ideas for articles – you are welcome to share them with us. Good luck in your work!
Related Articles
How to get your Google+ profile info and friend’s activity using the Google JS API
10 Creative Contact Form Designs
How to Post on Twitter from your Website using OAuth
Invalid Token.
Are you sure? Is it for your local tests? Or our demo doesn’t work? I’ve just tested our demo – it works fine for me.
Is it for your local tests?
Yes!
Did everything as it is written in the example. The result of the:Invalid Token.
But have you applied your own google’s api keys?
But have you applied your own google’s api keys?
Replaced here:
11 $sCallback = ‘http://www.script-tutorials.com/demos/291/index.php'; // callback url, don’t forget to change it to your!
2 Viktor,
Yes, I know, you should to apply your own API keys + change callback URL as well.
Only in this case the script will work for you.
Great tutorial.
Any idea how to retrieve the contact’s photo too?
I will try to find this (how to obtain contacts photos) next time. Right now I haven’t found it.
I try to use your example but it does not work properly.
I don’t know what is problem.
There is no single error and I already checked all thing what you mentioned in this page.
symptom
- Actually, it works. But if I click and move to confirm page, and press confirm button then there are no result( just show blank page).
Could you tell me how to solve this problem?
Hi Isac,
Please recheck both: redirect url (in API settings) and callback url in index.php. Both should point to the same file.
getting error on this method call can you help me how to implement this function curl_init()
thanks
Hello Govind,
curl_init is ordinary function: http://php.net/manual/en/function.curl-init.php
make sure that ‘curl’ is installed on your server (this is PHP extension)
and the method call is in the GmailOath.php file
Warning: session_start() [function.session-start]: open(/home/users/web/b502/nf.webinfomart/public_html/cgi-bin/tmp/sess_c797f142bb6a5491e819ce60e912c084, O_RDWR) failed: No such file or directory (2) in /hermes/bosweb25a/b502/nf.webinfomart/public_html/webinfomart/getcontact/sources291/index.php on line 19
Warning: session_start() [function.session-start]: Cannot send session cookie – headers already sent by (output started at /hermes/bosweb25a/b502/nf.webinfomart/public_html/webinfomart/getcontact/sources291/index.php:19) in /hermes/bosweb25a/b502/nf.webinfomart/public_html/webinfomart/getcontact/sources291/index.php on line 19
Warning: session_start() [function.session-start]: Cannot send session cache limiter – headers already sent (output started at /hermes/bosweb25a/b502/nf.webinfomart/public_html/webinfomart/getcontact/sources291/index.php:19) in /hermes/bosweb25a/b502/nf.webinfomart/public_html/webinfomart/getcontact/sources291/index.php on line 19
I am getting this error, plz help me out ..
Hi Kamal,
Please refer this thread: http://stackoverflow.com/questions/11374110/session-start-errors-on-godaddy-server
this is related with your problem