Slack

Le connecteur Slack vous permet d'effectuer des opérations d'insertion, de suppression, de mise à jour et de lecture sur les données Slack.

Avant de commencer

Avant d'utiliser le connecteur Slack, effectuez les tâches suivantes:

  • Dans votre projet Google Cloud :
    • Vérifiez que la connectivité réseau est configurée. Pour en savoir plus sur les modèles réseau, consultez la section Connectivité réseau.
    • Attribuez le rôle IAM roles/connectors.admin à l'utilisateur qui configure le connecteur.
    • Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le connecteur :
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Un compte de service est un compte Google spécial destiné à représenter un utilisateur non humain qui doit s'authentifier et obtenir les autorisations permettant d'accéder aux données des API Google. Si vous ne possédez pas de compte de service, vous devez en créer un. Pour plus d'informations, consultez la section Créer un compte de service.

    • Activez les services suivants :
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Pour savoir comment activer des services, consultez la page Activer des services.

    Si ces services ou autorisations n'ont pas encore été activés pour votre projet, vous êtes invité à les activer lors de la configuration du connecteur.

  • Pour savoir comment créer un espace de travail Slack, consultez Démarrage rapide avec Slack. Pour en savoir plus sur la plate-forme Slack, consultez la présentation de la plate-forme Slack.

Configurer le connecteur

