Partager via


HubSpot Files V2 (éditeur indépendant) (préversion)

Avec le CRM HubSpot facile à utiliser, vous n’aurez jamais à mettre à jour manuellement les rapports ou à vous demander comment votre équipe effectue le suivi des quotas. Obtenez une vue en temps réel de l’ensemble de votre pipeline de ventes sur un tableau de bord visuel. HubSpot CRM organise, enrichit et effectue automatiquement le suivi de chaque contact dans une chronologie ténue.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Troy Taylor
URL https://www.hitachisolutions.com
Messagerie électronique ttaylor@hitachisolutions.com
Métadonnées du connecteur
Éditeur Troy Taylor
Site internet https://www.hubspot.com/
Politique de confidentialité https://legal.hubspot.com/privacy-policy
Catégories Contenu et fichiers ; Ventes et CRM

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Descriptif Obligatoire
Jeton d’accès (sous la forme « Porteur YOUR_TOKEN ») securestring Jeton d’accès (sous la forme « Porteur YOUR_TOKEN ») pour cette API Vrai

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Charger le fichier

Chargez un fichier unique avec du contenu spécifié dans le corps de la demande.

Créer un dossier

Crée un dossier.

Dossiers de recherche

Recherchez des dossiers. Ne contient pas de dossiers masqués ou archivés.

Générer un lien

Génère une URL signée qui autorise l’accès temporaire à un fichier privé.

Importer un fichier de manière asynchrone

Importe de façon asynchrone le fichier à l’URL donnée dans le gestionnaire de fichiers.

Mettre à jour les propriétés du dossier

Mettez à jour les propriétés du dossier par ID donné. Cette action se produit de manière asynchrone et met également à jour tous les enfants du dossier.

Mettre à jour les propriétés du fichier

Mettez à jour les propriétés du fichier par ID.

Mettre à jour un fichier

Remplace les données de fichier existantes par les nouvelles données de fichier. Peut être utilisé pour modifier le contenu de l’image sans avoir à charger un nouveau fichier et à mettre à jour toutes les références.

Obtenir le dossier

Obtenir le dossier par ID.

Obtenir un fichier

Récupérez un fichier par ID.

Obtenir un fichier par chemin d’accès

Récupérez le fichier par l’adresse du chemin d’accès.

Rechercher des fichiers

Recherchez des fichiers dans le gestionnaire de fichiers. N’affiche pas les fichiers masqués ou archivés.

Supprimer le dossier

Supprimez le dossier par ID.

Supprimer le fichier pour GDRP

Supprime un fichier pour GDRP.

Supprimer un fichier

Supprimez le fichier par ID.

Vérifier l'état de l'importation

Vérifiez l’état de l’importation demandée.

Vérifier la mise à jour du dossier

Vérifiez l’état de la mise à jour des dossiers. Les mises à jour des dossiers se produisent de façon asynchrone.

Charger le fichier

Chargez un fichier unique avec du contenu spécifié dans le corps de la demande.

Paramètres

Nom Clé Obligatoire Type Description
Fichier
file True file

Fichier à charger.

ID du dossier
folderId string

'folderId' ou 'folderPath' est requis. folderId est l’ID du dossier vers lequel le fichier sera chargé.

Chemin d’accès au dossier
folderPath string

'folderPath' ou 'folderId' est requis. Ce champ représente le chemin du dossier de destination du fichier chargé. S’il n’existe pas de chemin d’accès, le système essaie de en créer un.

Nom du fichier
fileName True string

Nom souhaité pour le fichier chargé.

Jeu de caractères
charsetHunch string

Jeu de caractères du fichier chargé.

Options d’accès
options.access True string

Niveau d’accès pour le fichier chargé.

Options de durée de vie
options.ttl integer

Durée de vie du fichier chargé.

Retours

Lime.

Fichier
File

Créer un dossier

Crée un dossier.

Paramètres

Nom Clé Obligatoire Type Description
ID de répertoire parent
parentFolderId string

