Box (original) (raw)

Passer au contenu principal

Le connecteur Box vous permet de vous connecter à un backend Box et d'utiliser SQL pour récupérer et mettre à jour des données Box.

Versions compatibles

Ce connecteur est compatible avec la version 2.0 de l'API Box Content.

Avant de commencer

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

Configurer le connecteur

Une connexion est propre à 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 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 Emplacements.
    2. Cliquez sur SUIVANT.
  4. Dans la section Détails de connexion, procédez comme suit :
    1. Connecteur : sélectionnez Box 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, indiquez le nom de l'instance de connexion.
      Les noms de connexion doivent répondre aux critères suivants :
      • Ils peuvent contenir des lettres, des chiffres ou des traits d'union.
      • Les lettres doivent être en minuscules.
      • Ils doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
      • Ils ne peuvent pas dépasser 49 caractères.
    4. (Facultatif) Saisissez une description de l'instance de connexion.
    5. (Facultatif) Activez Cloud Logging, puis sélectionnez 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. (Facultatif) Configurez les paramètres des nœuds 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 davantage de transactions pour une connexion, vous devez disposer de plus de nœuds. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez 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 améliorer la disponibilité) et le nombre maximal de nœuds sur 50.
    8. Mode d'emprunt d'identité : spécifiez le type d'emprunt d'identité. Il doit s'agir du mode utilisateur ou du mode administrateur.
    9. (Facultatif) Dans la section Paramètres avancés, cochez la case Utiliser un proxy pour configurer un serveur proxy pour la connexion et configurez les valeurs suivantes :
      • Schéma d'authentification du proxy : sélectionnez le type d'authentification pour l'authentification auprès du serveur proxy. Les types d'authentification suivants sont compatibles :
        * De base : authentification HTTP de base.
        * Digest : authentification HTTP Digest.
      • Utilisateur du proxy : nom d'utilisateur permettant de s'authentifier auprès du serveur proxy.
      • Mot de passe du proxy : secret Secret Manager du mot de passe de l'utilisateur.
      • Type SSL du proxy : type SSL à utiliser pour se connecter au serveur proxy. Les types d'authentification suivants sont compatibles :
        * Auto : paramètre par défaut. Dans le cas d'une URL HTTPS, l'option "Tunnel" est utilisée. Dans le cas d'une URL HTTP, l'option "Jamais" est utilisée.
        * Toujours : le protocole SSL est toujours activé pour la connexion.
        * Jamais : le protocole SSL n'est pas activé pour la connexion.
        * Tunnel : la connexion s'effectue avec un proxy de tunnelisation. Le serveur proxy ouvre une connexion à l'hôte distant et le trafic transite par le proxy.
      • Dans la section Serveur proxy, saisissez les détails du serveur proxy.
        1. Cliquez sur + Ajouter une destination.
        2. Sélectionnez un type de destination.
        * Adresse de l'hôte : spécifiez le nom d'hôte ou l'adresse IP de la destination.
        Si vous souhaitez établir une connexion privée à votre système backend, procédez comme suit :
        * Créez un rattachement de service PSC.
        * Créez un rattachement de point de terminaison, puis saisissez les détails du rattachement de point de terminaison dans le champ Adresse de l'hôte.
    10. (Facultatif) Cliquez sur + AJOUTER UNE ÉTIQUETTE pour ajouter une étiquette à la connexion sous la forme d'une paire clé/valeur.
    11. Cliquez sur 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 Box :
      • Authentification JWT
      • Code d'autorisation OAuth 2.0
      • JSON de Box
      • Identifiants client OAuth 2.0

Pour savoir comment configurer ces types d'authentification, consultez Configurer l'authentification.
2. Cliquez sur SUIVANT. 6. Vérifier : vérifiez vos informations de connexion et d'authentification. 7. Cliquez sur Créer.

Configurer l'authentification

Saisissez les informations en fonction de l'authentification que vous souhaitez utiliser.

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 Étapes supplémentaires après la création de la connexion.

Exemples de configuration de connexion

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

Type de connexion avec un jeton OAuth JWT