Pour configurer le connecteur, vous devez créer une connexion à votre source de données (système backend). Une connexion est spécifique à 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 > Connections (Connecteurs d'intégration > 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, choisissez l'emplacement de la connexion.
    1. Région : sélectionnez un emplacement dans la liste déroulante.

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

    2. Cliquez sur SUIVANT.
  4. Dans la section Détails de la connexion, procédez comme suit :
    1. Connecteur: sélectionnez Slack dans la liste déroulante des connecteurs disponibles.
    2. Version du connecteur : sélectionnez la version du connecteur dans la liste déroulante des versions disponibles.
    3. Dans le champ Nom de connexion, saisissez un nom pour l'instance de connexion.

      Les noms de connexion doivent répondre aux critères suivants :

      • Les noms de connexion peuvent contenir des lettres, des chiffres ou des traits d'union.
      • Les lettres doivent être en minuscules.
      • Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
      • Les noms de connexion ne peuvent pas dépasser 63 caractères.
    4. Saisissez éventuellement une Description pour l'instance de connexion.
    5. Vous pouvez également activer Cloud Logging, puis sélectionner 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. Vous pouvez également configurer les paramètres du nœud 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 plus de transactions pour une connexion, plus de nœuds sont nécessaires. À l'inverse, moins de nœuds sont nécessaires pour traiter moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez la section 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 une meilleure disponibilité) et le nombre maximal sur 50.

    8. Vous pouvez également cliquer sur + AJOUTER UN LIBELLÉ pour ajouter un libellé à la connexion sous la forme d'une paire clé/valeur.
    9. Cliquez sur NEXT (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 Slack:

      • OAuth2.0 - Code d'autorisation
      • Authentification par jeton utilisateur

      2. Pour comprendre comment configurer ces types d'authentification, consultez la section Configurer l'authentification.

    2. Cliquez sur NEXT (Suivant).
  6. Vérifiez vos informations de connexion et d'authentification.
  7. Cliquez sur Créer.

Configurer l'authentification

Saisissez les détails en fonction de l'authentification que vous souhaitez utiliser.

  • OAuth2.0 : code d'autorisation

    Pour vous authentifier à l'aide d'OAuth 2.0, saisissez les informations suivantes:

    • ID client : ID client fourni par le connecteur pour l'application que vous avez créée.
    • Champs d'application: liste des champs d'application souhaités, séparés par une virgule.
    • Code secret du client: secret Secret Manager contenant le code secret client pour l'application connectée que vous avez créée.
    • Version du secret: version du secret sélectionné ci-dessus.
  • Authentification par jeton utilisateur

    Pour vous authentifier à l'aide d'un jeton utilisateur, saisissez les informations suivantes:

    • Jeton utilisateur: jeton utilisateur utilisé pour authentifier l'utilisateur.
    • Version du secret: version du secret sélectionné ci-dessus.

Pour le type d'authentification Authorization code, après avoir créé la connexion, vous devez effectuer quelques étapes supplémentaires pour configurer l'authentification. Pour en savoir plus, consultez la section Étapes supplémentaires après la création de la connexion.

Étapes supplémentaires après la création de la connexion

Si vous avez sélectionné OAuth 2.0 - Authorization code pour l'authentification, vous devez effectuer les étapes supplémentaires suivantes après avoir créé la connexion:

  1. Sur la page Connexions, recherchez la connexion que vous venez de créer.

    Notez que l'état du nouveau connecteur est Autorisation requise.

  2. Cliquez sur Autorisation requise.

    Le volet Modifier l'autorisation s'affiche.

  3. Copiez la valeur de l'URI de redirection dans votre application externe.
  4. Vérifiez les informations d'autorisation.
  5. Cliquez sur Autoriser.

    Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

Effectuer une nouvelle autorisation au code d'autorisation

Si vous utilisez le type d'authentification Authorization code et que vous avez modifié la configuration de votre application, vous devez autoriser à nouveau votre connexion OneDrive. Pour réautoriser une connexion, procédez comme suit:

  1. Cliquez sur la connexion requise sur la page Connexions.

    La page des détails de la connexion s'ouvre.

  2. Cliquez sur Modifier pour modifier les détails de la connexion.
  3. Vérifiez les informations OAuth 2.0 – Code d'autorisation dans la section Authentification.

    Si nécessaire, apportez les modifications nécessaires.

  4. Cliquez sur Enregistrer. Vous êtes redirigé vers la page d'informations sur la connexion.
  5. Cliquez sur Modifier l'autorisation dans la section Authentification. Le volet Authorize (Autoriser) s'affiche.
  6. Cliquez sur Autoriser.

    Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

Exemples de configuration de connexion

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

Slack : type de connexion d'authentification UserToken

Nom du champ Détails
Emplacement us-central1
Connecteur Slack
Version du connecteur 1
Nom de connexion slack-usertoken-connection
Activer Cloud Logging Oui
Compte de service SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Niveau de verbosité 5
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
Authentification par jeton utilisateur Oui
Jeton utilisateur USER_TOKEN
Version du secret 1

Slack : type de connexion d'authentification OAuth 2.0

Nom du champ Détails
Emplacement us-central1
Connecteur Slack
Version du connecteur 1
Nom de connexion slack-google-cloud-oauth-conn
Activer Cloud Logging Oui
Compte de service SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Niveau de verbosité 5
Nombre minimal de nœuds 2
Nombre maximal de nœuds 50
OAuth 2.0 - Code d'autorisation Oui
ID client CLIENT_ID
Niveaux d'accès channels:read, groups:read, im:read, mpim:read, channels:write, groups:write,
im:write,mpim:write, channels:history, groups:history, im:history, mpim:history,
search:read, chat:write:user, chat:write:bot, files:read, files:write:user, pins:read,
pins:write,usergroups:read, usergroups:write, reminders:read, reminders:write,
users:read, users.profile:write
Code secret du client CLIENT_SECRET
Version du secret 2

Limites du système

Le connecteur Slack peut traiter une seule transaction par seconde et par nœud, et limite les transactions dépassant cette limite. Par défaut, les Integration Connectors allouent deux nœuds (pour une meilleure disponibilité) à une connexion.

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

Utiliser la connexion Slack dans une intégration

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

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

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que via cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

  • Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connecté. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, dans un connecteur de serveur de fichiers, les dossiers sont les entités et, dans un connecteur de système de messagerie, les files d'attente sont les entités.

    Toutefois, il est possible qu'un connecteur ne soit pas compatible ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

  • Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Vous pouvez effectuer l'une des opérations suivantes sur une entité :

    La sélection d'une entité dans la liste disponible génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche de connecteur. Toutefois, si un connecteur n'est pas compatible avec l'une des opérations d'entité, ces opérations non compatibles ne sont pas listées dans la liste Operations.

  • Action : une action est une fonction de première classe mise à la disposition de l'intégration via l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur ne prenne en charge aucune action, auquel cas la liste Actions est vide.

Actions

Cette section répertorie les actions compatibles avec le connecteur Slack. Pour savoir comment configurer les actions, consultez Exemples d'actions.

Action InviteUser

Cette action invite les utilisateurs à rejoindre une chaîne.

Paramètres d'entrée de l'action InviteUser

Nom du paramètre Type de données Obligatoire Description
ChannelId Chaîne Vrai ID de la chaîne publique ou privée à laquelle inviter un ou plusieurs utilisateurs.
Utilisateurs Chaîne Vrai Liste d'ID utilisateur séparés par une virgule. Vous pouvez spécifier jusqu'à 30 ID utilisateur.

Pour obtenir un exemple de configuration de l'action InviteUser, consultez Exemple InviteUser.

Action CloseChannel

Cette action ferme un message privé ou un message privé multipersonne.

Paramètres d'entrée de CloseChannel

Nom du paramètre Type de données Obligatoire Description
ChannelId Chaîne Vrai ID de la conversation à fermer.

Pour obtenir un exemple de configuration de l'action CloseChannel, consultez CloseChannel Example (Exemple de CloseChannel).

Action JoinChannel

Cette action permet à un utilisateur de rejoindre une conversation existante.

Paramètres d'entrée de JoinChannel

Nom du paramètre Type de données Obligatoire Description
ChannelId Chaîne Vrai ID de la chaîne à rejoindre.

Pour savoir comment configurer l'action JoinChannel, consultez l'exemple JoinChannel.

Action LeaveChannel

Cette action permet à un utilisateur de quitter une conversation.

Paramètres d'entrée de LeaveChannel

Nom du paramètre Type de données Obligatoire Description
ChannelId Chaîne Vrai Identifiant de la conversation à quitter.

Pour obtenir un exemple de configuration de l'action LeaveChannel, consultez Exemple LeaveChannel.

Action "Ouvrir la chaîne"

Cette action ouvre ou reprend un message privé ou un message privé multipersonne.

Paramètres d'entrée d'OpenChannel

Nom du paramètre Type de données Obligatoire Description
ChannelId Chaîne Vrai Pour reprendre une conversation, indiquez l'ID du message instantané ou du message instantané multipersonne, ou spécifiez les ID utilisateur.
Utilisateurs Chaîne Vrai Listes d'utilisateurs séparées par une virgule. Si vous ne spécifiez qu'un seul utilisateur, un message privé individuel est créé. Si vous ne spécifiez aucun utilisateur, spécifiez un ID de canal pour reprendre une conversation.

Pour obtenir un exemple de configuration de l'action OpenChannel, consultez Exemple OpenChannel.

Action DownloadFile

Cette action télécharge un fichier.

Paramètres d'entrée de DownloadFile

Nom du paramètre Type de données Accepte les flux de sortie Description
FileId Chaîne Faux ID du fichier à télécharger
FileLocation Chaîne Faux Emplacement où le fichier doit être téléchargé
FileStream Chaîne Vrai Instance d'un flux de sortie dans lequel écrire les données de fichier. Ce champ est utilisé si le champ FileLocation n'est pas spécifié.
Encodage Chaîne Faux Type d'encodage de FileData. Vous pouvez spécifier BASE64 ou NONE. La valeur par défaut est BASE64.

Pour savoir comment configurer l'action DownloadFile, consultez Exemple DownloadFile.

Action EndDnd

Cette action met fin au mode Ne pas déranger d'un utilisateur.

Paramètres d'entrée de l'action EndDnd

Transmettez un fichier JSON vide, tel que {}.

Pour obtenir un exemple de configuration de l'action EndDnd, consultez Exemple EndDnd.

Action SetSnooze

Cette action active le mode Ne pas déranger pour l'utilisateur ou modifie sa durée.

Paramètres d'entrée de l'action SetSnooze

Nom du paramètre Type de données Obligatoire Description
NumOfMinutes Chaîne 60 Nombre de minutes pendant lesquelles l'utilisateur est mis en veille.

Pour savoir comment configurer l'action SetSnooze, consultez l'exemple SetSnooze.

Action EndSnooze

Cette action met fin au mode répétition de l'utilisateur.

Paramètres d'entrée de l'action EndSnooze

Transmettez un fichier JSON vide, tel que {}.

Pour savoir comment configurer l'action EndSnooze, consultez l'exemple EndSnooze.

Action SendScheduleMessage

Cette action planifie l'envoi d'un message à une chaîne.

Paramètres d'entrée de l'action SendScheduleMessage

Transmettez un fichier JSON vide, tel que {}.

Pour obtenir un exemple de configuration de l'action SendScheduleMessage, consultez Exemple SendScheduleMessage.

Exemples d'actions

Exemple : InviteUser

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action InviteUser, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
  "ChannelId": "C06Q6NTRNA2",
  "Users": "U070MCLRREW"
}

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche InviteUser aura une valeur semblable à celle-ci:

     
 [{
  "Success": "true"
}]

Exemple : CloseChannel

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CloseChannel, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
  "ChannelId": "C075U92TU4U"
}

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche CloseChannel aura une valeur semblable à celle-ci:

     
 [{
  "Success": "true"
}]

