Este documento proporciona instrucciones para los usuarios de PeopleForce sobre cómo integrar Google Calendar utilizando Cuentas de Servicio de Google.
Esto permitirá que tu plataforma interactúe con la API de Google Calendar y realice operaciones como crear eventos en los calendarios de los usuarios y verificar la disponibilidad para reuniones uno a uno y entrevistas, sin intervención manual del usuario.
Beneficios
Integrar Google Calendar con PeopleForce ofrece una serie de ventajas:
Programación de entrevistas simplificada: Al automatizar el proceso de programación de entrevistas, puedes ahorrar valioso tiempo administrativo.
Disponibilidad en tiempo real de los empleados: Con la integración, puedes consultar fácilmente la disponibilidad en tiempo real de tus empleados. Esto simplifica el proceso de programación de reuniones uno a uno y eventos de equipo, ya que puedes identificar los horarios adecuados según los calendarios individuales y de equipo.
Colaboración mejorada: Al crear eventos directamente en los calendarios de los usuarios, la integración asegura que todas las partes relevantes estén informadas sobre las reuniones y tareas programadas.
Pre requisitos
Requisitos para la integración de Google Calendar:
Cuenta de Google Cloud Platform (GCP): Necesitarás una cuenta de Google Cloud Platform para configurar la integración.
Conocimiento básico de Google Cloud Console y APIs: Se requiere comprensión básica de cómo usar la Google Cloud Console y trabajar con APIs.
Acceso de Super Administrador para tu dominio de Google Workspace: Se necesita acceso de Super Administrador para poder configurar la integración en el dominio de Google Workspace.
⚠️ Nota importante: Google Workspace no es un servicio gratuito y debe ser adquirido para su uso en la empresa.
Paso 1: Crear un proyecto en Google Cloud
Abre la consola de desarrolladores de Google.
Crea un nuevo proyecto haciendo clic en el menú desplegable de proyectos y seleccionando "Nuevo Proyecto".
Paso 2: Habilita el Google Calendar API
En la Consola de Google Cloud, selecciona tu proyecto.
Desde el panel izquierdo, haz clic en "API y Servicios > Biblioteca".
3. En la búsqueda rápida, busca "Google Calendar API".
4. Haz clic en la tarjeta de la API de Google Calendar API y luego haz clic en "Habilitar".
Paso 3: Crea una cuenta de servicio
Navega a "IAM y administración > Cuentas de servicio" en la Consola de Cloud.
2. Haz clic en "Crear Cuenta de Servicio".
3. Ingresa un nombre y una descripción para la cuenta de servicio.
4.Haz clic en "Crear y continuar" y luego en "Listo".
Paso 4: Genera una clave para la cuenta de servicio
Regresa a la página de "Cuentas de servicio".
Haz clic en la cuenta de servicio que acabas de crear.
Ve a la sección "Claves" y haz clic en "Agregar clave".
4. Seleccione "JSON" para el tipo de clave.
5. Haz clic en "Crear". Esto generará un archivo de clave JSON y lo descargará en tu computadora. Asegúrate de mantener este archivo seguro y accesible, ya que lo necesitarás para que tu aplicación se autentique con Google.
Paso 5: Delegar autoridad a nivel de dominio a tu cuenta de servicio.
Como superadministrador, ve a la consola de administración de tu dominio de Google Workspace.
2. Ve a "Seguridad > Controles de API".
3. En el panel de delegación a nivel de dominio, selecciona "Administrar delegación a nivel de dominio".
4. Haz clic en "Agregar nuevo".
5. En el campo "ID de cliente", ingresa el ID de cliente que se encuentra en tu archivo de clave JSON de la cuenta de servicio.
En el campo "alcances de OAuth", ingresa los siguientes cuatro valores:
7.Haz clic en el botón "Autorizar".
Paso 6: Utiliza la Cuenta de Servicio en PeopleForce.
Ahora, en la plataforma PeopleForce, puedes ingresar la ruta al archivo de clave JSON descargado. Para configurar esta integración, sigue estos pasos: navega a Configuración, selecciona Integraciones y elige Google Calendar. Luego, simplemente pega el archivo JSON de tu cuenta en el campo designado y haz clic en el botón Instalar.
Importante
Todas las acciones realizadas por una cuenta de servicio aparecerán como si fueran realizadas por un usuario cuyo correo electrónico se especificó durante el proceso de "delegar autoridad a nivel de dominio". Asegúrate de utilizar la cuenta de servicio de manera responsable y de cumplir con los términos de uso establecidos por Google.
Preguntas Frecuentes
¿Qué sucederá si los clientes existentes desinstalan la integración y luego intentan reinstalarla?
Los clientes existentes que se hayan integrado anteriormente continuarán con la implementación original y funcionarán con normalidad. Sin embargo, si desinstalan la integración, cuando intenten instalarla nuevamente, ahora se les pedirá la clave JSON utilizando el nuevo método de integración.