Nom du champ Détails
Emplacement us-central1
Connecteur Box
Version du connecteur 1
Nom de connexion box-conn
Activer Cloud Logging Oui
Compte de service XXXX@comptedeservice
Mode d'emprunt d'identité User
Nombre minimal de nœuds 2
Nombre maximal de nœuds 2
Authentification Authentification JWT
ID client XXXX
Code secret du client XXXX
Version du secret 1
Clé privée XXXX
Version du secret 1
Mot de passe de la clé privée XXXX
Version du secret 1
Niveau d'accès de l'application Box Enterprise
ID d'entreprise/ID utilisateur XXXX
ID de clé publique JWT OAuth XXXX
Schéma d'authentification OAuthJWT
Initier OAuth GETANDREFRESH
Type de certificat JWT OAuth BLOB_CLÉPEM

Vous pouvez accéder à l'ID client, au code secret du client, au niveau d'accès à l'application Box et à l'ID d'entreprise/ID utilisateur depuis le compte Box.

Vous pouvez accéder à la clé privée et à son mot de passe à partir du fichier Private keypair.json que vous avez téléchargé. Pour en savoir plus, consultez Public and Private keypair (Paire de clés publique et privée). Avant de transmettre le mot de passe de la clé privée, remplacez également \n dans le fichier json par une nouvelle ligne.

Nom du champ Détails
Emplacement us-central1
Connecteur Box
Version du connecteur 1
Nom de connexion box-conn
Activer Cloud Logging Oui
Compte de service XXXX@comptedeservice
Mode d'emprunt d'identité User
Autorisation Code d'autorisation OAuth 2.0
Nombre minimal de nœuds 2
Nombre maximal de nœuds 2
ID client XXXX
Niveaux d'accès root_readwrite
Code secret du client XXXX
Version du secret 1

Pour en savoir plus sur la configuration de Box OAuth, consultez Create your OAuth application (Créer votre application OAuth).

Type de connexion avec la méthode JSON de Box pour l'authentification JWT

Nom du champ Détails
Emplacement us-central1
Connecteur Box
Version du connecteur 1
Nom de connexion gcp-box-conn-new
Activer Cloud Logging Oui
Compte de service XXXX@comptedeservice
Mode d'emprunt d'identité User
En tant qu'ID utilisateur XXXX
Nombre minimal de nœuds 2
Nombre maximal de nœuds 2
Authentification JSON de Box
JSON de Box pour l'authentification JWT XXXX
Version du secret 1

Vous pouvez utiliser le compte Box pour configurer la méthode JSON de Box pour l'authentification JWT. Pour savoir comment effectuer la configuration, consultez la procédure à suivre pour créer un jeton JWT.

Accédez à la valeur du champ "JSON de Box pour l'authentification JWT" depuis le fichier Private keypair.json que vous avez téléchargé. Pour en savoir plus, consultez Public and Private keypair (Paire de clés publique et privée). Vous devez transmettre l'intégralité du contenu du fichier .json dans le champ JSON de Box pour l'authentification JWT.

Type de connexion avec des identifiants client OAuth

Nom du champ Détails
Emplacement us-central1
Connecteur Box
Version du connecteur 1
Nom de connexion oauth-clientcred-conn
Activer Cloud Logging Oui
Compte de service XXXX@comptedeservice
Mode d'emprunt d'identité User
En tant qu'ID utilisateur XXXX
Nombre minimal de nœuds 2
Nombre maximal de nœuds 2
Authentification Identifiants client OAuth
ID client OAuth XXXX
Code secret du client OAuth XXXX
Version du secret 1
ID du sujet XXXX
Niveau d'accès de l'application Box Enterprise

Vous pouvez accéder à l'ID client, au code secret du client, au niveau d'accès à l'application Box et à l'ID d'entreprise/ID utilisateur depuis le compte Box.

Accorder une nouvelle autorisation pour le code d'autorisation

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

  1. Sur la page Connexions, cliquez sur la connexion requise.
    La page de détails de la connexion s'ouvre.
  2. Cliquez sur Modifier pour modifier les détails de la connexion.
  3. Dans la section Authentification, vérifiez les détails du code d'autorisation OAuth 2.0.
    Apportez des modifications, si besoin.
  4. Cliquez sur Enregistrer. La page de détails de la connexion s'affiche.
  5. Dans la section Authentification, cliquez sur Modifier l'autorisation. Le volet 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.

