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 des fichiers et des dossiers partagés dans le cloud, et y accéder.

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:

Activez l'API Google Sheets (sheets.googleapis.com).
Activer l'API Google Drive
Créez un profil d'authentification. L'intégration Apigee utilise un profil d'authentification pour se connecter à un point de terminaison d'authentification pour la tâche Drive - Répertorier.
Pour en savoir plus sur l'attribution de rôles ou d'autorisations supplémentaires à un compte de service, consultez la section Attribuer, modifier et révoquer les accès.

Configurer la tâche Drive - Répertorier

Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
Cliquez sur Développer > Intégrations.
Sélectionnez une intégration existante ou créez-en une en cliquant sur Créer une intégration.
Si vous créez une intégration :
1. Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
2. Dans la liste des régions compatibles, sélectionnez une région pour l'intégration.
3. Cliquez sur Créer.
La page de conception d'intégration s'affiche.
Dans la barre de navigation de la page de conception d'intégration, cliquez sur +Ajouter une tâche ou un déclencheur > Tâches pour afficher la liste des tâches disponibles.
Cliquez sur l'élément Drive - Répertorier et placez-le dans le concepteur d'intégration.
Cliquez sur l'élément Drive - Répertorier dans le concepteur pour afficher le volet de configuration de la tâche Drive - Répertorier.
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.
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`	String	Paramètre facultatif permettant de rechercher des fichiers dans un corpus.
`DriveId`	String	ID de votre Drive partagé Google
`IncludeItemsFromAllDrives`	Booléen	Définissez la valeur sur `true` si vous souhaitez inclure à la fois votre élément de Drive personnel et de Drive partagé dans les résultats de recherche. Valeur par défaut : `false`
`IncludeLabels`	String	Liste d'ID de libellés séparés par des virgules 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`	String	Spécifiez `published`. Pour plus d'informations, consultez la section Partager des fichiers, des dossiers et des Drive.
`OrderBy`	String	Ordre de tri des fichiers Les valeurs acceptées sont les suivantes: `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`	String	Jeton permettant de poursuivre une tâche Drive - Répertorier précédente. Définissez cette valeur sur la valeur `nextPageToken` de la réponse précédente.
`Q`	String	Requête de filtrage des résultats du fichier. Pour en savoir plus, consultez la page Rechercher des fichiers.
`Spaces`	String	Liste d'espaces, séparés par une virgule, à interroger dans le corpus. 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.

Étapes suivantes

Ajoutez des arêtes et conditions d'arêtes.
Testez et publiez votre intégration.
Configurez un déclencheur.
Ajoutez une tâche de mappage de données.
Consultez toutes les tâches des services Google Cloud.