FolderId du parent du dossier créé. S’il n’est pas spécifié, le dossier est créé au niveau racine. parentFolderId et parentFolderPath ne peuvent pas être définis en même temps.

Chemin d’accès parent
parentPath string

Chemin d’accès du parent du dossier créé. S’il n’est pas spécifié, le dossier est créé au niveau racine. parentFolderPath et parentFolderId ne peuvent pas être définis en même temps.

Nom
name True string

Nom souhaité pour le dossier.

Retours

Dossier
Folder

Dossiers de recherche

Recherchez des dossiers. Ne contient pas de dossiers masqués ou archivés.

Paramètres

Nom Clé Obligatoire Type Description
Propriétés
properties array

Propriétés qui doivent être incluses dans les dossiers retournés.

Après
after string

Le décalage maximal des éléments pour une recherche donnée est de 1 0000. Réduisez votre recherche si vous atteignez cette limite.

Avant
before string

Avant.

Limit
limit integer

Limite des résultats à retourner. La limite maximale est de 100.

Trier
sort array

Triez les résultats par propriété donnée. Par exemple, -name trie par champ nom décroissant, le nom trie par champ de nom croissant.

ID
id string

Dossier de recherche par ID donné.

Créé à
createdAt string

Recherchez des dossiers avec l’horodatage de création donné.

Créé à l’adresse LTE
createdAtLte string

Créé à la fois inférieur ou égal.

Créé à l’adresse GTE
createdAtGte string

Créé au niveau supérieur ou égal.

Mise à jour à
updatedAt string

Recherchez le dossier au moment de l’horodatage de mise à jour donné.

Mise à jour à l’adresse LTE
updatedAtLte string

Mise à jour ultérieure ou égale.

Mise à jour à l’adresse GTE
updatedAtGte string

Mise à jour au niveau supérieur ou égal.

Nom
name string

Recherchez les dossiers contenant le nom spécifié.

Chemin
path string

Recherchez les dossiers par chemin d’accès.

ID de répertoire parent
parentFolderId integer

Recherchez des dossiers avec l’ID de dossier parent donné.

Retours

CollectionResponseFolder
CollectionResponseFolder

Générer un lien

Génère une URL signée qui autorise l’accès temporaire à un fichier privé.

Paramètres

Nom Clé Obligatoire Type Description
ID de fichier
fileId True string

ID du fichier.

Taille
size string

Pour les fichiers image. Cette opération redimensionne l’image à la taille souhaitée avant le partage. N’affecte pas le fichier d’origine, uniquement le fichier servi par cette URL signée.

Expiration
expirationSeconds integer

Durée en secondes pendant laquelle le lien fournira l’accès au fichier.

Classieuse
upscale boolean

Si la taille est fournie, cette opération met à l’échelle l’image pour qu’elle corresponde aux dimensions de taille.

Retours

Objet URL signé avec des métadonnées auxiliaires facultatives du fichier demandé.

SignedUrl
SignedUrl

Importer un fichier de manière asynchrone

Importe de façon asynchrone le fichier à l’URL donnée dans le gestionnaire de fichiers.

Paramètres

Nom Clé Obligatoire Type Description
Chemin d’accès au dossier
folderPath string

L’un des folderPath ou folderId est requis. Chemin du dossier de destination du fichier chargé. Si le chemin d’accès au dossier n’existe pas, il y aura une tentative de création du chemin d’accès au dossier.

Access1
access True string

PUBLIC_INDEXABLE : Le fichier est accessible publiquement par toute personne disposant de l’URL. Les moteurs de recherche peuvent indexer le fichier. PUBLIC_NOT_INDEXABLE : le fichier est accessible publiquement par toute personne disposant de l’URL. Les moteurs de recherche ne peuvent pas indexer le fichier. PRIVATE : Le fichier n’est pas accessible publiquement. Nécessite une URL signée pour afficher le contenu. Les moteurs de recherche ne peuvent pas indexer le fichier.

DuplicateValidationScope
duplicateValidationScope string