É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 ci-dessous 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 sera 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 détails de l'autorisation.
  5. Cliquez sur Autoriser.
    Si l'autorisation aboutit, l'état de la connexion est défini sur Active sur la page Connexions.

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 par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

Actions

Dans cette section, vous trouverez la liste des actions compatibles avec la connexion Box.

Action DownloadFile

Cette action vous permet de télécharger un fichier depuis votre instance Box.

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

Nom du paramètre Type de données Obligatoire Description
FileID Chaîne Oui ID du fichier à télécharger.
HasBytes Booléen Oui Indique si le fichier doit être téléchargé en tant que chaîne ou en tant que chaîne encodée en Base64.

Paramètres de sortie de l'action DownloadFile

Cette action renvoie l'état 200 (OK) avec un corps de réponse indiquant les résultats.

Nom du paramètre Type de données Description
Success Chaîne Indique si le téléchargement du fichier a abouti.
ContentBytes Chaîne Contenu du fichier sous forme de chaîne encodée en Base64.

Pour savoir comment configurer l'action DownloadFile, consultez Exemples d'actions.

Action UploadFile

Cette action vous permet d'importer un fichier dans votre instance Box.

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

Nom du paramètre Type de données Obligatoire Description
ParentID Chaîne Oui ID du dossier dans lequel vous souhaitez importer le fichier. Si ce paramètre n'est pas spécifié, le fichier est importé à la racine du compte Box. La valeur par défaut est 0.
Content Chaîne Oui Contenu du fichier à importer.

Paramètres de sortie de l'action UploadFile

Cette action renvoie l'état 200 (OK) avec un corps de réponse indiquant les résultats.

Nom du paramètre Type de données Description
Success Chaîne Indique si l'importation du fichier a abouti.
ID Chaîne ID du fichier récemment créé.
VersionID Chaîne ID d'une version spécifique du fichier.
Hash Chaîne Hachage SHA1 du fichier.
ETag Chaîne Valeur ETag du fichier ou du dossier. La valeur par défaut est 0.

Pour savoir comment configurer l'action UploadFile, consultez Exemples d'actions.

Action CopyFile

Cette action vous permet de copier un fichier depuis votre instance Box.

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

Nom du paramètre Type de données Obligatoire Description
FileID Chaîne Oui ID du fichier que vous souhaitez copier.
DestinationFolderId Chaîne Non ID du dossier de destination dans lequel vous souhaitez copier le fichier. Si vous ne spécifiez aucune valeur, la dernière version du fichier est copiée.
NewName Chaîne Oui Nouveau nom du fichier copié.

Paramètres de sortie de l'action CopyFile

Cette action renvoie l'état 200 (OK) avec un corps de réponse indiquant les résultats.

Nom du paramètre Type de données Description
Success Chaîne Indique si la copie du fichier a abouti.
ID Chaîne ID du fichier copié.

Pour savoir comment configurer l'action CopyFile, consultez Exemples d'actions.

Action CopyFolder

Cette action vous permet de copier un dossier entier depuis votre instance Box.

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

Nom du paramètre Type de données Obligatoire Description
FolderID Chaîne Oui ID du dossier que vous souhaitez copier.
DestinationFolderId Chaîne Oui ID du dossier de destination dans lequel vous souhaitez copier le dossier.
NewName Chaîne Non Nouveau nom du dossier copié.

Paramètres de sortie de l'action CopyFolder

Cette action renvoie l'état 200 (OK) avec un corps de réponse indiquant les résultats.

Nom du paramètre Type de données Description
Success Chaîne Indique si la copie du dossier a abouti.
ID Chaîne ID du dossier copié.

Pour savoir comment configurer l'action CopyFolder, consultez Exemples d'actions.

Exemples d'actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Exemple : Télécharger un fichier

  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": "1283194869422",
    "HasBytes": true
    }

Cet exemple télécharge un fichier en tant que chaîne encodée en Base64. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

