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 les charger ou les synchroniser 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 en toute sécurité aux données que votre application est autorisée à récupérer.

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

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 à la valeur du jeton d'accès de votre application. Pour les derniers 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 roue dentée en haut à droite pour ouvrir Paramètres.
3. Dans le menu du côté gauche, sélectionnez Intégrations, puis Applications légacy.
4. Cliquez sur Créer.
5. Choisissez Privée.
6. Dans l'onglet Informations de base, saisissez le nom de votre application.
7. Survolez le logo d'espace réservé et cliquez sur Télécharger l'icône pour télécharger 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 auquel vous souhaitez que l'application ait accès.
    • Ces scopes déterminent quelles données HubSpot le pilote peut récupérer.
    • Référez-vous aux propriétés OAuthRequiredScopes et OAuthOptionalScopes pour des sélections recommandées.
11. Cliquez sur Mettre à jour lorsque vous avez terminé.
12. Cliquez sur Créer l'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 Autres propriétés de la connexion dans DataSync utilisées pour 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 roue dentée en haut à droite pour ouvrir Paramètres.
2. Dans le menu du côté gauche, sélectionnez Intégrations, puis Applications légacy.
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. À partir de l'écran d'accueil, sélectionnez Connexions.
3. À côté de Connexions source, cliquez sur Nouveau.
4. Sélectionnez HubSpot.
5. Dans le panneau Propriétés de la connexion, saisissez les propriétés de connexion.
6. (Optionnel) Dans le panneau Autres propriétés de la connexion, 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 Sauvegarder.

Paramètres

Propriétés de la connexion

Paramètre	Description
Description	Nom unique pour la connexion. Exemple : HubSpot
Délai	Temps en secondes à attendre pour l'ouverture de connexion et l'exécution de la requête avant le délai d'attente.
Verbosity	1 – Journaliser les requêtes, les comptes de lignes, le début/fin d'exécution, les erreurs. 2 – Inclut le niveau 1 plus les requêtes de cache, les en-têtes HTTP. 3 – Inclut le niveau 2 plus les corps des requêtes/réponses. 4 – Inclut le niveau 3 plus la communication de niveau transport. 5 – Inclut le niveau 4 plus toutes les commandes d'interface.
Activer la mise en Pool	Option de pooling de connexion pour de meilleures performances.
Délai d'inactivité du Pool	Temps d'inactivité maximum des connexions avant de les retourner au pool, en secondes.
Taille maximale du Pool	Nombre maximum de connexions autorisées dans le pool.
Temps d'attente du Pool	Temps d'attente maximum pour l'allocation de connexion avant qu'une erreur ne soit générée, en secondes.

Autres propriétés de la connexion

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 Crypé. La sélection Crypé cache la valeur de l'interface et la stocke de manière cryptée en arrière-plan, par exemple lors de la définition de mots de passe.

Propriété	Valeur
OAuthAccessToken	Jeton d'accès 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 des 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 raffiné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 lors de l'extraction. Ces options permettent un réglage précis 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 de suivi des changements : Aucun ou Date.
Région	Paramètre de région pour le connecteur, si nécessaire pour 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 synchronisation lors de la sélection d'enregistrements. La valeur minimale est 0 ; le maximum est de 3600 secondes.
Taille du lot	Quantité d'enregistrements traités dans chaque lot durant 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 selon la vitesse de votre réseau et les performances de votre disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.