ENTIRE_PORTAL : recherchez un fichier en double dans l’ensemble du compte. EXACT_FOLDER : recherchez un fichier en double dans le dossier fourni.

Nom
name string

Nom pour donner le fichier résultant dans le gestionnaire de fichiers.

DuplicateValidationStrategy
duplicateValidationStrategy string

NONE : n’exécutez aucune validation en double. REJECT : rejeter le chargement si un doublon est trouvé. RETURN_EXISTING : si un fichier en double est trouvé, ne chargez pas un nouveau fichier et retournez le doublon trouvé à la place.

TTL
ttl string

Temps de vie. Si le fichier est spécifié, il sera supprimé après la période donnée. S’il n’est pas défini, le fichier existe indéfiniment.

Écraser
overwrite boolean

Si la valeur est true, remplace le fichier existant s’il en existe un portant le même nom et l’extension dans le dossier donné. Le fichier remplacé sera supprimé et le fichier chargé aura lieu avec un nouvel ID. Si la valeur est non définie ou définie comme false, le nom du nouveau fichier est mis à jour pour empêcher la collision avec le fichier existant s’il en existe un avec le même chemin, le même nom et l’extension.

URL
url True string

URL à partir de laquelle télécharger le nouveau fichier.

ID du dossier
folderId string

L’un des folderId ou folderPath est requis. FolderId de destination pour le fichier chargé.

Retours

Informations sur la tâche qui a été démarrée et où vérifier son état.

ImportFromUrlTaskLocator
ImportFromUrlTaskLocator

Mettre à jour les propriétés du dossier

Mettez à jour les propriétés du dossier par ID donné. Cette action se produit de manière asynchrone et met également à jour tous les enfants du dossier.

Paramètres

Nom Clé Obligatoire Type Description
ID de répertoire parent
parentFolderId integer

Nouvel id de dossier parent. En cas de modification, le dossier et tous les enfants sont déplacés dans le dossier spécifié. parentFolderId et parentFolderPath ne peuvent pas être spécifiés en même temps.

Nom
name string

Nouveau nom. Si le nom du dossier et fullPath spécifiés changeront. Tous les enfants du dossier seront mis à jour en conséquence.

ID
id True string

ID du dossier à modifier.

Retours

Informations sur la tâche qui a été démarrée et où vérifier son état.

FolderUpdateTaskLocator
FolderUpdateTaskLocator

Mettre à jour les propriétés du fichier

Mettez à jour les propriétés du fichier par ID.

Paramètres

Nom Clé Obligatoire Type Description
ID de fichier
fileId True string

ID du fichier à mettre à jour.

Access2
access string

NONE : n’exécutez aucune validation en double. REJECT : rejeter le chargement si un doublon est trouvé. RETURN_EXISTING : si un fichier en double est trouvé, ne chargez pas un nouveau fichier et retournez le doublon trouvé à la place.

ID de répertoire parent
parentFolderId string

FolderId vers lequel le fichier doit être déplacé. Les paramètres folderId et folderPath ne peuvent pas être définis en même temps.

Nom
name string

Nouveau nom pour le fichier.

Chemin du dossier parent
parentFolderPath string

Chemin d’accès au dossier vers lequel le fichier doit être déplacé. Les paramètres folderId et folderPath ne peuvent pas être définis en même temps.

Est utilisable dans le contexte
isUsableInContent boolean

Indiquez si le fichier doit être utilisé dans le nouveau contenu ou non.

Expire à
expiresAt integer

À l’expiration.

Retours

Lime.

Fichier
File

Mettre à jour un fichier

Remplace les données de fichier existantes par les nouvelles données de fichier. Peut être utilisé pour modifier le contenu de l’image sans avoir à charger un nouveau fichier et à mettre à jour toutes les références.

Paramètres

Nom Clé Obligatoire Type Description
ID de fichier
fileId True string

ID du fichier souhaité.

Fichier
file file

Données de fichier qui remplacent le fichier existant dans le gestionnaire de fichiers.

Jeu de caractères
charsetHunch string