[ { "Success": "True"}, {"ContentBytes": "JVBERi0xLjQKJcfl9OXwCjIgMCBvYmoKJSBbMjRdIAo8PAovRmlsdGVy"} ]

Exemple : Importer un fichier

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action UploadFile, 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 :
    {
    "ParentId": "0",
    "Content": "12345"
    }

Cet exemple importe le contenu de la chaîne en tant que fichier. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

[{ "Success": "true", "ID": "1283902965389", "VersionID": "1403546001389", "Hash": "8cb2237d0679ca88db6464eac60da96345513964", "Etag": "0" }]

Exemple : Copier un fichier

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CopyFile, 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": "1288751886061",
    "DestinationFolderId": "219105724517",
    "NewName": "NewCopiedFile"
    }

Cet exemple copie le fichier dont l'ID est 1288751886061 dans le dossier dont l'ID est 219105724517. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à celle-ci :

[{ "Success": "true", "ID": "1308006018536" }]

Exemple : Copier un dossier

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
  2. Sélectionnez l'action CopyFolder, 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 :
    {
    "FolderID": "218475301279",
    "DestinationFolderId": "0",
    "NewName": "NewCopiedFolder"
    }

Cet exemple copie le dossier dont l'ID est 218475301279 dans le dossier dont l'ID est 219105724517. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à celle-ci :

[{ "Success": "true", "ID": "226312444517" }]

Exemples d'opérations d'entité

Exemple : Lister tous les fichiers

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

Vous pouvez effectuer l'opération LIST sur les entités suivantes : Folders, TrashedItems, SharedItems, Collaborations, TaskAssignments et Tasks.

Exemple : Récupérer des fichiers

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

La valeur de l'ID d'entité doit être transmise directement (exemple : 1262397830475, où 1262397830475 est la valeur de clé primaire unique).

Vous pouvez effectuer l'opération GET sur les entités suivantes : Folders, SharedItems, Collaborations, TaskAssignments et Tasks.

Exemple : Supprimer des fichiers

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Files" dans la liste Entity.
  3. Sélectionnez l'opération DELETE, puis cliquez sur OK.
  4. Définissez l'ID d'entité sur "1258725940971", qui est la clé à transmettre. Pour définir l'ID d'entité, dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur EntityId, puis saisissez 1258725940971 dans le champ Valeur par défaut.
    Si l'entité comporte deux clés métier ou clés primaires composites, vous pouvez également définir la filterClause sur Id='1258725940971' au lieu de spécifier l'entityId.

Vous pouvez effectuer l'opération DELETE sur les entités suivantes : Folders, Tasks, Collaborations, SharedItems et TaskAssignments.

Exemple : Créer des dossiers

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Folders" 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": "Google Cloud Platforms_created_folders",
    "ParentId": "0"
    }
    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche Folder aura une valeur semblable à la suivante :

{
"Id": "222269371053"
}

Exemple : Créer des collaborations

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Collaborations" 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 :
    {
    "ItemId": "216592737829",
    "ItemType": "folder",
    "AccessibleById": "27370766275",
    "AccessibleByType": "user",
    "AccessibleByLogin": "baklavainthebalkans@gmail.com",
    "Role": "editor"
    }
    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche Folder aura une valeur semblable à la suivante :
    {
    "Success": false
    }

Exemple : Créer des tâches

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Tasks" 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 :
    {
    "ItemId": "1253997361112",
    "ItemType": "file",
    "Action": "review",
    "Message": "Creating a task from Google Cloud Platform",
    "DueAt": "2023-12-12 09:01:15.0",
    "CompletionRule": "all_assignees"
    }
    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche Folder aura une valeur semblable à la suivante :

{
"Id": "1253997361112"
}

Exemple : Créer des attributions de tâches

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "TaskAssignments" 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 :
    {
    "TaskId": "21507516872",
    "AssignedToId": "27370766275"
    }
    Si l'intégration aboutit, le paramètre de réponse connectorOutputPayload de la tâche Folder aura une valeur semblable à la suivante :

{
"Id": "50804351753"
}

