Google Calendar API es un conjunto de herramientas que Google pone a disposición de los desarrolladores para que estos accedan a sus servicios de una forma diferente a la realizada directamente en la interfaz proporcionada Google. Mediante estas APIs, específicamente Google Calendar API, podemos acceder mediante servicios web al calendario de Google, donde podemos crear, modificar, eliminar y obtener la lista de calendario y eventos de una cuenta de Google determinada.
El acceso es realizado mediante REST (Representational State Transfer) es una alternativa de servicios web simple que utiliza el protocola HTTP para la transferencia de datos utilizando los metodos GET, POST, PUT DELTELE, se puede encontrar mas acerca de este tema en REST web services.
Para la utilización de Google Calendar API se puede utilizar REST directamente o tambien Google tiene a disposición librerías en algunos lenguajes que facilitan el acceso a estos servicios. En este tutorial no ocuparemos de accedder directamente utilizando REST.
Antes de comenzar debemos haber iniciado sesión con la cuenta de Google que utilizaremos para consumir los servicios,
Configuracion de Google Calendar API para su acceso
- Luego de tener nuestra cuenta iniciada debemos acceder a API Console, es aquí donde creamos el proyecto y activamos los servicios que queremos consumir (Calendar, Tast, Adsense, etc), en la ventana que nos aparece le damos un nombre y luego crear proyecto.
- A continuación en el panel izquierdo de la pagina damos click en el botón services, nos aparecerá una lista de servicios, aca activamos los servicios que deseamos utilizar, en nuestro caso Calendar API.
-Posteriormente en el mismo panel izquierdo seleccionamos la opción API Access, aca se especifican el API key y los Client ID utilizados por nuestras aplicaciones para acceder a los servicios de Google. Para crear un Client ID se debe saber primero con que tipo de aplicación utilizaremos para acceder, estas puede ser Apliaciones Web de lado del servidor, Aplicaciones Web del lado del cliente o aplicaciones de escritorio, luego que sepamos que tipo de aplicación utilizaremos podemos dar click en en Crear un nuevo OAuth ID client, ingresamos el nombre de nuestra aplicacion y un logo que es opcional, luego le damos siguiente y seleccionamos el tipo de aplicación que estamos utilizando en nuestro ejemplo una aplicación web de lado del servidor y la dirección de nuestra aplicación.
Para la autenticacion de acceso a los servicios de Google y evitar posibles abusos por parte de terceros a estas APIs, en esta plataforma se utiliza una metodología de autenticacion que consiste en el intercambio de una claves determinadas para garantizar que el usuario que esta intentando acceder es el que tiene autorización.
Este metodo de autenticacion funciona de la siguiente manera:
Obtener
autorización para ingresar al calendario
Para solicitar el acceso a Google Calendar API se realizar un Request a la siguiente dirección:
https://accounts.google.com/o/oauth2/auth
Esta en el QueryString debe contener la siguiente información:
El tipo de respuesta que estamos requiriendo, que puede tomar los valores de code o token, el primero se utiliza cuando estamos accediendo desde una aplicación web desde el lado del servidor y el segundo desde una aplicación web desde el lado del cliente, es decir, estos se utilizan según desde donde estamos ejecutando el código que enviara la petición de autorización, al final el que me permitirá la interacción sera el token, pero para las aplicaciones web del lado del servidor es necesario primero realizar la petición de code para luego mediante otra petición intercambiarla por un token. Ambos code y token son un conjunto de caracteres alfanumericos que son recibidos en la URL mediante la utilizacion de REST. para nuestro caso utilizaremos code ya que nuestro ejemplo es una aplicación web del lado del servidor, el tipo de ser especificado en el querystring y se fomr al siguiente manera:
response_type=code
Otro parámetro requerido es el ámbito de permisos de nuestra aplicación que pueden ser de solo lectura de modificación y se especifica en el querystring de la siguiente manera:
scope=https://www.googleapis.com/auth/calendar para permisos de modificación
https://www.googleapis.com/auth/calendar.readonly para permisos de solo lectura
Uri de redireccionamiento es otro parámetro quede estar incluido en el querystring de nuestra petición y debe ser la misma a la especificada en el momento de crear el OAuth ID client, cuando la petición de permisos es enviado al servicio web de google este nos lleva a una pagina donde solicita permisos al usuario para acceder al servicio del calendario en su cuenta de google, luego utilizara este valor de URI de redireccionamiento para retornar al usuario a la aplicación. este parámetro se especifica en el querystring de la siguiente manera:
redirect_uri=http://ejemplo.com
Por ultimo, querystring debe contener también el OAuth ID client creado en el paso anterior este lo podemos visualizar en API Console en la sección API Access y se debe especificar de la siguiente manera:
client_id=1004559413974-hf3rvj5kcn525j1t01uk8tap7dimau.apps.googleusercontent.com
Al final nuestra dirección de petición debe quedar de la siguiente manera:
https://accounts.google.com/o/oauth2/auth?
response_type=code&
scope=https://www.googleapis.com/auth/calendar&
redirect_uri=http://localhost:2320/pruebacitas/citas.aspx&
client_id=1004559413974-hf3rvj5kcn525j1t01uk8tap7dimau.apps.googleusercontent.com
Esta es la que enviaremos mediante el método GET que es lo mismo que copiar y pegar esta dirección en el explorador de internet, y es la que nos llevara a la página de autorización de Google donde el usuario deberá garantizar el acceso de nuestra aplicación a los servicios de Google, y como dije anteriormente mediante el parámetro redirect_uri google redireacciona a nuestra aplicación. La respuesta sera una direccion como se muestra a continuación:
http://ejemplo.com?code=asdEd334gf-sdre3eecdd
Esta en el querystring contiene el parametro code que utilizaremos para enviar la petición de token de acceso, una vez se tengo el token sera este el que se utilizara adjunto en los métodos de modificación y consulta del API Calendar y es la forma utilizada por google para realizar el control de permisos de acceso sobre sus servicios a través de estas herramientas.
El paso a seguir es enviar una nueva petición que contenga el code en querystring, este se hace mediante el metodo POST y debe contener lo siguiente
code=4/P7q7W91a-oMsCeLvIaQm6bTrgtp7&
client_id=8819981768.apps.googleusercontent.com&
client_secret={client_secret}&
redirect_uri=https://oauth2-login-demo.appspot.com/code&
grant_type=authorization_code
code es la cadena de caracteres recibida en la peticion de codigo, el client_id es la que obtuvimos al crear OAuth ID Client y que la podemos visualizar en API Console en la sección API Access, client_secret se encuentra también en la sección API Access debajo del valor client_id, redirect_uri es el valor que con anterioridad hemos explicado y grant_type debe contener el valor de authorizacion_code.
Con esta petición Google nos devolverá una dirección que contiene en su querystring el token de acceso al servicio.
Luego de haber realizado los pasos anteriores, ya estamos listos para comenzar a utilizar Google Calendar API para interactuar con nuestro calendario, para probarlo haremos un ejemplo donde obtendremos la lista de eventos creados en un calendario. Esto lo haremos mediante un meotod GET con la siguiente direccion:
https://www.googleapis.com/calendar/v3/calendars/calendarId/events
calendarId es el id del calendario sobre le que queremos realizar la consulta, al final de esta dirección debe añadir en el querystring el access_token obtenido con anterioridad y el api key especificado en la seccion API Access en la Consola del proyecto quedando la dirección de la siguiente manera:
https://www.googleapis.com/calendar/v3/calendars/id_micalendario/events&key=AIzaSyB2YWmtCaKQaJxN4O7Lrtt6QOqP9f-EI3g&access_token=
La respuesta a esta petición sera un objeto tipo con formato JSON que contiene la lista de eventos del calendario que especificamos en la consulta.
Para ver la documentación completa acerca de como crear, eliminar y realizar otro tipo de interacción con Calendar API pueden ingresar al siguiente link: https://developers.google.com/google-apps/calendar/v3/reference/
Y esto ha sido todo en este post espero les sea muy útil.