Exemple : JoinChannel

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action JoinChannel, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
  "ChannelId": "C06UMDTL1EH"
}

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche JoinChannel aura une valeur semblable à celle-ci:

     
 [{
  "Success": "true"
}]

Exemple : LeaveChannel

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action LeaveChannel, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
  "ChannelId": "C06UME4PM2R"
}

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche LeaveChannel aura une valeur semblable à celle-ci:

     
 [{
  "Success": "true"
}]

Exemple : OpenChannel

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action OpenChannel, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
"Users": "U06VCS3NDNC,U06NE4KAL0G",
"ChannelId": "C071CU9UXFF"
}

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche OpenChannel aura une valeur semblable à celle-ci:

     
[{
"Success": "true"
}]

Exemple : DownloadFile

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action DownloadFile, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
  "FileId": "F075UHEMSN8",
  "HasBytes": true
}

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche DownloadFile aura une valeur semblable à celle-ci:

    [{
  "Success": "True",
  "ContentBytes": "JVBERi0xLjMKJcTl8uXrp/Og0MTGCjQgMCBvYmoKPDwgL0xlbmd0aCA1IDAgUiAvRmlsdGVyIC9GbGF0ZURlY29kZSA"
}]

Autres considérations

  • Définissez "HasBytes" sur "True" pour télécharger d'autres formats de fichiers, tels que PDF ou XLSX, qui fournissent le contenu au format encodé en base64.
  • Pour télécharger un fichier au format txt, définissez "HasBytes" sur "True" et téléchargez le contenu du fichier sous forme d'octets. Pour télécharger le contenu réel du fichier, définissez "HasBytes" sur "False".

