Cette page a été traduite par l'API Cloud Translation.

Connecteur Google Drive

Le connecteur Google Drive vous permet de créer et de configurer une connexion Google Drive dans Integration Connectors. Vous pouvez utiliser cette connexion dans vos applications métier pour échanger des données et effectuer des opérations avec Google Drive de manière sécurisée.

Pour obtenir la liste des entités et opérations compatibles, consultez Entités et opérations compatibles. Pour en savoir plus sur les actions spécifiques aux connecteurs compatibles, consultez Actions compatibles.

Versions du connecteur Google Drive

Le connecteur Google Drive est compatible avec deux versions :

Google Drive v1 : utilisez cette version du connecteur pour accéder à l'API Google Drive v3.
Google Drive v2 : utilisez cette version du connecteur pour accéder à l'API Google Drive v2.

Pour savoir comment créer une connexion Google Drive, consultez Créer et configurer un connecteur Google Drive.

Entités et opérations compatibles

Le connecteur Google Drive est compatible avec les entités et opérations suivantes :

Entité	Description	Opérations
`File`	Représente un fichier dans Google Drive.	`Get`, `List`, `Create`, `Update` et `Delete`
`Folder`	Représente un dossier dans Google Drive.	`Get`, `List`, `Create`, `Update` et `Delete`
`Permission`	Représente une autorisation pour un fichier ou un dossier dans Google Drive.	`Get`, `List`, `Create`, `Update` et `Delete`
`Drive`	Représente un drive dans Google Drive.	`Get`, `List`, `Create`, `Update` et `Delete`

Pour obtenir des exemples de cas d'utilisation d'Application Integration, consultez Exemples de cas d'utilisation dans Application Integration.

Action compatible

Le connecteur Google Drive accepte les actions suivantes :

CopyResource

Description : crée une copie d'une ressource spécifiée dans Google Drive. Vous pouvez définir un nouveau nom pour le fichier copié et spécifier son dossier de destination en fournissant une liste d'ID de dossiers parents .

Paramètres d'entrée

Nom du paramètre	Type de données	Obligatoire	Description
`Id`	Chaîne	Oui	ID de la ressource à copier.
`NewName`	Chaîne	Oui	Nouveau nom du fichier copié.
`ParentIDs`	Chaîne	Non	Liste d'ID de dossiers parents séparés par une virgule dans lesquels le fichier copié sera placé. Si aucune destination n'est spécifiée, le fichier est copié dans le dossier où il se trouvait.
`IgnoreDefaultVisibility`	Booléen	Non	Détermine s'il faut ignorer les paramètres de visibilité par défaut pour le fichier nouvellement créé. Si le domaine est configuré pour rendre tous les fichiers importés visibles par défaut, la définition de ce paramètre sur "true" remplace ce comportement pour cette requête spécifique. La valeur par défaut est "false".
`IncludeLabels`	Chaîne	Non	Liste d'ID de libellés séparés par une virgule à inclure dans la partie "labelInfo" de la réponse.
`IncludePermissionsForView`	Chaîne	Oui	Ce champ spécifie les autorisations de vue supplémentaires à inclure dans la réponse. La valeur acceptée est publiée.
`KeepRevisionForever`	Booléen	Non	Indique s'il faut conserver les révisions du fichier indéfiniment. Cette fonctionnalité ne s'applique qu'aux fichiers incluant du contenu binaire dans Google Drive. Vous pouvez conserver jusqu'à 200 versions par fichier indéfiniment. Si vous atteignez cette limite, vous devez supprimer des révisions existantes pour en ajouter d'autres. La valeur par défaut est "false".
`OCRLanguage`	Chaîne	Non	Ce champ fournit un indice de langue pour la reconnaissance optique des caractères (OCR) lors de l'importation de fichiers image. Indiquez la langue à l'aide d'un code de langue ISO 639-1 à deux lettres, par exemple `en` pour l'anglais ou `de` pour l'allemand.
`SupportsAllDrives`	Booléen	Oui	Ce paramètre indique s'il faut suivre les modifications dans Mon Drive et les Drive partagés. Définissez ce paramètre sur "true" pour activer l'accès aux Drive partagés. La valeur par défaut est "false".

