Dropbox
Le connecteur Dropbox vous permet de vous connecter à une instance Dropbox et d'effectuer les opérations compatibles.
Avant de commencer
Avant d'utiliser le connecteur Dropbox, 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 de 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.
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 :
- 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.
- Cliquez sur + Créer pour ouvrir la page Créer une connexion.
- Dans la section Emplacement, choisissez l'emplacement de la connexion.
- 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.
- Cliquez sur SUIVANT.
- Région : sélectionnez un emplacement dans la liste déroulante.
- Dans la section Détails de la connexion, procédez comme suit :
- Connecteur: sélectionnez Dropbox dans la liste déroulante des connecteurs disponibles.
- Version du connecteur : sélectionnez la version du connecteur dans la liste déroulante des versions disponibles.
- 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 49 caractères.
- Saisissez éventuellement une Description pour l'instance de connexion.
- Compte de service : sélectionnez un compte de service disposant des rôles requis.
- 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.
- User Id to impersonate (ID utilisateur à usurper) : optionnellement, spécifiez l'ID utilisateur à usurper.
- Mode d'emprunt d'identité:spécifiez le type d'emprunt d'identité. Il doit s'agir du mode utilisateur ou du mode administrateur.
- Inclure les sous-répertoires:optionnellement, si vous souhaitez inclure des sous-répertoires lors de la liste des fichiers et des dossiers.
- Inclure les ressources de l'équipe:si vous souhaitez inclure les fichiers et les dossiers de l'équipe.
- Vous pouvez également cliquer sur + Ajouter un libellé pour ajouter un libellé à la connexion sous la forme d'une paire clé/valeur.
- Cliquez sur Suivant.
-
Dans la section Authentification, saisissez les informations d'authentification.
- Sélectionnez un type d'authentification, puis saisissez les informations appropriées.
Les types d'authentification suivants sont compatibles avec la connexion Dropbox:
- Octroi de code d'autorisation OAuth 2.0
- Cliquez sur Next (Suivant).
Pour comprendre comment configurer ces types d'authentification, consultez la section Configurer l'authentification.
- Sélectionnez un type d'authentification, puis saisissez les informations appropriées.
- Vérifiez vos informations de connexion et d'authentification.
- Cliquez sur Créer.
Configurer l'authentification
Saisissez les détails en fonction de l'authentification que vous souhaitez utiliser.
-
Octroi de code d'autorisation OAuth 2.0
- ID client : ID client utilisé pour demander des jetons d'accès.
- Champs d'application: liste des champs d'application souhaités, séparés par une virgule, provenant du portail d'autorisations Dropbox.
- Code secret du client : code secret du client utilisé pour demander des jetons d'accès.
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.
Limites du système
Le connecteur Dropbox peut traiter 18 transactions par seconde et par nœud, et limite les transactions au-delà de cette limite. Par défaut, les connecteurs d'intégration allouent deux nœuds (pour une meilleure disponibilité) à une connexion.
Pour en savoir plus sur les limites applicables à Integration Connectors, consultez la section Limites.
Actions
Cette section répertorie les actions compatibles avec le connecteur. Pour savoir comment configurer les actions, consultez Exemples d'actions.
Action CopyResource
Cette action vous permet de copier un fichier ou un dossier vers un autre emplacement dans l'espace de stockage Dropbox de l'utilisateur.
Paramètres d'entrée de l'action CopyResource
Nom du paramètre | Type de données | Requis | Description |
---|---|---|---|
From_Path | Chaîne | Oui | Chemin d'accès dans Dropbox de l'utilisateur à copier ou à déplacer. |
To_Path | Chaîne | Oui | Chemin de destination dans Dropbox de l'utilisateur pour la ressource copiée. |
Renommer automatiquement | Chaîne | Non | En cas de conflit, demandez au serveur Dropbox d'essayer de renommer automatiquement le fichier pour éviter le conflit. La valeur par défaut de ce champ est "False". |
Allow_Ownership_Transfer | Chaîne | Non | Autoriser les transferts par le propriétaire, même s'ils entraînent un transfert de propriété du contenu déplacé. Cela ne s'applique pas aux copies. La valeur par défaut de ce champ est "False". |
ObjectPathsAggregate | Chaîne | Non | Agrégation représentant le chemin de l'objet. Il peut également s'agir du nom d'une table #TEMP. |
Pour savoir comment configurer l'action CopyResource
, consultez la section Exemples d'actions.
Action "CreateFolder" (Créer un dossier)
Cette action vous permet de créer un dossier à un chemin d'accès donné.
Paramètres d'entrée de l'action CreateFolder
Nom du paramètre | Type de données | Requis | Description |
---|---|---|---|
Chemin d'accès | Chaîne | Oui | Chemin d'accès à créer dans Dropbox de l'utilisateur. |
Renommer automatiquement | Booléen | Non | En cas de conflit, demandez au serveur Dropbox d'essayer de renommer automatiquement le dossier pour éviter le conflit. La valeur par défaut est false. |
ForceAsync | Booléen | Non | Indique si la création doit être forcée de manière asynchrone. Disponible uniquement lorsque vous utilisez ObjectPathsAggregate. La valeur par défaut est false. |
ObjectPathsAggregate | Chaîne | Non | Agrégation JSON représentant les chemins. Il peut également s'agir du nom d'une table #TEMP. |
Pour savoir comment configurer l'action CreateFolder
, consultez la section Exemples d'actions.
Action DeleteResource
Cette action vous permet de supprimer le fichier ou le dossier à un chemin d'accès donné. Si le chemin d'accès est un dossier, tout son contenu sera également supprimé.
Paramètres d'entrée de l'action DeleteResource
Nom du paramètre | Type de données | Requis | Description |
---|---|---|---|
Chemin d'accès | Chaîne | Oui | Identifiant unique du fichier ou du dossier. |
ObjectPathsAggregate | Chaîne | Non | Agrégation représentant le chemin de l'objet. Il peut également s'agir du nom d'une table #TEMP. |
Pour savoir comment configurer l'action DeleteResource
, consultez la section Exemples d'actions.
Action MoveResource
Déplacer un fichier ou un dossier vers un autre emplacement dans Dropbox de l'utilisateur Si le chemin d'accès source est un dossier, l'ensemble de son contenu sera déplacé. Notez que nous ne prenons pas en charge le changement de casse pour le moment.
Paramètres d'entrée de l'action MoveResource
Nom du paramètre | Type de données | Requis | Description |
---|---|---|---|
From_Path | Chaîne | Oui | Chemin d'accès dans Dropbox de l'utilisateur à copier ou à déplacer. |
To_Path | Chaîne | Oui | Chemin d'accès à la destination dans Dropbox de l'utilisateur. |
Renommer automatiquement | Chaîne | Non | En cas de conflit, demandez au serveur Dropbox d'essayer de renommer automatiquement le fichier pour éviter le conflit. La valeur par défaut de ce champ est "False". |
Allow_Ownership_Transfer | Chaîne | Non | Autoriser les transferts par le propriétaire, même s'ils entraînent un transfert de propriété du contenu déplacé. Cela ne s'applique pas aux copies. La valeur par défaut de ce champ est "False". |
ObjectPathsAggregate | Chaîne | Non | Agrégation représentant le chemin de l'objet. Il peut également s'agir du nom d'une table #TEMP. |
Pour savoir comment configurer l'action MoveResource
, consultez la section Exemples d'actions.
Action RenameResource
Cette action vous permet de renommer une ressource en fournissant un chemin d'accès et un nouveau nom.
Paramètres d'entrée de l'action RenameResource
Nom du paramètre | Type de données | Requis | Description |
---|---|---|---|
Chemin d'accès | Chaîne | Oui | Chemin d'accès à la ressource à renommer. Exemple: /myFolder/sample.txt |
NewName | Chaîne | Oui | Nouveau nom de la ressource. Exemple: sampleDocument.txt |
Pour savoir comment configurer l'action RenameResource
, consultez la section Exemples d'actions.
Action "UnshareFolder"
Cette action vous permet de rendre un dossier non partagé. Nécessite le champ d'application sharing.write.
Paramètres d'entrée de l'action UnshareFolder
Nom du paramètre | Type de données | Requis | Description |
---|---|---|---|
FolderId | Chaîne | Oui | ID du dossier partagé à annuler. |
LeaveCopy | Chaîne | Non | Si la valeur est "true", les membres de ce dossier partagé recevront une copie de ce dossier une fois qu'il aura été rendu non partagé. La valeur par défaut est false. |
Pour savoir comment configurer l'action UnshareFolder
, consultez la section Exemples d'actions.
Action DownloadFile
Cette action vous permet de télécharger un fichier. Nécessite l'étendue files.content.read.
Paramètres d'entrée de l'action DownloadFile
Nom du paramètre | Type de données | Requis | Description |
---|---|---|---|
ID | Chaîne | Oui | ID du document à télécharger. |
Révision | Chaîne | Non | Révision du document à télécharger (par exemple, "rev:a1c10ce0dd78"). |
Chemin d'accès | Chaîne | Non | Chemin d'accès au fichier ou au dossier à télécharger. |
AsZip | Booléen | Non | Télécharger un dossier au format ZIP Doit être défini sur "true" pour télécharger un dossier. |
FileStream | Chaîne | Non | Instance d'un flux de sortie dans lequel les données de fichier sont écrites. Utilisé uniquement si DownloadTo n'est pas défini. |
DownloadTo | Chaîne | Non | Chemin d'accès au dossier dans lequel le fichier doit être téléchargé. |
FileType | Chaîne | Oui | Type de fichier(fichier ou papier) |
Pour savoir comment configurer l'action DownloadFile
, consultez la section Exemples d'actions.
Exemples d'actions
Cette section explique comment effectuer certaines actions dans ce connecteur.
Exemple : Copier une ressource
L'exemple suivant montre comment copier une ressource avec un chemin d'accès spécifié vers un autre chemin d'accès:
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
CopyResource
, puis cliquez sur OK. - 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 champDefault Value
:{ "From_Path": "/DropboxFolder/pptxFile.pptx", "To_Path": "/DropBoxFolder2/Folder/pptFile.pptx" }
Si l'action réussit, le paramètre de réponse connectorOutputPayload
de la tâche CopyResource
aura une valeur semblable à celle-ci:
[ { "Success": "true", "metadata_.tag": "file", "metadata_name": "pptxFile.pptx", "metadata_path_lower": "/testingdropboxupdated/abcde/pptxfile.pptx", "metadata_path_display": "/TestingDropBoxUpdated/abcde/pptxFile.pptx", "metadata_parent_shared_folder_id": "3204685267", "metadata_id": "id:8-07A6kHAoIAAAAAAAAC1w", "metadata_client_modified": "2024-06-13T11:06:37Z", "metadata_server_modified": "2024-07-12T10:19:02Z", "metadata_rev": "61d0a3560ecb5bf039dd3", "metadata_size": "17052", "metadata_sharing_info_read_only": "false", "metadata_sharing_info_parent_shared_folder_id": "3204685267", "metadata_sharing_info_modified_by": "dbid:AACVLctlrEo-ouTSxUVSTi0loZCSZKc933A", "metadata_is_downloadable": "true", "metadata_content_hash": "0234f7d4eaf914cb276716c8b2a24e24655d1f6f39ee549207e33a4255e2fba2" } ]
Exemple : Créer un dossier
L'exemple suivant montre comment créer un dossier à un chemin d'accès donné:
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
CreateFolder
, puis cliquez sur OK. - 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 champDefault Value
:{ "Path": "/TestDrobBoxFolder/newFolder" }
Si l'action réussit, le paramètre de réponse connectorOutputPayload
de la tâche CreateFolder
aura une valeur semblable à celle-ci:
[ { "Id": "id:8-07A6kHAoIAAAAAAAAC2Q" } ]
Exemple : Supprimer une ressource
L'exemple suivant montre comment supprimer une ressource:
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
DeleteResource
, puis cliquez sur OK. - 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 champDefault Value
:{ "Path": "/TestingDropBox/FolderToBeDeletedName" }
Si l'action réussit, le paramètre de réponse connectorOutputPayload
de la tâche DeleteResource
aura une valeur semblable à celle-ci:
[{ "Status": "Success" }]
Exemple : Déplacer une ressource
L'exemple suivant montre comment déplacer une ressource:
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
MoveResource
, puis cliquez sur OK. - 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 champDefault Value
:{ "From_Path": "/TestDropBoxFolder/Folder1/dummypdf2.pdf", "To_Path": "/EmptyFolder/Folder1/dummypdf2.pdf" }
Si l'action réussit, le paramètre de réponse connectorOutputPayload
de la tâche MoveResource
aura une valeur semblable à celle-ci:
[{ "Status": "Success" }]
Exemple : Renommer une ressource
L'exemple suivant montre comment renommer une ressource:
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
RenameResource
, puis cliquez sur OK. - 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 champDefault Value
:{ "Path": "/TestDropBox/abcd", "NewName": "abcded" }
Si l'action réussit, le paramètre de réponse connectorOutputPayload
de la tâche RenameResource
aura une valeur semblable à celle-ci:
[{ "Status": "Success" }]
Exemple : Annuler le partage d'un dossier
L'exemple suivant montre comment annuler le partage d'un dossier:
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
UnshareFolder
, puis cliquez sur OK. - 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 champDefault Value
:{ "FolderId": "3336772979" }
Si l'action réussit, le paramètre de réponse connectorOutputPayload
de la tâche UnshareFolder
aura une valeur semblable à celle-ci:
[{ "Status": "Success" }]
Exemple : Télécharger un fichier
L'exemple suivant montre comment télécharger un fichier:
- Dans la boîte de dialogue
Configure connector task
, cliquez surActions
. - Sélectionnez l'action
DownloadFile
, puis cliquez sur OK. - 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 champDefault Value
:{ "Id": "id:8-07A6kHAoIAAAAAAAABcg", "FileType": "file" }
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", "Name": "license.txt", "Id": "id:8-07A6kHAoIAAAAAAAABcg", "ClientModified": "2024-07-09T09:52:41Z", "ServerModified": "2024-07-09T09:52:41Z", "Revision": "61ccd7da2b987c0f52053", "Size": "11", "LowerCasePath": "/sahil kapoor/testingdropboxupdated/uploadfolderwithnestedfolder/nestedfolder2/license.txt", "DisplayPath": "/Sahil Kapoor/TestingDropBoxUpdated/uploadFolderWithNestedFolder/NestedFolder2/license.txt", "PreviewURL": null, "IsDownloadable": "true", "HasExplicitSharedMembers": null, "ContentHash": "f6dc724d119649460e47ce719139e521e082be8a9755c5bece181de046ee65fe", "Owner": null, "Title": null, "MimeType": null, "FileData": "SGVsbG8gd29ybGQ=", "parent_shared_folder_id": "3237290067", "sharing_info_read_only": "false", "sharing_info_parent_shared_folder_id": "3237290067", "sharing_info_modified_by": "dbid:AACVLctlrEo-ouTSxUVSTi0loZCSZKc933A" } ]
Utiliser la connexion Dropbox 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.
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
- Découvrez comment suspendre et réactiver une connexion.
- Découvrez comment surveiller l'utilisation des connecteurs.
- Découvrez comment afficher les journaux de connecteur.