Connecteur Source HubSpot

Le connecteur source HubSpot dans DataSync vous permet de récupérer des données depuis HubSpot en utilisant l'API HubSpot pour le chargement ou la synchronisation dans votre entrepôt de données. Vous pouvez vous authentifier en utilisant un jeton d'accès d'application privée HubSpot pour accéder de manière sécurisée aux données que votre application est autorisée à récupérer.

Après avoir créé toutes les connexions source requises, configurez votre connexion de destination pour compléter la configuration de la connexion.

Créer une application privée dans HubSpot

Pour se connecter en utilisant un jeton d'accès d'application privée HubSpot, définissez la propriété AuthScheme sur PrivateAppToken et OAuthAccessToken sur la valeur du jeton d'accès de votre application. Pour plus de détails, consultez la documentation des applications privées HubSpot.

Créer une application privée

1. Connectez-vous à HubSpot.
2. Cliquez sur l'icône de l'engrenage dans le coin supérieur droit pour ouvrir Paramètres.
3. Dans le menu de la barre latérale gauche, sélectionnez Intégrations, puis Applications héritées.
4. Cliquez sur Créer.
5. Choisissez Privé.
6. Dans l'onglet Informations de base, entrez le nom de votre application.
7. Survolez le logo d'espace réservé et cliquez sur Télécharger l'icône pour uploader une image carrée comme logo.
8. Entrez une description pour votre application.
9. Sélectionnez l'onglet Scopes et cliquez sur + Ajouter un nouveau scope.
10. Sélectionnez Lecture ou Écriture pour chaque scope que vous souhaitez que l'application accède.
    • Ces scopes déterminent quelles données HubSpot le driver peut récupérer.
    • Référez-vous aux propriétés OAuthRequiredScopes et OAuthOptionalScopes pour les sélections recommandées.
11. Cliquez sur Mettre à jour lorsque vous avez terminé.
12. Cliquez sur Créer une application.
13. Passez en revue les informations concernant le jeton d'accès de votre application.
14. Cliquez sur Continuer la création.
15. Cliquez sur Afficher le jeton pour révéler votre jeton d'accès.
16. Cliquez sur Copier pour copier le jeton dans votre presse-papiers.
    
    Vous pouvez maintenant définir le jeton copié dans les Propriétés de connexion supplémentaires dans DataSync utilisées pour à la fois OAuthAccessToken et AuthScheme.

Voir le jeton d'accès de votre application

Si vous devez voir ou copier à nouveau le jeton d'accès de votre application :

1. Cliquez sur l'icône de l'engrenage dans le coin supérieur droit pour ouvrir Paramètres.
2. Dans le menu de la barre latérale gauche, sélectionnez Intégrations, puis Applications héritées.
3. Sélectionnez l'application privée que vous avez créée.
4. Cliquez sur l'onglet Auth.
5. Cliquez sur Afficher le jeton pour révéler le jeton d'accès.
6. Cliquez sur Copier pour copier le jeton dans votre presse-papiers.

Créer une connexion source dans DataSync

1. Connectez-vous à DataSync.
2. Depuis l'écran d'accueil, sélectionnez Connections.
3. À côté de Connexions Source, cliquez sur Nouveau.
4. Sélectionnez HubSpot.
5. Dans le panneau Propriétés de connexion, entrez les propriétés de connexion.
6. (Optionnel) Dans le panneau Propriétés de connexion supplémentaires, sélectionnez Ajouter une propriété et entrez les paramètres pour chaque propriété.
7. Dans le panneau Paramètres avancés, configurez les paramètres, y compris le Type de suivi et d'autres valeurs selon vos besoins.
8. Cliquez sur Enregistrer.

Paramètres

Propriétés de connexion

Paramètre	Description
Description	Nom unique pour la connexion. Exemple : HubSpot
Timeout	Temps en secondes à attendre pour l'ouverture de la connexion et l'exécution de la requête avant que le délai d'attente ne soit atteint.
Verbosity	1 – Journaliser les requêtes, comptages de lignes, début/fin d'exécution, erreurs. 2 – Inclut le niveau 1 plus les requêtes en cache, les en-têtes HTTP. 3 – Inclut le niveau 2 plus les corps de requête/réponse. 4 – Inclut le niveau 3 plus la communication au niveau du transport. 5 – Inclut le niveau 4 plus toutes les commandes d'interface.
Enable Pooling	Option de mise en pool de connexion pour la performance.
Pool idle timeout	Temps maximum d'inactivité pour les connexions avant de les renvoyer au pool, en secondes.
Max Pool Size	Nombre maximum de connexions autorisées dans le pool.
Pool wait time	Temps d'attente maximum pour l'allocation de connexion avant qu'une erreur ne soit lancée, en secondes.

Propriétés de connexion supplémentaires

Propriétés de chaîne de connexion supplémentaires non spécifiées dans le panneau Propriétés de connexion. Pour chaque propriété ajoutée, vous pouvez choisir Visible ou Encrypté. La sélection de Encrypté cache la valeur de l'interface et la stocke cryptée dans le back-end, comme lors de la définition de mots de passe.

Propriété	Valeur
OAuthAccessToken	Jeton d'accès de l'application pour votre application privée HubSpot. Voir Voir le jeton d'accès de votre application. Exemple : pat-na1-12345678-abcdefgh-ijklmno
OAuthOptionalScopes	Liste de scopes définissant les autorisations API disponibles pour votre application : "automation,business-intelligence,crm.lists.read,crm.lists.write,crm.objects.companies.write,crm.objects.contacts.read,crm.objects.contacts.write,crm.objects.deals.read,crm.objects.deals.write,crm.objects.owners.read,crm.schemas.companies.read,crm.schemas.companies.write,crm.schemas.contacts.read,crm.schemas.contacts.write,crm.schemas.deals.read,crm.schemas.deals.write,content,conversations.visitor_identification.tokens.create,crm.import,cms.source_code.read_write,e-commerce,files,forms,forms-uploaded-files,hubdb,integration-sync,oauth,sales-email-read,social,tickets,timeline,transactional-email" Les scopes peuvent être affinés en fonction de la documentation OAuth de HubSpot.
AuthScheme	Schéma d'authentification pour la connexion. Voir Voir le jeton d'accès de votre application.

Paramètres avancés

Les paramètres avancés contrôlent comment le connecteur HubSpot suit les changements, gère la configuration régionale et temporelle, et traite les lots de données pendant l'extraction. Ces options permettent un ajustement fin pour la performance et l'exactitude, et doivent être configurées en fonction de votre environnement système et de vos exigences opérationnelles.

Paramètre	Description
Type de suivi	Méthode pour suivre les changements : Aucun ou Date.
Région	Paramètre de région pour le connecteur, si requis par votre configuration.
Fuseau horaire	Fuseau horaire correspondant au serveur d'application HubSpot.
Décalage horaire	Décalage de rafraîchissement en secondes pour compenser les problèmes de timing lors de la sélection des enregistrements. La valeur minimale est 0; la valeur maximale est 3600 secondes.
Taille de lot	Quantité d'enregistrements traités dans chaque lot pendant l'extraction. Des tailles de lot plus grandes augmentent l'utilisation de la mémoire, mais peuvent améliorer la performance jusqu'à un certain point. La valeur par défaut est 2000 et le maximum ne doit pas dépasser 10000 enregistrements. Ajustez en fonction de la vitesse de votre réseau et des performances de disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.

Exemple