Exemple : EndDnd

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action EndDnd, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {}

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche EndDnd aura une valeur semblable à celle-ci:

     
 [{
  "Success": "true"
}]

Exemple : SetSnooze

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action SetSnooze, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
     {
  "NumOfMinutes": "60"
}

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche SetSnooze aura une valeur semblable à celle-ci:

     
 [{
  "Success": "true",
  "SnoozeEnabled": "true",
  "SnoozeEndTime": "1722842455",
  "SnoozeRemaining": "3600",
  "SnoozeIsIndefinite": "false"
}]

Exemple : EndSnooze

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action EndSnooze, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {}

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche EndSnooze aura une valeur semblable à celle-ci:

     
  [{
  "Success": "true",
  "DndEnabled": "true",
  "NextDndStartTime": "1722875400",
  "NextDndEndTime": "1722911400",
  "SnoozeEnabled": "false"
}]

Exemple : SendScheduleMessage

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action SendScheduleMessage, puis cliquez sur OK.
  3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
     {
  "Channel": "C07AMLB39JN",
  "PostAt": "2024-08-27 14:15:00.0",
  "Text": "Hello, World!",
  "ReplyBroadCast": false
 }

    4. Si l'action réussit, le paramètre de réponse connectorOutputPayload de la tâche SendScheduleMessage aura une valeur semblable à celle-ci:

     
   [{
  "Success": "true",
  "ok": "true",
  "scheduled_message_id": "Q07KD4YSG72",
  "channel": "C07AMLB39JN",
  "post_at": "1724768100",
  "message_user": "U071FD3TS8P",
  "message_type": "message",
  "message_bot_id": "B076304QR9V",
  "message_app_id": "A076HCDGHT5",
  "message_text": "Hello, World!",
  "message_team": "T071W04MGV8",
  "message_bot_profile_id": "B076304QR9V",
  "message_bot_profile_deleted": "false",
  "message_bot_profile_name": "Googlecloud_OAuth_Slack",
  "message_bot_profile_updated": "1717513424",
  "message_bot_profile_app_id": "A076HCDGHT5",
  "message_bot_profile_icons_image_36": "https://a.slack-edge.com/80588/img/plugins/app/bot_36.png",
  "message_bot_profile_icons_image_48": "https://a.slack-edge.com/80588/img/plugins/app/bot_48.png",
  "message_bot_profile_icons_image_72": "https://a.slack-edge.com/80588/img/plugins/app/service_72.png",
  "message_bot_profile_team_id": "T071W04MGV8",
  "message_blocks_type": "rich_text",
  "message_blocks_block_id": "MYA",
  "message_blocks_elements_type": "rich_text_section",
  "message_blocks_elements_elements_type": "text",
  "message_blocks_elements_elements_text": "Hello, World!"
}]