Exemple : Mettre à jour des fichiers

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Files" 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 :
    {
    "Name": "Get Started with Box Files.pdf"
    }
  5. Définissez l'ID d'entité sur "1253997361112". Pour définir l'ID d'entité, cliquez sur entityId, puis saisissez 1253997361112 dans le champ Valeur par défaut.
    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 1253997361112.
    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :
    {
    "Id": "1253997361112"
    }

Vous pouvez effectuer l'opération UPDATE sur les entités suivantes : Folders, Tasks, Collaborations, SharedItems et TaskAssignments.

Exemple : Mettre à jour des dossiers

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Folders" 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 :
    {
    "Name": "Demo Update"
    }
  5. Définissez l'ID d'entité sur "216457668125". Pour définir l'ID d'entité, cliquez sur entityId, puis saisissez 216457668125 dans le champ Valeur par défaut.
    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 216457668125.
    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :
    {
    "Id": "216457668125"
    }

Exemple : Mettre à jour des collaborations

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Collaborations" 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 :
    {
    "Role": "Viewer"
    }
  5. Définissez l'ID d'entité sur "46685648757". Pour définir l'ID d'entité, cliquez sur entityId, puis saisissez 46685648757 dans le champ Valeur par défaut.
    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 46685648757.
    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :
    {
    }

Exemple : Mettre à jour des tâches

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Tasks" 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 :
    {
    "Message": "This is a new task is updated and assigned to you by me"
    }
  5. Définissez l'ID d'entité sur "21507516872". Pour définir l'ID d'entité, cliquez sur entityId, puis saisissez 21507516872 dans le champ Valeur par défaut.
    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 21507516872.
    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :
    {
    "Id": "21507516872"
    }

Exemple : Mettre à jour des attributions de tâche

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "TaskAssignments" 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 :
    {
    "Message": "Looks good to me",
    "ResolutionState": "completed"
    }
  5. Définissez l'ID d'entité sur "49542929469". Pour définir l'ID d'entité, cliquez sur entityId, puis saisissez 49542929469 dans le champ Valeur par défaut.
    Sinon, au lieu de spécifier l'entityId, vous pouvez définir la filterClause sur 49542929469.
    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :
    {
    "Id": "49542929469"
    }

Exemple : Mettre à jour des dossiers de transfert

  1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
  2. Sélectionnez "Folders" 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 :
    {
    "Name": "Demo Update"
    "ParentId": "216596059374"
    }
  5. Définissez l'ID d'entité sur "216457668125". Pour définir l'ID d'entité, cliquez sur entityId, puis saisissez 216457668125 dans le champ Valeur par défaut.
    L'exécution de cet exemple renvoie une réponse semblable à la suivante dans la variable de sortie connectorOutputPayload de la tâche "Connecteurs" :
    {
    "Id": "216457668125"
    }

Créer des connexions à l'aide de Terraform

Vous pouvez utiliser la ressource Terraform pour créer une connexion.

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez Commandes Terraform de base.

Pour afficher un exemple de modèle Terraform permettant de créer une connexion, consultez Exemple de modèle.

Lorsque vous créez cette connexion à l'aide de Terraform, vous devez définir les variables suivantes dans votre fichier de configuration Terraform :

Nom du paramètre Type de données Obligatoire Description
impersonate_user_mode ENUM Oui Spécifiez le type d'emprunt d'identité. Il doit s'agir du mode utilisateur ou du mode administrateur. Valeurs acceptées : "User" et "Admin".
proxy_enabled BOOLÉEN Non Cochez cette case afin de configurer un serveur proxy pour la connexion.
proxy_auth_scheme ENUM Non Type d'authentification à utiliser pour s'authentifier auprès du proxy ProxyServer. Valeurs acceptées : BASIC, DIGEST et NONE.
proxy_user CHAÎNE Non Nom d'utilisateur permettant de s'authentifier auprès du proxy ProxyServer.
proxy_password SECRET Non Mot de passe à utiliser pour s'authentifier auprès du proxy ProxyServer.
proxy_ssltype ENUM Non Type SSL à utiliser pour se connecter au proxy ProxyServer. Valeurs acceptées : AUTO, ALWAYS, NEVER et TUNNEL.

Utiliser la connexion Box dans une intégration

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

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

Étapes suivantes

Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.

Dernière mise à jour le 2026/06/18 (UTC).