Paramètres de sortie

Nom du paramètre	Type de données	Description
`CopiedFileID`	Chaîne	ID du fichier copié.
`Success`	Chaîne	Ce paramètre indique si l'opération a réussi ou non.

Exemple de cas d'utilisation

L'exemple suivant montre comment configurer l'action CopyResource dans Application Integration :

Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
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 champ Default Value :
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "NewName": "Copied of Untitles Document.txt1750848165952", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :
```
        [{"CopiedFileID": "15NUzJGarp-b8TdT0tXBGD9hJMnYjZbiydaE4lbZV0EU", "Success": "TRUE"}]
      
```

CreateFolder

Description : crée un dossier dans votre Google Drive. Vous devez donner un nom au nouveau dossier et spécifier son emplacement en fournissant les ID de ses dossiers parents. Vous pouvez également ajouter une description facultative et marquer le dossier comme favori.

Paramètres d'entrée

Nom du paramètre	Type de données	Obligatoire	Description
`Name`	Chaîne	Oui	Titre du dossier.
`Description`	Chaîne	Non	Description du dossier.
`Starred`	Booléen	Non	Ce paramètre indique si le dossier est mis en favori. La valeur par défaut est "false".
`ParentIds`	Chaîne	Oui	Liste d'ID de dossiers parents, séparés par une virgule, dans lesquels le nouveau dossier sera créé.

Paramètres de sortie

Nom du paramètre	Type de données	Description
`Success`	Chaîne	Ce paramètre indique si l'opération a réussi ou non.
`Id`	Chaîne	ID du nouveau dossier.

Exemple de cas d'utilisation

L'exemple suivant montre comment configurer l'action CreateFolder dans Application Integration :

Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
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 champ Default Value :
```
        { "Name": "Test Folder", "ParentIds": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
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": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}]
      
```

DeleteResource

Description : supprime définitivement un fichier ou un dossier de Google Drive. Pour utiliser cette action, vous devez fournir l'ID unique de la ressource que vous souhaitez supprimer.

Paramètres d'entrée

Nom du paramètre	Type de données	Obligatoire	Description
`Id`	Chaîne	Oui	ID de la ressource à supprimer.

Paramètres de sortie

Nom du paramètre	Type de données	Description
`Success`	Chaîne	Ce paramètre indique si l'opération a réussi ou non.

Exemple de cas d'utilisation

L'exemple suivant montre comment configurer l'action DeleteResource dans Application Integration :

Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
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 champ Default Value :
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}
      
```
Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :
```
        [{"Success": "TRUE"}]
      
```

DownloadFile

Description : télécharge un fichier depuis Google Drive

Paramètres d'entrée

Nom du paramètre	Type de données	Obligatoire	Description
`Id`	Chaîne	Oui	ID du fichier à télécharger.
`LocalFile`	Chaîne	Non	Chemin d'accès et nom du fichier dans lequel le fichier sera enregistré. Laissez ce champ vide pour stocker le fichier en mémoire.
`Encoding`	Chaîne	Non	Type d'encodage des données de fichier. Si LocalFile est vide, les données du fichier seront renvoyées dans l'encodage spécifié. Les valeurs autorisées sont NONE et BASE64. La valeur par défaut est BASE64.
`Overwrite`	Booléen	Non	Ce paramètre détermine s'il faut écraser le fichier s'il existe déjà lors du téléchargement. La valeur par défaut est "false". Définissez le paramètre sur "TRUE" pour écraser le fichier.
`FileFormat`	Chaîne	Non	Le format dans lequel le fichier peut être téléchargé. La taille maximale du fichier est de 10 Mo. Ne renseignez pas ce paramètre pour télécharger le fichier dans son format d'origine. Les formats acceptés sont DOCX, ODT, RTF, HTML, TXT et PDF.

Paramètres de sortie

Nom du paramètre	Type de données	Description
`FileData`	Chaîne	Si LocalFile n'est pas fourni, les données du fichier seront renvoyées à l'aide de l'encodage spécifié.
`Success`	Chaîne	Ce paramètre indique si l'opération a réussi ou non.

Exemple de cas d'utilisation

L'exemple suivant montre comment configurer l'action DownloadFile dans Application Integration :

Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
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 champ Default Value :
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "LocalFile": "gs://test-bucket/test-file.txt", "Encoding": "NONE", "Overwrite": true, "FileFormat": "HTML"}
      
```
Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :
```
        [{"FileData": "This is a test file.", "Success": "TRUE"}]
      
```