Exemples d'opérations d'entité

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

Exemple : Lister les enregistrements de l'entité "Messages"

Cet exemple liste les enregistrements de l'entité Messages.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Messages dans la liste Entity.
  3. Sélectionnez l'opération List, puis cliquez sur OK.

Vous pouvez également effectuer des opérations de liste sur les entités suivantes : Files, MessageReplies, Pins, Reactions, Reminders,TeamInfo, UserGroups, Users, Channels, DND, Teams, UserProfile, ScheduledMessages, TeamProfileFields et TeamProfileSections.

Exemple : Obtenir les enregistrements de l'entité "Appels"

Cet exemple extrait les enregistrements de l'entité Calls.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Calls dans la liste Entity.
  3. Sélectionnez l'opération Get, puis cliquez sur OK.
  4. Définissez l'ID de l'entité sur R070LKL3YKX, qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur EntityId, puis saisissez R070LKL3YKX dans le champ Default Value (Valeur par défaut).

La valeur de l'ID d'entité doit être transmise directement. Dans cet exemple, R070LKL3YKX est la valeur de clé primaire unique et elle est transmise directement.

Vous pouvez également effectuer des opérations de récupération sur les entités suivantes: appels, réponses aux messages, messages, réactions, informations sur l'équipe, rappels, utilisateurs et canaux.

Exemple : Supprimer des enregistrements de l'entité "Appels"

Cet exemple supprime les enregistrements de l'entité Calls.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Calls dans la liste Entity.
  3. Sélectionnez l'opération Delete, puis cliquez sur OK.
  4. Définissez l'ID de l'entité sur R074DSKVDSS, qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Task Input (Entrée de la tâche) de la tâche Connectors (Connecteurs), cliquez sur EntityId, puis saisissez R074DSKVDSS dans le champ Default Value (Valeur par défaut).

    Si l'entité possède deux clés primaires ou d'entreprise composites, vous pouvez définir filterClause sur Id='R074DSKVDSS'.

