Google Agenda

Versions compatibles

Ce connecteur est compatible avec les API REST Google Agenda.

Avant de commencer

Dans votre projet Google Cloud, effectuez les tâches suivantes :

  • Assurez-vous que la connectivité réseau est configurée. Pour en savoir plus, consultez Connectivité réseau.
  • Attribuez le rôle IAM roles/connectors.admin à l'utilisateur qui configure le connecteur.
  • Attribuez les rôles IAM roles/secretmanager.viewer et roles/secretmanager.secretAccessor au compte de service que vous souhaitez utiliser pour le connecteur.
  • Activez secretmanager.googleapis.com (API Secret Manager) et connectors.googleapis.com (API Connectors). Pour en savoir plus, consultez Activer des services.

Configurer le connecteur

Une connexion est propre à une source de données. Cela signifie que si vous disposez de nombreuses sources de données, vous devez créer une connexion distincte pour chacune d'elles. Pour créer une connexion, procédez comme suit :

  1. Dans la console Cloud, accédez à la page Integration Connectors > Connexions, puis sélectionnez ou créez un projet Google Cloud.

    Accéder à la page "Connexions"

  2. Cliquez sur + CRÉER pour ouvrir la page Créer une connexion.
  3. Dans la section Emplacement, procédez comme suit :
    1. Région : sélectionnez un emplacement dans la liste déroulante.

      Pour obtenir la liste de toutes les régions disponibles, consultez Emplacements.

    2. Cliquez sur Suivant.
  4. Dans la section Détails de la connexion, procédez comme suit :
    1. Connecteur : sélectionnez Google Agenda dans la liste des connecteurs disponibles.
    2. Version du connecteur : sélectionnez la version du connecteur dans la liste des versions disponibles.
    3. Dans le champ Nom de connexion, indiquez le nom de l'instance de connexion. Le nom de la connexion peut contenir des lettres minuscules, des chiffres ou des traits d'union. Il doit commencer par une lettre et se terminer par une lettre ou un chiffre. Il ne doit pas dépasser 49 caractères.
    4. Description : saisissez une description de l'instance de connexion.
    5. (Facultatif) Activez Cloud Logging, puis sélectionnez un niveau de journalisation. Par défaut, le niveau de journalisation est défini sur Error.
    6. Compte de service : sélectionnez un compte de service disposant des rôles requis.
    7. Délai avant expiration de la connexion : (Facultatif) Saisissez le délai avant expiration de la connexion en secondes.
    8. (Facultatif) Configurez les paramètres des nœuds de connexion :

      • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
      • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

      Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter davantage de transactions pour une connexion, vous devez disposer de plus de nœuds. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour améliorer la disponibilité) et le nombre maximal de nœuds sur 50.

    9. + AJOUTER UNE ÉTIQUETTE : cliquez sur cette option pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
    10. Cliquez sur Suivant.
  5. Dans la section Authentification, saisissez les informations d'authentification.
    1. Sélectionnez un type d'authentification, puis saisissez les informations appropriées.

      Les types d'authentification suivants sont compatibles avec la connexion Google Agenda :

      • Authentification par compte de service
      • Jeton de support JWT OAuth 2.0
      • Code d'autorisation OAuth 2.0

      Pour savoir comment configurer ce type d'authentification, consultez Configurer l'authentification.

    2. Cliquez sur Suivant.
  6. Vérifier : vérifiez vos informations de connexion et d'authentification.
  7. Cliquez sur Créer.

Configurer l'authentification

Saisissez les informations en fonction de l'authentification que vous souhaitez utiliser.

  • Authentification par compte de service : aucune configuration supplémentaire n'est requise pour ce type d'authentification. Le compte de service que vous avez sélectionné dans la section Informations de connexion sera utilisé pour l'authentification.
  • Jeton de support JWT OAuth 2.0
    • Certificat JWT : sélectionnez le certificat à utiliser pour l'authentification JWT.
    • Version du secret : saisissez la version secrète du certificat JWT.
    • Sujet JWT : saisissez le sujet JWT.
  • Code d'autorisation OAuth 2.0
    • ID client : saisissez l'ID client à utiliser pour l'authentification OAuth.
    • Niveaux d'accès : saisissez une liste des niveaux d'accès souhaités.
    • Code secret du client : saisissez le code secret du client à utiliser pour l'authentification OAuth.
    • Version du secret : saisissez la version du secret du code secret du client.

Exemples de configuration de connexion

Cette section présente des exemples de valeurs pour les différents champs que vous configurez lorsque vous créez la connexion.

Type de connexion du compte de service

Nom du champ Détails
Emplacement us-central1
Connecteur Google Agenda
Version du connecteur 1
Nom de connexion service-account-auth
Activer Cloud Logging Oui
Compte de service iam.gserviceaccount.com
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
Authentification Oui
Authentification par compte de service Oui

Type de connexion avec un jeton de support JWT OAuth 2.0

Nom du champ Détails
Emplacement us-central1
Connecteur Google Agenda
Version du connecteur 1
Nom de connexion jwt-bearer-auth
Activer Cloud Logging Oui
Compte de service iam.gserviceaccount.com
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
Authentification Oui
Jeton de support JWT OAuth 2.0 Oui
Certificat JWT projects/google-cloud-project/secrets/jwt-cert/versions/1
Version du secret 1

Type de connexion avec un code d'autorisation OAuth 2.0