MoveResource

Description : déplace un fichier ou un dossier vers un autre emplacement dans Google Drive. Vous devez fournir l'ID de la ressource à déplacer et les ID des nouveaux dossiers parents.

Paramètres d'entrée

Nom du paramètre	Type de données	Obligatoire	Description
`Id`	Chaîne	Oui	ID de la ressource à déplacer.
`ParentIDs`	Chaîne	Oui	Liste d'ID séparés par une virgule à utiliser comme dossiers parents. Une ressource dans un Drive partagé doit avoir exactement un dossier parent. Seuls les utilisateurs disposant du rôle "Organisateur de fichiers" ou "Organisateur" peuvent déplacer des fichiers et des dossiers dans un Drive partagé.

Paramètres de sortie

Nom du paramètre	Type de données	Description
`Success`	Chaîne	Ce paramètre indique si l'opération a réussi ou non.

Exemple de cas d'utilisation

L'exemple suivant montre comment configurer l'action MoveResource dans Application Integration :

Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
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 champ Default Value :
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :
```
        [{"Success": "TRUE"}]
      
```

UpdateResource

Description : met à jour les métadonnées d'un fichier ou d'un dossier dans Google Drive. Vous pouvez modifier son nom, sa description, son type MIME et indiquer s'il est favori.

Paramètres d'entrée

Nom du paramètre	Type de données	Obligatoire	Description
`Id`	Chaîne	Oui	ID de la ressource à mettre à jour.
`Name`	Chaîne	Oui	Nouveau nom du fichier modifié.
`Description`	Chaîne	Non	Description du fichier ou du dossier.
`MIMEType`	Chaîne	Non	Type MIME du fichier.
`Starred`	Chaîne	Non	Ce paramètre indique si la ressource est marquée comme favorite. La valeur par défaut est "false".

Paramètres de sortie

Nom du paramètre	Type de données	Description
`Success`	Chaîne	Ce paramètre indique si l'opération a réussi ou non.

Exemple de cas d'utilisation

L'exemple suivant montre comment configurer l'action UpdateResource dans Application Integration :

Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
Sélectionnez l'action UpdateResource, 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 champ Default Value :
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "Name": "New Name", "Description": "New Description", "MIMEType": "application/vnd.google-apps.document", "Starred": true}
      
```
Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :
```
        [{"Success": "TRUE"}]
      
```

UploadFile

Description : importe un fichier dans Google Drive. Vous devez fournir les données du fichier et son type MIME. Vous pouvez également spécifier le dossier parent dans lequel le fichier sera placé et un nom de fichier pour le fichier importé.

Paramètres d'entrée

Nom du paramètre	Type de données	Obligatoire	Description
`Id`	Chaîne	Oui	ID du fichier à importer.
`FileData`	Chaîne	Oui	Données du fichier à importer.
`MIMEType`	Chaîne	Oui	Type MIME du fichier.
`ParentIDs`	Chaîne	Non	Liste d'ID de dossiers parents séparés par une virgule dans lesquels le fichier importé sera placé. Si aucune valeur n'est spécifiée, le fichier est importé dans le dossier racine Mon Drive de l'utilisateur.
`Filename`	Chaîne	Non	Nom du fichier à importer.

Paramètres de sortie

Nom du paramètre	Type de données	Description
`Success`	Chaîne	Ce paramètre indique si l'opération a réussi ou non.

Exemple de cas d'utilisation

L'exemple suivant montre comment configurer l'action UploadFile dans Application Integration :

Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
Sélectionnez l'action UploadFile, 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 champ Default Value :
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "FileData": "This is a test file.", "MIMEType": "text/plain", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5", "Filename": "test-file.txt"}
      
```
Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :
```
        [{"Success": "TRUE"}]
      
```

SubscribeToFileChanges

Description : s'abonne aux notifications de modification d'un fichier spécifique dans Google Drive.

