La tâche Sheets – Append vous permet d'ajouter des données à la fin d'une table de données spécifiée dans une feuille de calcul Google. Les nouvelles valeurs sont ajoutées à la nouvelle ligne créée après la table spécifiée, en commençant par la première colonne de la table.
Google Sheets est l'une des nombreuses solutions de productivité basées sur le cloud disponibles dans Google Workspace. Il vous permet de créer et de modifier des feuilles de calcul en ligne avec une fonctionnalité de collaboration en temps réel.
Avant de commencer
Assurez-vous d'effectuer les tâches suivantes dans votre projet Google Cloud avant de configurer la tâche Sheets – Append :
- Activez l'API Google Sheets (
sheets.googleapis.com). -
Créez un profil d'authentification. Apigee Integration se connecte à un point de terminaison d'authentification à l'aide d'un profil d'authentification pour la tâche Sheets – Append.
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.
- Découvrez les termes courants utilisés dans Google Sheets.
Configurer la tâche Sheets – Append
- 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 :
- Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
- Dans la liste des régions compatibles, sélectionnez une région pour l'intégration.
- 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 Sheets – Append et placez-le dans le concepteur d'intégration.
- Cliquez sur l'élément Sheets – Append du concepteur pour ouvrir le volet de configuration de la tâche Sheets – Append.
- 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 affiché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 Sheets – Append :
| Propriété | Type de données | Description |
|---|---|---|
| SpreadsheetId | String | ID de votre feuille de calcul L'ID de votre feuille de calcul se trouve dans son URL Web. Par exemple : |
| Plage | String | Notation A1 d'une plage pour rechercher la table souhaitée dans la feuille. |
| IncludeValuesInResponse | Booléen | Indique si l'objet renvoyé doit inclure les valeurs des cellules qui ont été ajoutées. |
| InsertDataOption | enum (InsertDataOption) | Indique comment les données existantes seront modifiées lors de l'ajout des nouvelles données. |
| ValueInputOption | enum (ValueInputOption) | Indique comment les données sont interprétées.
Valeur par défaut : |
| ResponseDateTimeRenderOption | enum (DateTimeRenderOption) | Indique comment les valeurs liées à la date, à l'heure et à la durée sont représentées dans le résultat.
Valeur par défaut : |
| ResponseValueRenderOption | enum (ValueRenderOption) | Indique comment les valeurs récupérées sont représentées dans le résultat. Valeur par défaut : |
| Demande | JSON | Le corps de la requête est un objet ValueRange qui décrit les valeurs de la plage à écrire. Consultez la section Structure JSON de requête. |
Résultat de la tâche
La tâche Sheets – Append renvoie le résultat de la réponse contenant un objet AppendValuesResponse, semblable à l'exemple de résultat suivant :
{
"spreadsheetId": SPREADSHEET_ID,
"tableRange": "Sheet1!A1:D2",
"updates": {
"spreadsheetId": SPREADSHEET_ID,
"updatedRange": "Sheet1!A3:D4",
"updatedRows": 2,
"updatedColumns": 4,
"updatedCells": 8,
}
}
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.