Calendario de Google

Versiones compatibles

Este conector admite las APIs de REST del Calendario de Google.

Antes de comenzar

En tu proyecto de Google Cloud, realiza las siguientes tareas:

  • Asegúrate de que la conectividad de red esté configurada. Para obtener más información, consulta Conectividad de red.
  • Otorga el rol de IAM roles/connectors.admin al usuario que configura el conector.
  • Otorga los roles de IAM roles/secretmanager.viewer y roles/secretmanager.secretAccessor a la cuenta de servicio que deseas usar para el conector.
  • Habilita secretmanager.googleapis.com (API de Secret Manager) y connectors.googleapis.com (API de Connectors). Para obtener más información, consulta Cómo habilitar servicios.

Configura el conector

Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, haz lo siguiente:

  1. En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.

    Ir a la página Conexiones

  2. Haz clic en + CREAR NUEVO para abrir la página Crear conexión.
  3. En la sección Ubicación, completa lo siguiente:
    1. Región: selecciona una ubicación de la lista desplegable.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

    2. Haz clic en Siguiente.
  4. En la sección Detalles de la conexión, completa lo siguiente:
    1. Conector: Selecciona Calendario de Google en la lista de conectores disponibles.
    2. Versión del conector: Selecciona la versión del conector de la lista de versiones disponibles.
    3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión. El nombre de la conexión puede contener letras minúsculas, números o guiones. El nombre debe comenzar con una letra y terminar con una letra o un número, y no debe superar los 49 caracteres.
    4. Descripción: Ingresa una descripción para la instancia de conexión.
    5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
    6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
    7. Tiempo de espera de conexión: De manera opcional, ingresa el tiempo de espera de conexión en segundos.
    8. De manera opcional, configura los parámetros de nodo de conexión:

      • Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
      • Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.

      Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.

    9. + AGREGAR ETIQUETA: Haz clic aquí para agregar una etiqueta a la conexión en forma de un par clave-valor.
    10. Haz clic en Siguiente.
  5. En la sección Autenticación, ingresa los detalles de autenticación.
    1. Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.

      La conexión de Calendario de Google admite los siguientes tipos de autenticación:

      • Autenticación de cuenta de servicio
      • OAuth 2.0, portador de JWT
      • Código de autorización de OAuth 2.0

      Para comprender cómo configurar estos tipos de autenticación, consulta Configura la autenticación.

    2. Haz clic en Siguiente.
  6. Revisa: Revisa tus detalles de conexión y autenticación.
  7. Haz clic en Crear.

Configura la autenticación

Ingresa los detalles según la autenticación que desees usar.

  • Autenticación de cuenta de servicio: No se requiere configuración adicional para este tipo de autenticación. La cuenta de servicio que seleccionaste en la sección Detalles de la conexión se usará para la autenticación.
  • OAuth 2.0, portador de JWT
    • Certificado JWT: Selecciona el certificado que se usará para la autenticación de JWT.
    • Versión del secreto: Ingresa la versión del secreto del certificado JWT.
    • Asunto del JWT: Ingresa el asunto del JWT.
  • Código de autorización de OAuth 2.0
    • ID de cliente: Ingresa el ID de cliente que se usará para la autenticación de OAuth.
    • Permisos: Ingresa una lista de los permisos deseados.
    • Secreto del cliente: Ingresa el secreto del cliente que se usará para la autenticación de OAuth.
    • Versión del secreto: Ingresa la versión del secreto del secreto del cliente.

Muestras de configuración de conexión

En esta sección, se enumeran los valores de muestra para los distintos campos que configuras cuando creas la conexión.

Tipo de conexión de la cuenta de servicio

Nombre del campo Detalles
Ubicación us-central1
Conector Calendario de Google
Versión del conector 1
Nombre de la conexión service-account-auth
Habilita Cloud Logging Sí
Cuenta de servicio iam.gserviceaccount.com
Cantidad mínima de nodos 2
Cantidad máxima de nodos 50
Autenticación Sí
Autenticación de cuenta de servicio Sí

Tipo de conexión de portador de JWT de OAuth 2.0

Nombre del campo Detalles
Ubicación us-central1
Conector Calendario de Google
Versión del conector 1
Nombre de la conexión jwt-bearer-auth
Habilita Cloud Logging Sí
Cuenta de servicio iam.gserviceaccount.com
Cantidad mínima de nodos 2
Cantidad máxima de nodos 50
Autenticación Sí
Portador de JWT de OAuth 2.0 Sí
Certificado JWT projects/google-cloud-project/secrets/jwt-cert/versions/1
Versión del Secret 1

OAuth 2.0: Tipo de conexión de código de autorización

Nombre del campo Detalles
Ubicación us-central1
Conector Calendario de Google
Versión del conector 1
Nombre de la conexión gcpcloud-googlecalendar-rest-conn
Habilita Cloud Logging Sí
Cuenta de servicio iam.gserviceaccount.com
Cantidad mínima de nodos 2
Cantidad máxima de nodos 50
Autenticación Sí
ID de cliente 60875425788659-mt0cm1tguyiagvst468fvaw7.apps.googleusercontent.com
Alcance https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/drive
Secreto del cliente ygdruoX-Rtyah9gzkdZc-7CB0Eng9hyaufD0VD
Versión del Secret 1

Limitaciones del sistema