Vous pouvez également effectuer des opérations de suppression sur les entités suivantes: fichiers, réponses aux messages, messages, épingles, réactions et rappels.

Exemple : Créer des enregistrements de l'entité "Appels"

Cet exemple crée des enregistrements de l'entité Calls.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Calls dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
  "ExternalUniqueId": "c249a48c-a154-43d6-a286-791df11927a4",
  "JoinURL": "https://example55.com/call"
}

    Si l'intégration réussit, le paramètre de réponse connectorOutputPayload de la tâche Connector aura une valeur semblable à celle-ci:

     
{
  "Id": "R074LBCFBU3"
}

Exemple : Créer des enregistrements de l'entité Messages

Cet exemple crée des enregistrements de l'entité Messages.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Messages dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
  "ChannelId": "C06UF15CB0V",
  "Text": "This is google cloud created Message"
}

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

     
{
"Id": "1723008314.867479",
"ChannelId": "C06UF15CB0V"
}

Exemple : Créer un enregistrement de l'entité "Pins"

Cet exemple crée un enregistrement de l'entité Pins.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Pins dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
"ChannelId": "C06UF15CB0V",
"Id": "1723008314.867479",
"Type": "message"
}

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

     
{
"Id": "1723008314.867479",
"Type": "message",
"ChannelId": "C06UF15CB0V"
}

Exemple : Créer un enregistrement de l'entité "Réactions"

Cet exemple crée un enregistrement de l'entité Reactions.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Reactions dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
  "ChannelId": "C06UPA4KRD0",
  "Id": "1716375032.038669",
  "Type": "message",
  "Name": "raised_hands"
}

    Si l'intégration réussit, le paramètre de réponse connectorOutputPayload de la tâche Connector aura une valeur semblable à celle-ci:

     
{
  "Success": true
}

Exemple : Créer un enregistrement de l'entité "Rappels"

Cet exemple crée un enregistrement de l'entité Reminders.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Reminders dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
  "Text": "this is a reminder",
  "Time": "2025-10-15 14:30:00"
}

    Si l'intégration réussit, le paramètre de réponse connectorOutputPayload de la tâche Connector aura une valeur semblable à celle-ci:

     
{
  "Id": "Rm074P0X9JCV"
}

Exemple : Créer un enregistrement de l'entité "Chaînes"

Cet exemple crée un enregistrement de l'entité Channels.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Channels dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
"Name": "googlecloudcreatedchannel",
"IsPublic": true
}

    Si l'intégration réussit, le paramètre de réponse connectorOutputPayload de la tâche Connector aura une valeur semblable à celle-ci:

     
{
"Id": "C074MBW5N2G"
}

Exemple : Créer un enregistrement de l'entité MessageReplies

Cet exemple crée un enregistrement de l'entité MessageReplies.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez MessageReplies dans la liste Entity.
  3. Sélectionnez l'opération Create, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
"ChannelId": "C076HCY07UN",
"Text": "This is generated text",
"ParentMessageId": "1717659095.881619"
}

    Si l'intégration réussit, le paramètre de réponse connectorOutputPayload de la tâche Connector aura une valeur semblable à celle-ci:

     
{
"Id": "1717659183.033599",
"ChannelId": C076HCY07UN,
"ParentMessageId": "1717659095.881619"
}

Exemple : Mettre à jour un enregistrement de l'entité "Appels"

Cet exemple met à jour un enregistrement de l'entité Calls.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Calls dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
  "JoinURL": "https://example55.com/call/google-cloud",
  "Title": "title"
}
  5. Définissez l'ID d'entité sur R074LB76Q5R. Pour définir l'ID d'entité, cliquez sur entityId, puis saisissez R074LB76Q5R dans le champ Default Value (Valeur par défaut).

    Plutôt que de spécifier le entityId, vous pouvez également définir le filterClause sur R074LB76Q5R.

    Si l'intégration réussit, le paramètre de réponse connectorOutputPayload de la tâche Connector aura une valeur semblable à celle-ci:

    {
  "Id": "null"
}