Nom du champ Détails
Emplacement us-central1
Connecteur Google Agenda
Version du connecteur 1
Nom de connexion gcpcloud-googlecalendar-rest-conn
Activer Cloud Logging Oui
Compte de service iam.gserviceaccount.com
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
Authentification Oui
ID client 60875425788659-mt0cm1tguyiagvst468fvaw7.apps.googleusercontent.com
Champ d'application https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/drive
Code secret du client ygdruoX-Rtyah9gzkdZc-7CB0Eng9hyaufD0VD
Version du secret 1

Limites du système

Le connecteur Google Agenda peut traiter au maximum deux transactions par seconde et par nœud, et limite les transactions au-delà de ce seuil. Par défaut, Integration Connectors alloue deux nœuds (pour améliorer la disponibilité) à une connexion.

Pour en savoir plus sur les limites applicables à Integration Connectors, consultez Limites.

Utiliser la connexion Google Agenda dans une intégration

Une fois la connexion créée, elle devient disponible dans Apigee Integration et Application Integration. Vous pouvez utiliser la connexion dans une intégration au moyen de la tâche "Connecteurs".

  • Pour savoir comment créer et utiliser la tâche de connecteurs dans Apigee Integration, consultez Tâche "Connecteurs".
  • Pour savoir comment créer et utiliser la tâche "Connecteurs" dans Application Integration, consultez Tâche "Connecteurs".

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Lister tous les agendas

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Calendars dans la liste Entity.
  3. Sélectionnez l'opération List, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez définir la filterClause en fonction des exigences du client.

    5. Vous devez placer la valeur d'une clause de filtre entre des guillemets simples (').

    Vous pouvez utiliser la clause de filtre pour filtrer les enregistrements en fonction des colonnes.

Exemple : Obtenir les détails d'un agenda

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Calendars dans la liste Entity.
  3. Sélectionnez l'opération Get, puis cliquez sur OK.
  4. Définissez entityId sur "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com", qui est la clé à transmettre.
  5. Pour définir entityId, dans la section Data Mapper de Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" dans le champ Valeur d'entrée et définissez entityId comme variable locale.

    6. La valeur de entityId doit être transmise directement, par exemple "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com". Ici, "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" est la valeur de clé primaire unique qui doit être transmise.

    Dans certains cas, la transmission d'un entityId peut générer une erreur si l'entité utilise deux clés composites. Dans ce cas, vous pouvez utiliser filterClause pour transmettre la valeur, par exemple id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

Exemple : Supprimer un agenda

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Calendars dans la liste Entity.
  3. Sélectionnez l'opération Delete, puis cliquez sur OK.
  4. Définissez entityId sur "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com", qui est la clé à transmettre. Pour définir entityId, dans la section Data Mapper de la tâche Mappage de données, cliquez sur Ouvrir l'éditeur de mappage de données, puis saisissez "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" dans le champ Valeur d'entrée et définissez entityId comme variable locale.

    Si l'entité comporte deux clés métier ou clés primaires composites, vous pouvez définir la filterClause sur id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com' au lieu de spécifier l'entityId.

Exemple : Créer un agenda

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Calendars dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et définissez connectorInputPayload comme variable locale. 
    {
  "Summary": "New calendar"
}

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche calendar aura une valeur semblable à la suivante :

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

Exemple : Créer un événement dans un agenda

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez AllCalendars dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et définissez connectorInputPayload comme variable locale. 
    {
  "Summary": "New event",
  "CalendarId": "c_b4e891cebb19267bf5ac838f0c5f691bee164a7cec9dcc1a93e54625279baa80@group.calendar.altostrat.com",
  "StartDate": "2025-09-01",
  "EndDate": "2025-09-02"
}

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche calendar aura une valeur semblable à la suivante :

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

Exemple : Créer un événement dans votre agenda principal

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez votre adresse e-mail dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et définissez connectorInputPayload comme variable locale. 
    {
  "Summary": "new event for my calendar",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDate": "2025-09-01",
  "EndDate": "2025-09-02"
}

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche AllCalendars aura une valeur semblable à la suivante :

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

Exemple : Créer un type d'événement dans un agenda

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez AllCalendars dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et définissez connectorInputPayload comme variable locale. 
    {
  "EventType": "outOfOffice",
  "Summary": "outOfOffice",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDateTime": "2025-09-03 14:00:00",
  "EndDateTime": "2025-09-03 15:00:00"
}

    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche AllCalendars aura une valeur semblable à la suivante :

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

Exemple : Créer un événement récurrent dans un agenda

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez AllCalendars dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et définissez connectorInputPayload comme variable locale. 
    {
  "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 l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche AllCalendars aura une valeur semblable à la suivante :

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

Exemple : Mettre à jour les informations d'un agenda

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Calendars dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et définissez connectorInputPayload comme variable locale. 
    {
  "Summary": "Updated from Google Cloud"
}
  5. Définissez entityId dans Data Mapper sur l'entité Calendar.
  6. Pour définir entityId, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et définissez entityId comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

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

Exemple : Mettre à jour les détails de tous les agendas

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez AllCalendars dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Data Mapper de la tâche Mappage de données, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et définissez connectorInputPayload comme variable locale. 
    {
  "Summary": "Great event"
}
  5. Définissez entityId dans Data Mapper sur l'entité AllCalendars.
  6. Pour définir entityId, cliquez sur Open Data Mapping Editor, puis saisissez une valeur semblable à la suivante dans le champ Input Value et définissez entityId comme variable locale.

    Au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur Summary='New sep event'.

    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :

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

Demander de l'aide à la communauté Google Cloud

Vous pouvez publier vos questions et discuter de ce connecteur sur les forums Cloud de la communauté Google Cloud.

Étapes suivantes