El conector de Calendario de Google puede procesar un máximo de 2 transacciones por segundo, por nodo, y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para una mejor disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Usa la conexión del Calendario de Google en una integración

Después de crear la conexión, estará disponible en la integración de Apigee y en Application Integration. Puedes usar la conexión en una integración a través de la tarea Connectors.

  • Para comprender cómo crear y usar la tarea de conectores en Apigee Integration, consulta Tarea de conectores.
  • Para comprender cómo crear y usar la tarea Connectors en Application Integration, consulta tarea Connectors.

Ejemplos de operaciones de entidades

En esta sección, se muestra cómo realizar algunas de las operaciones de entidades en este conector.

Ejemplo: Enumera todos los calendarios

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Calendars en la lista Entity.
  3. Selecciona la operación List y haz clic en Listo.
  4. En la sección Entrada de tarea de la tarea Connectors, puedes establecer la filterClause según los requisitos del cliente.

    5. Debes usar comillas simples ("'") para incluir el valor de un filterClause.

    Puedes usar filterClause para filtrar registros según las columnas.

Ejemplo: Obtén detalles del calendario

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Calendars en la lista Entity.
  3. Selecciona la operación Get y haz clic en Listo.
  4. Establece entityId en "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com", que es la clave que se pasará.
  5. Para establecer el entityId, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" en el campo Input Value y establece el entityId como variable local.

    6. El valor de entityId debe pasarse directamente, como "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com". Aquí, "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" es el valor único de la clave primaria, que se debe pasar.

    En ciertos casos, pasar un entityId podría arrojar un error si la entidad usa dos claves compuestas. En esos casos, puedes usar filterClause para pasar el valor, como id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

Ejemplo: Borra un calendario

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Calendars en la lista Entity.
  3. Selecciona la operación Delete y haz clic en Listo.
  4. Establece entityId en "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com", que es la clave que se pasará. Para establecer el entityId, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" en el campo Input Value y establece el entityId como variable local.

    Si la entidad tiene dos claves comerciales o principales compuestas, en lugar de especificar entityId, también puedes establecer filterClause en id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

Ejemplo: Crea un calendario

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Calendars en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y configura connectorInputPayload como variable local. 
    {
  "Summary": "New calendar"
}

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea calendar tendrá un valor similar al siguiente:

    {
  "Id": "c_5bae32e1c48ed38af98efecbd6da6bb002a31e887276aa65cc2530717123b75f@group.calendar.altostrat.com"
}

Ejemplo: Crea un evento en un calendario

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona AllCalendars en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y configura connectorInputPayload como variable local. 
    {
  "Summary": "New event",
  "CalendarId": "c_b4e891cebb19267bf5ac838f0c5f691bee164a7cec9dcc1a93e54625279baa80@group.calendar.altostrat.com",
  "StartDate": "2025-09-01",
  "EndDate": "2025-09-02"
}

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea calendar tendrá un valor similar al siguiente:

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Ejemplo: Crea un evento en tu calendario principal

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona tu ID de correo electrónico en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y configura connectorInputPayload como variable local. 
    {
  "Summary": "new event for my calendar",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDate": "2025-09-01",
  "EndDate": "2025-09-02"
}

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea AllCalendars tendrá un valor similar al siguiente:

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Ejemplo: Crea un tipo de evento en un calendario

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona AllCalendars en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y configura connectorInputPayload como variable local. 
    {
  "EventType": "outOfOffice",
  "Summary": "outOfOffice",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDateTime": "2025-09-03 14:00:00",
  "EndDateTime": "2025-09-03 15:00:00"
}

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea AllCalendars tendrá un valor similar al siguiente:

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Ejemplo: Crea un evento recurrente en un calendario

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona AllCalendars en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y configura connectorInputPayload como variable local. 
    {
  "Summary": "Google Cloud Recurring event",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDateTime": "2025-11-2 14:00:00",
  "EndDateTime": "2025-11-2 14:30:00",
  "Recurrences": "RRULE:FREQ=WEEKLY;BYDAY=TH;COUNT=5",
  "StartDateTimeZone": "America/Los_Angeles",
  "EndDateTimeZone": "America/Los_Angeles"
}

    Si la integración se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea AllCalendars tendrá un valor similar al siguiente:

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Ejemplo: Actualiza los detalles del calendario

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Calendars en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y configura connectorInputPayload como variable local. 
    {
  "Summary": "Updated from Google Cloud"
}
  5. Establece entityId en Data Mapper como la entidad del Calendario.
  6. Para establecer el entityId, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y establece el entityId como variable local.

    En lugar de especificar entityId, también puedes establecer filterClause en id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "Id": "c_5bae32e1c48ed38af98efecbd6da6bb002a31e887276aa65cc2530717123b75f@group.calendar.altostrat.com"
}

Ejemplo: Actualiza todos los detalles de los calendarios

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona AllCalendars en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. En la sección Data Mapper de la tarea Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y establece connectorInputPayload como variable local. 
    {
  "Summary": "Great event"
}
  5. Establece entityId en Data Mapper en la entidad de AllCalendars.
  6. Para establecer el entityId, haz clic en Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input Value y establece el entityId como variable local.

    En lugar de especificar entityId, también puedes establecer filterClause en Summary='New sep event'.

    Cuando ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Obtén ayuda de la Comunidad de Google Cloud

Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.

¿Qué sigue?