Jeu de caractères de données de fichier donnée.

Options
options string

Chaîne JSON représentant FileReplaceOptions.

Retours

Lime.

Fichier
File

Obtenir le dossier

Obtenir le dossier par ID.

Paramètres

Nom Clé Obligatoire Type Description
ID du dossier
folderId True string

ID du dossier souhaité.

Propriétés
properties array

Propriétés à définir sur le dossier retourné.

Retours

Dossier
Folder

Obtenir un fichier

Récupérez un fichier par ID.

Paramètres

Nom Clé Obligatoire Type Description
ID de fichier
fileId True string

ID du fichier souhaité.

Propriétés
properties string

Propriétés.

Retours

Lime.

Fichier
File

Obtenir un fichier par chemin d’accès

Récupérez le fichier par l’adresse du chemin d’accès.

Paramètres

Nom Clé Obligatoire Type Description
Chemin
path True string

Chemin d’accès.

Propriétés
properties array

Propriétés.

Retours

FileStat
FileStat

Rechercher des fichiers

Recherchez des fichiers dans le gestionnaire de fichiers. N’affiche pas les fichiers masqués ou archivés.

Paramètres

Nom Clé Obligatoire Type Description
Propriétés
properties array

Propriétés de fichier souhaitées dans l’objet de retour.

Après
after string

Le décalage maximal des éléments pour une recherche donnée est de 1 0000. Réduisez votre recherche si vous atteignez cette limite.

Avant
before string

Avant.

Limit
limit integer

Nombre d’éléments à retourner. La limite maximale est de 100.

Trier
sort array

Triez les fichiers par un champ donné.

ID
id string

Recherchez des fichiers par ID donné.

Créé à
createdAt string

Recherchez des fichiers au moment de la création.

Créé à l’adresse LTE
createdAtLte string

Créé à la fois inférieur ou égal.

Créé à l’adresse GTE
createdAtGte string

Créé au niveau supérieur ou égal.

Mise à jour à
updatedAt string

Recherchez des fichiers par heure de la dernière mise à jour.

Mise à jour à l’adresse LTE
updatedAtLte string

Mise à jour ultérieure ou égale.

Mise à jour à l’adresse GTE
updatedAtGte string

Mise à jour au niveau supérieur ou égal.

Nom
name string

Recherchez des fichiers contenant le nom donné.

Chemin
path string

Rechercher des fichiers par chemin d’accès.

ID de répertoire parent
parentFolderId integer

Rechercher des fichiers dans un folderId donné.

Taille
size integer

Interroger par taille de fichier.

Hauteur
height integer

Recherchez des fichiers par hauteur d’image ou de vidéo.

Largeur
width integer

Recherchez des fichiers en largeur d’image ou de vidéo.

Codage
encoding string

Rechercher des fichiers avec encodage spécifié.

Type
type string

Filtrez par type de fichier fourni.

Extension
extension string

Recherchez des fichiers par extension donnée.

URL
url string

Recherchez une URL donnée.

Est utilisable dans le contenu
isUsableInContent boolean

Si la valeur true indique les fichiers qui ont été marqués pour être utilisés dans le nouveau contenu. La valeur false indique les fichiers qui ne doivent pas être utilisés dans le nouveau contenu.

Autoriser l’accès anonyme
allowsAnonymousAccess boolean

Si la valeur est true, les fichiers privés sont affichés ; si « false » affiche les fichiers publics.

Retours

Collections de fichiers.

CollectionResponseFile
CollectionResponseFile

Supprimer le dossier

Supprimez le dossier par ID.

Paramètres

Nom Clé Obligatoire Type Description
ID du dossier
folderId True string

ID du dossier à supprimer.

Supprimer le fichier pour GDRP

Supprime un fichier pour GDRP.

Paramètres

Nom Clé Obligatoire Type Description
ID de fichier
fileId True string

ID du fichier à supprimer du RGPD.

Supprimer un fichier

Supprimez le fichier par ID.

Paramètres