Exemple : Mettre à jour un enregistrement de l'entité "Messages"

Cet exemple met à jour un enregistrement de l'entité Messages.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Messages dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
  "Text": "Google Cloud Updated Message"
}
  5. Définissez la clause de filtre sur ChannelId = "C06UPA4KRD0" et Id = "1716369465.000129". Pour définir la clause de filtre, cliquez sur filterClause, puis saisissez ChannelId = 'C06UPA4KRD0' and Id = '1716369465.000129' dans le champ Default Value (Valeur par défaut).

    Si l'intégration réussit, le paramètre de réponse connectorOutputPayload de la tâche Connector aura une valeur semblable à celle-ci:

    {
  "Id": null,
  "ChannelId": null
}

Exemple : Mettre à jour un enregistrement de l'entité "Utilisateurs"

Cet exemple met à jour un enregistrement de l'entité Users.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Users dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
  "ProfileDisplayName": "Vaibhav"
}
  5. Définissez l'ID d'entité sur U06Q6VDJYSU. Pour définir l'ID d'entité, cliquez sur entityId, puis saisissez U06Q6VDJYSU dans le champ Default Value (Valeur par défaut).

    Plutôt que de spécifier le entityId, vous pouvez également définir le filterClause sur U06Q6VDJYSU.

    Si l'intégration réussit, le paramètre de réponse connectorOutputPayload de la tâche Connector aura une valeur semblable à celle-ci:

    {
"Id": null
}

Exemple : Mettre à jour un enregistrement de l'entité "Chaînes"

Cet exemple met à jour un enregistrement de l'entité Channels.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez Channels dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
"Purpose": "This is the one channel that will always include everyone."
}
  5. Définissez l'ID d'entité sur C06MAP1JDSB. Pour définir l'ID d'entité, cliquez sur entityId, puis saisissez C06MAP1JDSB dans le champ Default Value (Valeur par défaut).

    Plutôt que de spécifier le entityId, vous pouvez également définir le filterClause sur C06MAP1JDSB.

    Si l'intégration réussit, le paramètre de réponse connectorOutputPayload de la tâche Connector aura une valeur semblable à celle-ci:

    {
"Id": "C06MAP1JDSB"
}

Exemple : Mettre à jour un enregistrement de l'entité MessageReplies

Cet exemple met à jour un enregistrement de l'entité MessageReplies.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez MessageReplies dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
    {
"Text": "Updated Text"
}
  5. Définissez la clause de filtre sur ChannelId = "C06UPA4KRD0" et Id = "1716369465.000129". Pour définir la clause de filtre, cliquez sur filterClause, puis saisissez ChannelId = 'C06UPA4KRD0' and Id = '1716369465.000129' dans le champ Default Value (Valeur par défaut).

    Si l'intégration réussit, le paramètre de réponse connectorOutputPayload de la tâche Connector aura une valeur semblable à celle-ci:

    {
"Id": null,
"ChannelId": null,
"ParentMessageId": null
}

Exemple : Mise à jour d'un enregistrement de l'entité UserProfile

Cet exemple met à jour un enregistrement de l'entité UserProfile.

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez UserProfile dans la liste Entity.
  3. Sélectionnez l'opération Update, puis cliquez sur OK.
  4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value: 
     {
  "CustomFields": "{\"Xf079082Q70B\": {\"value\": \"Patna Bihar\",\"alt\": \"\"}}",
  "Phone": "8767787654",
  "StatusText": "Long train Journey to work"
 }

    Si l'intégration réussit, le paramètre de réponse connectorOutputPayload de la tâche Connector aura une valeur semblable à celle-ci:

    {

}

Obtenir de l'aide auprès de la communauté Google Cloud

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

Étape suivante