I've been looking at accessing the Gmail contact data via their API. This is the first draft of my findings and is no way the finished solution but it does what it says on the tin and returns the email address's from a users Gmail account contacts. Its actually quite simple to and we're going to do this in 2 CFM pages.
We are going to be using the AuthSub method of registration
There are three levels of registration:
- Unregistered: Application is not recognized by Google. The Access Request page, which prompts your users to either grant or deny access for your application, displays this caution highlighted in yellow: "Non-registered, not secure. This website has not registered with Google. We recommend that you continue the process only if you trust this destination."
- Registered: Application is recognized by Google. The Access Request page displays this caution: "Registered, not secure. This website is registered with Google to make authorization requests, but has not been configured to send requests securely. We recommend you continue if you trust this destination."
- Registered with enhanced security: Registered applications with a security certificate on file can use secure tokens. The Access Request page displays this message: "Registered, secure. This website is registered with Google to make authorization requests."
As we are going to be using the first method of Unregistered the user will getting some simple/basic prompts:
- The first will be asking them to log in and letting them know that "A third party service is requesting permission to access your Google Account"
- Second an Access Request page which lets the user know WHAT we are doing
Once they have logged in and agreed Google will take you back to your site. The
I've put the index.cfm in a folder on the root called contacts. Below is the content for index.cfm read the comments for what each variable is doing. This is all taken from Googles API docs on AuthSub proxy authentication.
ColdFISH is developed by Jason Delmore. Source code and license information available at coldfish.riaforge.org
<cfhttp url="https://www.google.com/accounts/AuthSubRequest" method="get" result="res">
<!--- Indicates that the application is requesting a token to access contacts feeds.
The scope string to use is http://www.google.com/m8/feeds/ (URL-encoded, of course). --->
<cfhttpparam name="scope" value="http://www.google.com/m8/feeds/" type="url" />
<!--- Indicates whether the token returned can be exchanged for a multi-use (session) token. --->
<cfhttpparam name="session" value="1" type="url" />
<!--- Indicates whether the client is requesting a secure token. --->
<cfhttpparam name="secure" value="0" type="url" />
<!--- The URL of the page that Google should redirect the user to after authentication. --->
<cfhttpparam name="next" value="http://localhost/contacts/getAddresses.cfm" type="url" />
</cfhttp>
<cfoutput>#res.filecontent#</cfoutput>
1<cfhttp url="https://www.google.com/accounts/AuthSubRequest" method="get" result="res">
2 <!--- Indicates that the application is requesting a token to access contacts feeds.
3 The scope string to use is http://www.google.com/m8/feeds/ (URL-encoded, of course). --->
4 <cfhttpparam name="scope" value="http://www.google.com/m8/feeds/" type="url" />
5
6 <!--- Indicates whether the token returned can be exchanged for a multi-use (session) token. --->
7 <cfhttpparam name="session" value="1" type="url" />
8
9 <!--- Indicates whether the client is requesting a secure token. --->
10 <cfhttpparam name="secure" value="0" type="url" />
11
12 <!--- The URL of the page that Google should redirect the user to after authentication. --->
13 <cfhttpparam name="next" value="http://localhost/contacts/getAddresses.cfm" type="url" />
14</cfhttp>
15
16<cfoutput>#res.filecontent#</cfoutput>
Our second page is getAddresses.cfm In the contacts folder
ColdFISH is developed by Jason Delmore. Source code and license information available at coldfish.riaforge.org
<cfhttp url="http://www.google.com/m8/feeds/contacts/default/base" method="get">
<cfhttpparam type="header" name="Authorization" value="AuthSub token=#url.token#">
<!--- The maximum number of entries to return. If you want to receive all of the
contacts, rather than only the default maximum, you can specify a very large number
for max-results i.e. 9999 --->
<cfhttpparam type="url" name="max-results" value="25" />
</cfhttp>
<!--- Dump the results--->
<cfdump var="#cfhttp.fileContent#">
1<cfhttp url="http://www.google.com/m8/feeds/contacts/default/base" method="get">
2 <cfhttpparam type="header" name="Authorization" value="AuthSub token=#url.token#">
3 <!--- The maximum number of entries to return. If you want to receive all of the
4 contacts, rather than only the default maximum, you can specify a very large number
5 for max-results i.e. 9999 --->
6 <cfhttpparam type="url" name="max-results" value="25" />
7</cfhttp>
8
9<!--- Dump the results--->
10<cfdump var="#cfhttp.fileContent#">
In my example I am only returning 25 records (for speed mainly) but if you want to know more about returning records check out Google API docs on query params. Also in my example I just dump the records. If you want to get out the email addresses you can use the following snippet.
ColdFISH is developed by Jason Delmore. Source code and license information available at coldfish.riaforge.org
<cfset myXmlDoc = xmlParse(cfhttp.fileContent)>
<cfoutput>
<cfloop from="1" to="#arrayLen(myxmldoc['feed']['entry'])#" index="i">
#myxmldoc['feed']['entry'][i]['gd:email'].xmlAttributes.address#<br/>
</cfloop>
</cfoutput>
1<cfset myXmlDoc = xmlParse(cfhttp.fileContent)>
2
3<cfoutput>
4 <cfloop from="1" to="#arrayLen(myxmldoc['feed']['entry'])#" index="i">
5 #myxmldoc['feed']['entry'][i]['gd:email'].xmlAttributes.address#<br/>
6 </cfloop>
7</cfoutput>
There is still some work to do here but this is the bare bones and a starting point for anyone interested.
[More]
Comments (0) | 
Print |
Send |
1081 Views
I have created a public Google Calendar for ColdFusion meetings. The idea I had behind this is that if you run any kind of CF meeting, whether it be online (