Nom Clé Obligatoire Type Description
ID de fichier
fileId True string

FileId à supprimer.

Vérifier l'état de l'importation

Vérifiez l’état de l’importation demandée.

Paramètres

Nom Clé Obligatoire Type Description
ID de tâche
taskId True string

Importez par ID de tâche d’URL.

Retours

FileActionResponse
FileActionResponse

Vérifier la mise à jour du dossier

Vérifiez l’état de la mise à jour des dossiers. Les mises à jour des dossiers se produisent de façon asynchrone.

Paramètres

Nom Clé Obligatoire Type Description
ID de tâche
taskId True string

TaskId de la mise à jour du dossier.

Retours

FolderActionResponse
FolderActionResponse

Définitions

StandardError

Nom Chemin d’accès Type Description
Sous-catégorie
subCategory object

Sous-catégorie.

Contexte
context object

Contexte.

Links
links object

Liens.

ID
id string

Identificateur.

Catégorie
category string

Catégorie.

Message
message string

Message.

Errors
errors array of ErrorDetail

Erreurs.

Statut
status string

État.

FolderActionResponse

Nom Chemin d’accès Type Description
Dossier
result Folder
Terminé à
completedAt string

Une fois les modifications demandées terminées.

Nombre d’erreurs
numErrors integer

Nombre d’erreurs résultant des modifications demandées.

Demandé à
requestedAt string

Horodatage représentant le moment où la tâche a été demandée.

Démarré à
startedAt string

Horodatage représentant le démarrage de la tâche.

Links
links object

Lien pour vérifier l’état de la tâche.

Errors
errors array of StandardError

Erreurs détaillées résultant de la tâche.

ID de tâche
taskId string

ID de la tâche.

Statut
status Status

État actuel de la tâche.

Paging

Nom Chemin d’accès Type Description
NextPage
next NextPage
PreviousPage
prev PreviousPage

Dossier

Nom Chemin d’accès Type Description
Créé à
createdAt string

Horodatage de la création de dossiers.

Archiver At
archivedAt string

Horodatage de la suppression de dossiers.

Archivés
archived boolean

Indique si le dossier est supprimé ou non.

Chemin
path string

Chemin d’accès du dossier dans le gestionnaire de fichiers.

ID de répertoire parent
parentFolderId string

ID du dossier parent.

Nom
name string

Nom du dossier.

ID
id string

ID du dossier.

Mise à jour à
updatedAt string

Horodatage de la dernière mise à jour vers le dossier.

CollectionResponseFile

Collections de fichiers.

Nom Chemin d’accès Type Description
Paging
paging Paging
results
results array of File

Détail de l'erreur

Nom Chemin d’accès Type Description
Sous-catégorie
subCategory string

Catégorie spécifique qui contient des détails plus spécifiques sur l’erreur.

Code
code string

Code d’état associé au détail de l’erreur.

Descriptif
in string

Nom du champ ou du paramètre dans lequel l’erreur a été trouvée.

Contexte
context object

Contexte relatif à la condition d’erreur.

Message
message string

Message lisible par l’homme décrivant l’erreur, ainsi que les étapes de correction le cas échéant.

FileActionResponse

Nom Chemin d’accès Type Description
Fichier
result File

Lime.

Terminé à
completedAt string

Heure d’achèvement de la tâche.

Nombre d’erreurs
numErrors integer

Nombre d’erreurs résultant de la tâche.

Demandé à
requestedAt string

Horodatage de l’heure de demande de la tâche.

Démarré à
startedAt string

Horodatage de l’heure de démarrage de la tâche.

Links
links object

Lien pour vérifier l’état de la tâche demandée.

Errors
errors array of StandardError

Messages d’erreur descriptifs.

ID de tâche
taskId string

ID de la tâche demandée.

Statut
status Status

État actuel de la tâche.

CollectionResponseFolder

Nom Chemin d’accès Type Description
Paging
paging Paging
results
results array of Folder

FileStat

Nom Chemin d’accès Type Description
Fichier
file File

Lime.

Dossier
folder Folder