Paramètres d'entrée

Nom du paramètre	Type de données	Obligatoire	Description
`Id`	Chaîne	Oui	ID du fichier auquel s'abonner.
`Token`	Chaîne	Oui	Jeton à utiliser pour s'abonner aux modifications apportées aux fichiers.

Paramètres de sortie

Nom du paramètre	Type de données	Description
`Success`	Chaîne	Ce paramètre indique si l'opération a réussi ou non.

Exemple de cas d'utilisation

L'exemple suivant montre comment configurer l'action SubscribeToFileChanges dans Application Integration :

Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
Sélectionnez l'action SubscribeToFileChanges, 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 champ Default Value :

        {
          "FileId": "1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY",
          "Id": "Id11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

SubscribeToUserChanges

Description : s'abonne aux notifications concernant les modifications apportées par un utilisateur spécifique dans Google Drive.

Paramètres d'entrée

Nom du paramètre	Type de données	Obligatoire	Description
`Id`	Chaîne	Oui	ID de l'utilisateur auquel l'abonnement doit être souscrit.
`Token`	Chaîne	Oui	Jeton à utiliser pour s'abonner aux modifications apportées par l'utilisateur.

Exemple de cas d'utilisation

L'exemple suivant montre comment configurer l'action SubscribeToUserChanges dans Application Integration :

Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
Sélectionnez l'action SubscribeToUserChanges, 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 champ Default Value :

        {
          "Id": "11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/users/me?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

StopWatchingResources

Description : vous désabonne des notifications pour une ressource que vous avez déjà regardée.

Paramètres d'entrée

Nom du paramètre	Type de données	Obligatoire	Description
`Id`	Chaîne	Oui	ID de la ressource dont la surveillance doit être arrêtée.
`Token`	Chaîne	Oui	Jeton à utiliser pour arrêter de regarder des ressources.

Exemple de cas d'utilisation

L'exemple suivant montre comment configurer l'action StopWatchingResources dans Application Integration :

Dans la boîte de dialogue Configurer la tâche "Connecteurs", cliquez sur Actions.
Sélectionnez l'action StopWatchingResources, 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 champ Default Value :

        {
          "Id": "Id11752060129918",
          "Token": "token"
        }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

        [
          {
            "Kind": "api#channel",
            "Id": "stopid1751971586168",
            "ResourceId": "CXPNGzAnYjqSazkd9-nNTFHTkwo",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/11OsOCgkV5hsRai6UwpkLngvqnCcrA4sy1tqfPi_VJio?alt=json&supportsAllDrives=true",
            "Token": null,
            "Expiration": "1751975186000"
          }
        ]

Limites du système

Le connecteur Google Drive peut traiter au maximum deux transactions par seconde et par nœud, et limite les transactions au-delà de ce seuil. Par défaut, Integration Connectors alloue deux nœuds (pour améliorer la disponibilité) à une connexion.

Pour en savoir plus sur les limites applicables à Integration Connectors, consultez Limites.

Remarque : L'autoscaling du nombre de nœuds Integration Connectors s'effectue de manière dynamique en fonction de votre utilisation. Toutefois, si vous souhaitez réserver de la capacité pour de gros volumes sans attendre l'autoscaling, vous pouvez ajuster le nombre minimal de nœuds pour une connexion. 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 configurer les valeurs de nœuds, procédez comme suit :

Si vous avez opté pour le paiement à l'usage, configurez le nombre minimal et le nombre maximal de nœuds sur la page "Modifier la connexion".
Si vous avez souscrit un abonnement, contactez l'assistance.

Le nombre maximal de transactions qu'un nœud peut traiter dépend de plusieurs facteurs. Par conséquent, avant d'ajuster le nombre minimal de nœuds pour améliorer le débit, nous vous recommandons de vérifier si vos systèmes backend sont configurés de manière optimale pour gérer le trafic requis.

Étapes suivantes

Découvrez comment créer et configurer une connexion Google Drive.
Découvrez comment suspendre et reprendre une connexion.
Découvrez comment surveiller l'utilisation des connecteurs.
Découvrez comment afficher les journaux des connecteurs.

Demander de l'aide à la communauté Google Cloud

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