Consultez les connecteurs compatibles avec Application Integration.

Tâche Drive – Répertorier

La tâche Drive - Répertorier vous permet de rechercher et de récupérer des fichiers et des dossiers stockés dans un compte Google Drive.

Google Drive est un service de stockage de fichiers dans le cloud qui vous offre un espace de stockage personnel pour stocker et accéder à des fichiers et des dossiers partagés dans le cloud.

Avant de commencer

Assurez-vous d'effectuer les tâches suivantes dans votre projet Google Cloud avant de configurer la tâche Drive - Répertorier:

  1. Activez l'API Google Drive (drive.googleapis.com).

    Activez l'API Google Drive

  2. Créer un profil d'authentification Application Integration utilise un profil d'authentification afin de se connecter à un point de terminaison d'authentification pour la tâche Drive – Liste.

    Pour en savoir plus sur l'attribution de rôles ou d'autorisations supplémentaires à un compte de service, consultez la page Accorder, modifier et révoquer des accès.

Configurer la tâche Drive - Répertorier

  1. Dans la console Google Cloud, accédez à la page Application Integration.

    Accéder à Application Integration

  2. Dans le menu de navigation, cliquez sur Integrations (Intégrations).

    La page Intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud.

  3. Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.

    Si vous créez une intégration :

    1. Saisissez un nom et une description dans le volet Créer une intégration.
    2. Sélectionnez une région pour l'intégration.
    3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les détails du compte de service d'une intégration à tout moment à partir du volet Integration summary (Résumé de l'intégration) dans la barre d'outils de l'intégration.
    4. Cliquez sur Créer.

    Cela entraîne son ouverture dans l'éditeur d'intégrations.

  4. Dans la barre de navigation de l'éditeur d'intégration, cliquez sur Tasks (Tâches) pour afficher la liste des tâches et des connecteurs disponibles.
  5. Cliquez sur l'élément Drive – Liste et placez-le dans l'éditeur d'intégration.
  6. Cliquez sur l'élément Drive - Répertorier dans le concepteur pour afficher le volet de configuration de la tâche Drive - Répertorier.
  7. Accédez à Authentification, puis sélectionnez un profil d'authentification existant que vous souhaitez utiliser.

    Facultatif. Si vous n'avez pas créé de profil d'authentification avant de configurer la tâche, cliquez sur + Nouveau profil d'authentification et suivez les étapes mentionnées dans la section Créer un profil d'authentification.

  8. Accédez à l'Entrée de la tâche et configurez les champs d'entrée souhaités à l'aide du tableau Paramètres d'entrée de la tâche suivant.

    Les modifications apportées aux champs d'entrée sont enregistrées automatiquement.

Paramètres d'entrée de la tâche

Le tableau suivant décrit les paramètres d'entrée de la tâche Drive - Répertorier:

Propriété Type de données Description
Corpora Chaîne Paramètre facultatif permettant de rechercher des fichiers dans un corpus.
DriveId Chaîne ID de votre Drive partagé Google.
IncludeItemsFromAllDrives Booléen Définissez la valeur sur true si vous souhaitez inclure à la fois les éléments de votre Drive personnel et de votre Drive partagé dans les résultats de recherche.

Valeur par défaut : false
IncludeLabels Chaîne Liste d'ID de libellés séparés par une virgule, inclus dans la partie labelInfo de la réponse. Pour en savoir plus sur les ID de libellés, consultez la section Présentation des libellés.
IncludePermissionsForView Chaîne Spécifiez published. Pour plus d'informations, consultez la section Partager des fichiers, des dossiers et des Drive.
OrderBy Chaîne Ordre dans lequel les fichiers sont triés. Par défaut, chaque clé est triée dans l'ordre croissant. Pour en savoir plus, consultez la section sur la méthode files.list.

Voici les valeurs valides :

  • createdTime
  • folder
  • modifiedByMeTime
  • modifiedTime
  • name
  • name_natural
  • quotaBytesUsed
  • recency
  • sharedWithMeTime
  • starred
  • viewedByMeTime
PageSize Integer Nombre maximal de fichiers à renvoyer par page.

Les valeurs acceptées sont comprises entre 1 et 1000.

Valeur par défaut : 100
PageToken Chaîne Jeton permettant de poursuivre une tâche Drive - Répertorier précédente. Définissez cette valeur sur la valeur de nextPageToken de la réponse précédente.
Q Chaîne Requête permettant de filtrer les résultats des fichiers. Pour en savoir plus, consultez la page Rechercher des fichiers.
Spaces Chaîne Liste des espaces à interroger dans les corpus, séparés par une virgule.

Les valeurs acceptables sont drive et appDataFolder.
SupportsAllDrives Booléen Définissez la valeur sur true si l'application à l'origine de la requête est compatible avec Mon Drive et les Drive partagés.

Valeur par défaut : false

Résultat de la tâche

La tâche Drive - Répertorier renvoie le résultat de la réponse contenant la liste des fichiers. Voici un exemple de résultat :

  {
    "nextPageToken": string,
    "kind": string,
    "incompleteSearch": boolean,
    "files": [
      {
        object (File)
      }
    ]
  }

Stratégie de traitement des erreurs

Une stratégie de traitement des erreurs d'une tâche spécifie l'action à effectuer si celle-ci échoue en raison d'une erreur temporaire. Pour en savoir plus sur l'utilisation et les différents types de stratégies de traitement des erreurs, consultez la page Stratégies de traitement des erreurs.

Quotas et limites

Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.

Étape suivante