SignedUrl

Objet URL signé avec des métadonnées auxiliaires facultatives du fichier demandé.

Nom Chemin d’accès Type Description
Extension
extension string

Extension du fichier demandé.

Taille
size integer

Taille en octets du fichier demandé.

Nom
name string

Nom du fichier demandé.

Largeur
width integer

Pour les fichiers image et vidéo. Largeur du fichier.

Type
type string

Type de fichier. Peut être IMG, DOCUMENT, AUDIO, MOVIE ou OTHER.

Expire à
expiresAt string

Horodatage du moment où l’URL n’accorde plus l’accès au fichier.

URL
url string

URL signée avec accès au fichier spécifié. Toute personne disposant de cette URL pourra accéder au fichier jusqu’à son expiration.

Hauteur
height integer

Pour les fichiers image et vidéo. Hauteur du fichier.

PreviousPage

Nom Chemin d’accès Type Description
Avant
before string

Avant.

Lien
link string

Lien.

ImportFromUrlTaskLocator

Informations sur la tâche qui a été démarrée et où vérifier son état.

Nom Chemin d’accès Type Description
Links
links object

Liens permettant de vérifier les informations relatives à la tâche. Le status lien indique l’URL pour laquelle vérifier l’état de la tâche.

ID
id string

ID de la tâche.

Fichier

Lime.

Nom Chemin d’accès Type Description
Extension
extension string

Extension du fichier. ex : .jpg, .png, .gif, .pdf, etc.

Accès
access Access

Accès aux fichiers. Peut être PUBLIC_INDEXABLE, PUBLIC_NOT_INDEXABLE, PRIVATE.

ID de répertoire parent
parentFolderId string

ID du dossier dans lequel se trouve le fichier.

Codage
encoding string

Encodage du fichier.

Type
type string

Type de fichier. Peut être IMG, DOCUMENT, AUDIO, MOVIE ou OTHER.

Est utilisable dans le contexte
isUsableInContent boolean

Précédemment « archivé ». Indique si le fichier doit être utilisé lors de la création de contenu tel que des pages web.

URL
url string

URL du fichier donné. Cette URL peut changer en fonction des paramètres de domaine du compte. Utilise le domaine d’hébergement de fichiers sélectionné.

Expire à
expiresAt integer

À l’expiration.

Créé à
createdAt string

Heure de création de l’objet de fichier.

Archiver At
archivedAt string

Heure de suppression de l’objet de fichier.

Archivés
archived boolean

Si le fichier est supprimé.

Chemin
path string

Chemin d’accès du fichier dans le gestionnaire de fichiers.

Taille
size integer

Taille du fichier en octets.

Nom
name string

Nom du fichier.

Largeur
width integer

Pour les fichiers image et vidéo, largeur du contenu.

ID
id string

ID de fichier.

URL d’hébergement par défaut
defaultHostingUrl string

URL d’hébergement par défaut du fichier. Cela utilisera l’une des URL fournies par HubSpot pour servir le fichier.

Mise à jour à
updatedAt string

Horodatage de la dernière mise à jour du fichier.

Hauteur
height integer

Pour les fichiers image et vidéo, la hauteur du contenu.

NextPage

Nom Chemin d’accès Type Description
Lien
link string

Lien.

Après
after string

Après.

FolderUpdateTaskLocator

Informations sur la tâche qui a été démarrée et où vérifier son état.

Nom Chemin d’accès Type Description
Links
links object

Liens permettant de vérifier les informations relatives à la tâche. Le status lien indique l’URL pour laquelle vérifier l’état de la tâche.

ID
id string

ID de la tâche.

Accès

Accès aux fichiers. Peut être PUBLIC_INDEXABLE, PUBLIC_NOT_INDEXABLE, PRIVATE.

Accès aux fichiers. Peut être PUBLIC_INDEXABLE, PUBLIC_NOT_INDEXABLE, PRIVATE.

Accès
string

Statut

État actuel de la tâche.

État actuel de la tâche.

Statut
string