Acceder a los contactos con la API de Gmail Contacts

Hace poco en nvivo.es asignaron la tarea de modificar el tema de invitar a tus contactos, en concreto tenemos que dejar de usar una clase que hace web scraping para loguearse y obtener los contactos de windows live, gmail y yahoo.

Las razones:

1. Lo malo de hacer web scraping es que si uno de estos servicios cambia un poco la estructura del HTML te jode el script.
2. gmail, yahoo y hace poco windows live ofrecen una APIs para obtener la lista de contactos, con lo que tienes la garantia de que va a funcionar y que hay documentación.
3. Dar seguridad al usuario, introducir el usuario y el password en una página da mal rollo, si usamos la APIs redirigimos al usuario a la web del servicio para que dé su aprobación.

Ayer publiqué la manera de acceder a los contactos con la API de windows live y llegué a la conclusión de que microsoft no sabe hacer APIs realmente fue complicado, tuvimos que instalar cosas en el servidor, luego el SDK no estaba todo lo necesario y demás historias que me tuve que apañar buscando en google.

Hoy he estado experimentando con la API de Gmail Contacts y ha sido todo lo contrario a la experiencia de ayer, dejo de enrollarme les dejo el script:

Requisitos:

1. php5 y simpleXML
2. curl

Instalación:

1. Descargar el script
2. Descomprimir el fichero GMAIL.zip
3. Abrir config.php y editar la variable $return_url
4. Subir la carpeta GMAIL al servidor

Ejecutar el script:

1. Abrir desde el navegador el fichero:

   http://tudominio.com/GMAIL/index.php

2. Pinchar en dar permisos gmail.
3. Concedes el acceso en la página de google accounts.
4. A continuación se mostrarán por pantalla la lista de contactos, esto se imprime en la linea 36 del fichero index.php.

Notas:

1. Si no defines el parametro max-results sólo se van a cargar 25 contactos.
2. Al pulsar F5 el token caduca, tienes que volver a pulsar de nuevo el enlace “dar permisos gmail”.
3. De momento la API solo ofrece ordenar por “lastmodified” (último modificado), aquí tenéis la documentación con todos los parametros para filtrar y ordenar los resultados.
4. Al obtener los contactos es posible que en la lista salga el email del usuario que se loguea, si es que vas a hacer un script para enviar invitaciones asegurate de descatarlo.
5. Para ocultar la alerta de “Este sitio web no está registrado en Google para establecer una conexión segura para solicitudes de autorización.”, tienes que registar y validar tu sitio, más información sobre como registar tu dominio.