Toggl Track (Éditeur indépendant) (préversion)
Le seul logiciel de suivi du temps qui génère des rapports personnalisés à partir des données de temps de votre équipe pour optimiser la productivité et les revenus. Notre solution de suivi du temps enregistre une chronologie de calendrier de toutes vos activités professionnelles tout au long de la journée.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - Régions Azure Chine - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC) - Us Government (GCC High) - China Cloud géré par 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| Messagerie électronique | ttaylor@hitachisolutions.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | troystaylor |
| Site internet | https://toggl.com/track/automated-time-tracker/ |
| Politique de confidentialité | https://toggl.com/legal/track/privacy/ |
| Catégories | Productivité |
Toggl Track
Le seul logiciel de suivi du temps qui génère des rapports personnalisés à partir des données de temps de votre équipe pour optimiser la productivité et les revenus. Notre solution de suivi du temps enregistre une chronologie de calendrier de toutes vos activités professionnelles tout au long de la journée.
Éditeur : Troy Taylor, Hitachi Solutions
Prerequisites
Vous devez vous inscrire à un compte avec Toggl.
Obtention des informations d’identification
Ce connecteur utilise l’authentification de base avec votre adresse e-mail et votre mot de passe.
Opérations prises en charge
Obtenir l’utilisateur actuel
Retourne les détails de l’utilisateur actuel.
Mettre à jour l’utilisateur actuel
Met à jour les détails de l’utilisateur actuel.
Obtenir des clients utilisateur
Obtenir des clients pour l’utilisateur actuel.
Obtenir les fonctionnalités utilisateur
Obtenir les fonctionnalités disponibles pour l’utilisateur actuel.
Obtenir l’emplacement de l’utilisateur
Retourne l’emplacement IP du client. Si aucune donnée n’est présente, la réponse vide est renvoyée.
Vérifier l’authentification
Permet de vérifier si l’authentification fonctionne.
Obtenir des organisations utilisateur
Obtenir toutes les organisations dont un utilisateur donné fait partie.
Obtenir des projets utilisateur
Obtenir des projets pour l’utilisateur actuel.
Obtenir des projets utilisateur paginés
Obtenir des projets paginés pour l’utilisateur actuel.
Obtenir des balises utilisateur
Retourne des balises pour l’utilisateur actuel.
Obtenir des tâches utilisateur
Retourne les tâches des projets dans lesquels l’utilisateur participe.
Obtenir des rappels de suivi
Retourne une liste de rappels de suivi.
Obtenir le minuteur web
Obtenir la configuration du minuteur web.
Obtenir des espaces de travail utilisateur
Répertorie les espaces de travail pour un utilisateur donné.
Obtenir les entrées de temps
Répertorie les dernières entrées d’heure.
Obtenir l’entrée d’heure actuelle
Chargez l’entrée de temps d’exécution pour l’ID utilisateur.
Obtenir l’entrée d’heure par ID
Entrée de temps de chargement par ID accessible par l’utilisateur actuel.
Obtenir des utilisateurs de l’espace de travail (au niveau de l’organisation)
Retourne tous les utilisateurs qui appartiennent directement à l’espace de travail ou via au moins un groupe.
Obtenir des utilisateurs de l’espace de travail
Répertorier tous les utilisateurs d’un espace de travail donné.
Obtenir les utilisateurs du projet d’espace de travail
Répertorier tous les utilisateurs de projets pour un espace de travail donné.
Obtenir des clients utilisateur
Obtenir des clients pour l’utilisateur actuel.
Obtenir des organisations utilisateur
Obtenir toutes les organisations dont un utilisateur donné fait partie.
Obtenir des utilisateurs de l’espace de travail (au niveau de l’organisation)
Retourne tous les utilisateurs qui appartiennent directement à l’espace de travail ou via au moins un groupe.
Obtenir des projets utilisateur
Obtenir des projets pour l’utilisateur actuel.
Obtenir des projets utilisateur paginés
Obtenir des projets paginés pour l’utilisateur actuel.
Obtenir les utilisateurs du projet d’espace de travail
Répertorier tous les utilisateurs de projets pour un espace de travail donné.
Obtenir des projets d’espace de travail
Obtenir des projets pour un espace de travail donné.
Obtenir le projet d’espace de travail
Obtenir le projet pour un espace de travail donné.
Obtenir des balises utilisateur
Retourne des balises pour l’utilisateur actuel.
Obtenir des tâches utilisateur
Retourne les tâches des projets dans lesquels l’utilisateur participe.
Obtenir des espaces de travail utilisateur
Répertorie les espaces de travail pour un utilisateur donné.
Créer une entrée de temps
Crée une entrée de temps d’espace de travail.
Supprimer l’entrée de temps
Supprime une entrée de temps d’espace de travail.
Entrée de l’heure de mise à jour
Met à jour une entrée de temps d’espace de travail.
Entrées de temps de modification en bloc
Entrées de temps de modification en bloc. Le correctif est exécuté partiellement lorsqu’il existe des erreurs avec certains enregistrements. Aucune transaction, aucune restauration.
Entrée d’heure d’arrêt
Arrête une entrée de temps d’espace de travail.
Obtenir des utilisateurs de l’espace de travail (au niveau de l’organisation)
Retourne tous les utilisateurs qui appartiennent directement à l’espace de travail ou via au moins un groupe.
Obtenir un espace de travail unique
Obtenez des informations sur un espace de travail unique.
Obtenir la liste des tarifs
Obtenir les tarifs par niveau (espace de travail|projet|tâche|utilisateur).
Obtenir des statistiques d’espace de travail
Retourne la liste des administrateurs de l’espace de travail, le nombre de membres et le nombre de groupes.
Obtenir les contraintes d’entrée de temps de l’espace de travail
Obtenez les contraintes d’entrée de temps pour un espace de travail donné.
Obtenir des rappels de suivi de l’espace de travail
Retourne une liste de rappels de suivi.
Obtenir des utilisateurs de l’espace de travail
Répertorier tous les utilisateurs d’un espace de travail donné.
Obtenir les utilisateurs du projet d’espace de travail
Répertorier tous les utilisateurs de projets pour un espace de travail donné.
Obtenir des projets d’espace de travail
Obtenir des projets pour un espace de travail donné.
Obtenir le projet d’espace de travail
Obtenir le projet pour un espace de travail donné.
Obtenir les entrées de temps
Répertorie les dernières entrées d’heure.
Obtenir l’entrée d’heure actuelle
Chargez l’entrée de temps d’exécution pour l’ID utilisateur.
Obtenir l’entrée d’heure par ID
Entrée de temps de chargement par ID accessible par l’utilisateur actuel.
Lorsqu’une entrée de temps est créée
Se déclenche lorsqu’une nouvelle entrée de temps est créée dans l’espace de travail.
Lorsqu’une entrée de temps est mise à jour
Se déclenche lorsqu’une entrée de temps existante est modifiée dans l’espace de travail.
Lorsqu’une entrée de temps est supprimée
Se déclenche lorsqu’une entrée de temps est supprimée de l’espace de travail.
Quand une entrée de temps est démarrée
Se déclenche lorsqu’une entrée de temps est démarrée (le minuteur commence) dans l’espace de travail.
Lorsqu’une entrée de temps est arrêtée
Se déclenche lorsqu’une entrée de temps d’exécution est arrêtée dans l’espace de travail.
Problèmes connus et limitations
Il n’y a pas de problèmes connus pour l’instant.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Impossible à partager |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Ce n’est pas une connexion partageable. Si l’application Power est partagée avec un autre utilisateur, un autre utilisateur sera invité à créer explicitement une nouvelle connexion.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Nom d’utilisateur | securestring | Nom d’utilisateur de cette API | Vrai |
| Mot de passe | securestring | Mot de passe de cette API | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Créer une entrée de temps |
Crée un espace de travail TimeEntry. |
| Entrée de l’heure de mise à jour |
Met à jour une entrée de temps d’espace de travail. |
| Entrée d’heure d’arrêt |
Arrête une entrée de temps d’espace de travail. |
| Entrées de temps de modification en bloc |
Entrées de temps de modification en bloc. Le correctif est exécuté partiellement lorsqu’il existe des erreurs avec certains enregistrements. Aucune transaction, aucune restauration. |
| Mettre à jour l’utilisateur actuel |
Met à jour les détails de l’utilisateur actuel. |
| Obtenir des balises utilisateur |
Retourne des balises pour l’utilisateur actuel. |
| Obtenir des clients utilisateur |
Obtenir des clients pour l’utilisateur actuel. |
| Obtenir des espaces de travail utilisateur |
Répertorie les espaces de travail pour un utilisateur donné. |
| Obtenir des organisations utilisateur |
Obtenir toutes les organisations dont un utilisateur donné fait partie. |
| Obtenir des projets d’espace de travail |
Obtenir des projets pour un espace de travail donné. |
| Obtenir des projets utilisateur |
Obtenir des projets pour l’utilisateur actuel. |
| Obtenir des projets utilisateur paginés |
Obtenir des projets paginés pour l’utilisateur actuel. |
| Obtenir des rappels de suivi |
Retourne une liste de rappels de suivi. |
| Obtenir des rappels de suivi de l’espace de travail |
Retourne une liste de rappels de suivi. |
| Obtenir des statistiques d’espace de travail |
Retourne la liste des administrateurs de l’espace de travail, le nombre de membres et le nombre de groupes. |
| Obtenir des tâches utilisateur |
Retourne les tâches des projets dans lesquels l’utilisateur participe. |
| Obtenir des utilisateurs de l’espace de travail |
Répertorier tous les utilisateurs d’un espace de travail donné. |
| Obtenir des utilisateurs de l’espace de travail (au niveau de l’organisation) |
Retourne tous les utilisateurs qui appartiennent directement à l’espace de travail ou via au moins un groupe. |
| Obtenir la liste des tarifs |
Obtenir les tarifs par niveau (espace de travail|projet|tâche|utilisateur). |
| Obtenir le minuteur web |
Obtenir la configuration du minuteur web. |
| Obtenir le projet d’espace de travail |
Obtenir le projet pour un espace de travail donné. |
| Obtenir les contraintes d’entrée de temps de l’espace de travail |
Obtenez les contraintes d’entrée de temps pour un espace de travail donné. |
| Obtenir les entrées de temps |
Répertorie les dernières entrées d’heure. |
| Obtenir les fonctionnalités utilisateur |
Obtenir les fonctionnalités disponibles pour l’utilisateur actuel. |
| Obtenir les utilisateurs du projet d’espace de travail |
Répertorier tous les utilisateurs de projets pour un espace de travail donné. |
| Obtenir l’emplacement de l’utilisateur |
Retourne l’emplacement IP du client. Si aucune donnée n’est présente, la réponse vide est renvoyée. |
| Obtenir l’entrée d’heure actuelle |
Chargez l’entrée de temps d’exécution pour l’ID utilisateur. |
| Obtenir l’entrée d’heure par ID |
Entrée de temps de chargement par ID accessible par l’utilisateur actuel. |
| Obtenir l’utilisateur actuel |
Retourne les détails de l’utilisateur actuel. |
| Obtenir un espace de travail unique |
Obtenez des informations sur un espace de travail unique. |
| Supprimer l’entrée de temps |
Supprime une entrée de temps d’espace de travail. |
| Vérifier l’authentification |
Permet de vérifier si l’authentification fonctionne. |
Créer une entrée de temps
Crée un espace de travail TimeEntry.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
Inclure des métadonnées
|
meta | boolean |
La réponse doit-elle contenir des données pour les méta-entités. |
|
|
Facturable
|
billable | boolean |
Indique si l’entrée de temps est marquée comme facturable, facultative, false par défaut. |
|
|
Créé avec
|
created_with | string |
Doit être fourni lors de la création d’une entrée de temps et doit identifier le service/l’application utilisé pour le créer. |
|
|
Descriptif
|
description | string |
Description de l’entrée de temps, facultative. |
|
|
Durée
|
duration | integer |
Durée de l’entrée de temps. Pour les entrées en cours d’exécution, il est préférable de -1. |
|
|
Durée uniquement
|
duronly | boolean |
Déconseillé : utilisé pour créer une entrée de temps avec une durée, mais sans temps d’arrêt. Ce paramètre peut être ignoré. |
|
|
Fonctionnalité d’origine
|
origin_feature | string |
Nom de la fonctionnalité d’origine. |
|
|
Nombre d’objectifs visibles
|
visible_goals_count | integer |
Nombre d’objectifs visibles. |
|
|
ID de dépenses
|
expense_ids | array of integer |
Dépenses de travail associées à l’entrée de temps. |
|
|
ID de projet (hérité)
|
pid | integer |
ID de projet, champ hérité. |
|
|
ID Projet
|
project_id | integer |
ID de projet, facultatif. |
|
|
Partagé avec des ID d’utilisateur
|
shared_with_user_ids | array of integer |
Liste des ID d’utilisateur à partager cette entrée de temps avec. |
|
|
Heure de début
|
start | string |
Heure de début au format UTC requise pour la création. Format : 2006-01-02T15:04:05Z. |
|
|
Date de début
|
start_date | string |
Si elle est fournie lors de la création, la partie date est prioritaire sur la partie date de « début ». Format : 2006-11-07. |
|
|
Heure d’arrêt
|
stop | string |
L’heure d’arrêt au format UTC peut être omise si elle est toujours en cours d’exécution ou créée avec « duration ». Si 'stop' et 'duration' sont fournis, les valeurs doivent être cohérentes (start + duration == stop). |
|
|
Action de balise
|
tag_action | string |
Peut être « ajouter » ou « supprimer ». Utilisé lors de la mise à jour d’une entrée de temps existante. |
|
|
ID de balise
|
tag_ids | array of integer |
ID d’étiquettes à ajouter/supprimer. |
|
|
Étiquettes
|
tags | array of string |
Noms des balises à ajouter/supprimer. Si le nom n’existe pas en tant que balise, un nom est créé automatiquement. |
|
|
ID de tâche
|
task_id | integer |
ID de tâche, facultatif. |
|
|
ID de tâche (hérité)
|
tid | integer |
ID de tâche, champ hérité. |
|
|
ID utilisateur (hérité)
|
uid | integer |
ID du créateur d’entrée de temps, champ hérité. |
|
|
ID d’utilisateur
|
user_id | integer |
L’ID du créateur d’entrée de temps, s’il est omis, utilise l’ID utilisateur du demandeur. |
|
|
ID d’espace de travail (hérité)
|
wid | integer |
ID de l’espace de travail, champ hérité. |
|
|
ID de l’espace de travail
|
workspace_id | integer |
ID de l’espace de travail requis. |
Retours
- Corps
- TimeEntry
Entrée de l’heure de mise à jour
Met à jour une entrée de temps d’espace de travail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
ID d’entrée de temps
|
time_entry_id | True | integer |
ID TimeEntry. |
|
Inclure des métadonnées
|
meta | boolean |
La réponse doit-elle contenir des données pour les méta-entités. |
|
|
Inclure le partage
|
include_sharing | boolean |
Incluez les détails du partage dans la réponse. |
|
|
Facturable
|
billable | boolean |
Indique si l’entrée de temps est marquée comme facturable, facultative, false par défaut. |
|
|
Créé avec
|
created_with | string |
Doit être fourni lors de la création d’une entrée de temps et doit identifier le service/l’application utilisé pour le créer. |
|
|
Descriptif
|
description | string |
Description de l’entrée de temps, facultative. |
|
|
Durée
|
duration | integer |
Durée de l’entrée de temps. Pour les entrées en cours d’exécution, il est préférable de -1. |
|
|
Durée uniquement
|
duronly | boolean |
Déconseillé : utilisé pour créer une entrée de temps avec une durée, mais sans temps d’arrêt. Ce paramètre peut être ignoré. |
|
|
Fonctionnalité d’origine
|
origin_feature | string |
Nom de la fonctionnalité d’origine. |
|
|
Nombre d’objectifs visibles
|
visible_goals_count | integer |
Nombre d’objectifs visibles. |
|
|
ID de dépenses
|
expense_ids | array of integer |
Dépenses de travail associées à l’entrée de temps. |
|
|
ID de projet (hérité)
|
pid | integer |
ID de projet, champ hérité. |
|
|
ID Projet
|
project_id | integer |
ID de projet, facultatif. |
|
|
Partagé avec des ID d’utilisateur
|
shared_with_user_ids | array of integer |
Liste des ID d’utilisateur à partager cette entrée de temps avec. |
|
|
Heure de début
|
start | string |
Heure de début au format UTC requise pour la création. Format : 2006-01-02T15:04:05Z. |
|
|
Date de début
|
start_date | string |
Si elle est fournie lors de la création, la partie date est prioritaire sur la partie date de « début ». Format : 2006-11-07. |
|
|
Heure d’arrêt
|
stop | string |
L’heure d’arrêt au format UTC peut être omise si elle est toujours en cours d’exécution ou créée avec « duration ». Si 'stop' et 'duration' sont fournis, les valeurs doivent être cohérentes (start + duration == stop). |
|
|
Action de balise
|
tag_action | string |
Peut être « ajouter » ou « supprimer ». Utilisé lors de la mise à jour d’une entrée de temps existante. |
|
|
ID de balise
|
tag_ids | array of integer |
ID d’étiquettes à ajouter/supprimer. |
|
|
Étiquettes
|
tags | array of string |
Noms des balises à ajouter/supprimer. Si le nom n’existe pas en tant que balise, un nom est créé automatiquement. |
|
|
ID de tâche
|
task_id | integer |
ID de tâche, facultatif. |
|
|
ID de tâche (hérité)
|
tid | integer |
ID de tâche, champ hérité. |
|
|
ID utilisateur (hérité)
|
uid | integer |
ID du créateur d’entrée de temps, champ hérité. |
|
|
ID d’utilisateur
|
user_id | integer |
L’ID du créateur d’entrée de temps, s’il est omis, utilise l’ID utilisateur du demandeur. |
|
|
ID d’espace de travail (hérité)
|
wid | integer |
ID de l’espace de travail, champ hérité. |
|
|
ID de l’espace de travail
|
workspace_id | integer |
ID de l’espace de travail requis. |
Retours
- Corps
- TimeEntry
Entrée d’heure d’arrêt
Arrête une entrée de temps d’espace de travail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
ID d’entrée de temps
|
time_entry_id | True | integer |
ID TimeEntry. |
Retours
- Corps
- TimeEntry
Entrées de temps de modification en bloc
Entrées de temps de modification en bloc. Le correctif est exécuté partiellement lorsqu’il existe des erreurs avec certains enregistrements. Aucune transaction, aucune restauration.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
ID d’entrée de temps
|
time_entry_ids | True | string |
ID numériques de time_entries, séparés par des virgules. Par exemple : 204301830,202700150,202687559. La limite est de 100 ID par requête. |
|
Inclure des métadonnées
|
meta | boolean |
La réponse doit-elle contenir des données pour les méta-entités. |
|
|
Opération
|
op | True | string |
Opération (ajouter/supprimer/remplacer). |
|
Chemin
|
path | True | string |
Chemin d’accès à l’entité à corriger (par exemple, /description). |
|
Valeur
|
value | object |
Nouvelle valeur de l’entité dans le chemin d’accès. |
Retours
- Corps
- BulkEditResponse
Mettre à jour l’utilisateur actuel
Met à jour les détails de l’utilisateur actuel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Début de la semaine
|
beginning_of_week | integer |
Premier jour de la semaine de l’utilisateur. Dimanche : 0, lundi : 1, etc. |
|
|
ID de pays
|
country_id | integer |
ID de pays de l’utilisateur. |
|
|
Mot de passe actuel
|
current_password | string |
Mot de passe actuel de l’utilisateur (utilisé pour modifier le mot de passe actuel). |
|
|
ID d’espace de travail par défaut
|
default_workspace_id | integer |
ID d’espace de travail par défaut de l’utilisateur. |
|
|
Messagerie électronique
|
string |
Adresse e-mail de l’utilisateur. |
||
|
Nom complet
|
fullname | string |
Nom complet de l’utilisateur. |
|
|
Nouveau mot de passe
|
password | string |
Le nouveau mot de passe de l’utilisateur (actuel doit également être fourni). |
|
|
Timezone
|
timezone | string |
Fuseau horaire de l’utilisateur. |
Retours
- Corps
- UserBasicResponse
Obtenir des balises utilisateur
Retourne des balises pour l’utilisateur actuel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Date depuis
|
since | integer |
Récupérez les éléments créés/modifiés/supprimés depuis cette date à l’aide de l’horodatage UNIX. |
Retours
- response
- array of Tag
Obtenir des clients utilisateur
Obtenir des clients pour l’utilisateur actuel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Date depuis
|
since | integer |
Récupérez les éléments créés/modifiés/supprimés depuis cette date à l’aide de l’horodatage UNIX. |
Retours
- response
- array of Client
Obtenir des espaces de travail utilisateur
Répertorie les espaces de travail pour un utilisateur donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Date depuis
|
since | integer |
Récupérez les éléments créés/modifiés/supprimés depuis cette date à l’aide de l’horodatage UNIX. |
Retours
- response
- array of Workspace
Obtenir des organisations utilisateur
Obtenir toutes les organisations dont un utilisateur donné fait partie.
Retours
- response
- array of Organization
Obtenir des projets d’espace de travail
Obtenir des projets pour un espace de travail donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
Trier épinglé
|
sort_pinned | True | boolean |
Placez les projets épinglés en haut de la réponse. |
|
Utilisateurs actifs uniquement
|
active | boolean |
Retourne uniquement les utilisateurs actifs. |
|
|
Date depuis
|
since | integer |
Récupérez les éléments créés/modifiés/supprimés depuis cette date à l’aide de l’horodatage UNIX. |
|
|
Facturable
|
billable | boolean |
Filtrez par état facturable. |
|
|
ID d’utilisateur
|
user_ids | array |
ID utilisateur à filtrer. |
|
|
ID client
|
client_ids | array |
ID client à filtrer. |
|
|
ID de groupe
|
group_ids | array |
ID de groupe à filtrer. |
|
|
ID de projet
|
project_ids | string |
ID numériques des projets, séparés par des virgules. |
|
|
Statuts
|
statuses | array |
État du projet à filtrer. |
|
|
Filtre de noms
|
name | string |
Nom d’utilisateur de l’espace de travail à filtrer. |
|
|
Numéro de page
|
page | integer |
Numéro de page. |
|
|
Trier le champ
|
sort_field | True | string |
Champ par lequel trier. |
|
Ordre de tri
|
sort_order | True | string |
Ordre de tri (asc/desc). |
|
Modèles uniquement
|
only_templates | True | boolean |
Retournez uniquement des modèles de projet. |
|
Mes projets uniquement
|
only_me | boolean |
Obtenez uniquement les projets affectés à l’utilisateur actuel. |
|
|
Éléments par page
|
per_page | integer |
Nombre d’éléments par page, par défaut 201. |
Retours
- response
- array of Project
Obtenir des projets utilisateur
Obtenir des projets pour l’utilisateur actuel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Inclure archivé
|
include_archived | string |
Inclure des projets archivés. |
|
|
Date depuis
|
since | integer |
Récupérez les éléments créés/modifiés/supprimés depuis cette date à l’aide de l’horodatage UNIX. |
Retours
- response
- array of Project
Obtenir des projets utilisateur paginés
Obtenir des projets paginés pour l’utilisateur actuel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Démarrer l’ID de projet
|
start_project_id | integer |
ID de projet à partir duquel reprendre la pagination suivante. |
|
|
Date depuis
|
since | integer |
Récupérez les éléments créés/modifiés/supprimés depuis cette date à l’aide de l’horodatage UNIX. |
|
|
Éléments par page
|
per_page | integer |
Nombre d’éléments par page, par défaut 201. |
Retours
- response
- array of Project
Obtenir des rappels de suivi
Obtenir des rappels de suivi de l’espace de travail
Retourne une liste de rappels de suivi.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
Retours
- Corps
- TrackRemindersResponse
Obtenir des statistiques d’espace de travail
Retourne la liste des administrateurs de l’espace de travail, le nombre de membres et le nombre de groupes.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
Retours
- Corps
- WorkspaceStatistics
Obtenir des tâches utilisateur
Retourne les tâches des projets dans lesquels l’utilisateur participe.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Inclure des métadonnées
|
meta | boolean |
La réponse doit-elle contenir des données pour les méta-entités. |
|
|
Date depuis
|
since | integer |
Récupérez les éléments créés/modifiés/supprimés depuis cette date à l’aide de l’horodatage UNIX. |
|
|
Inclure des tâches inactives
|
include_not_active | string |
Incluez les tâches marquées comme terminées. |
|
|
Décalage de pagination
|
offset | integer |
Décalage à partir duquel reprendre la pagination suivante. |
|
|
Éléments par page
|
per_page | integer |
Nombre d’éléments par page, par défaut 201. |
Retours
- response
- array of Task
Obtenir des utilisateurs de l’espace de travail
Répertorier tous les utilisateurs d’un espace de travail donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
Exclure la suppression
|
exclude_deleted | boolean |
Excluez les enregistrements supprimés dans la réponse. |
Retours
- response
- array of WorkspaceUserSimple
Obtenir des utilisateurs de l’espace de travail (au niveau de l’organisation)
Retourne tous les utilisateurs qui appartiennent directement à l’espace de travail ou via au moins un groupe.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’organisation
|
organization_id | True | integer |
ID numérique de l’organisation. |
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
Numéro de page
|
page | integer |
Numéro de page. |
|
|
Éléments par page
|
per_page | integer |
Nombre d’éléments par page, par défaut 201. |
|
|
Filtre de taux personnalisés
|
custom_rates | boolean |
Retourne uniquement les utilisateurs avec ou sans tarif horaire personnalisé respectivement. |
|
|
Utilisateurs actifs uniquement
|
active | boolean |
Retourne uniquement les utilisateurs actifs. |
|
|
Filtre de noms
|
name | string |
Nom d’utilisateur de l’espace de travail à filtrer. |
|
|
Filtre de recherche
|
search | string |
Filtrez l’espace de travail par nom ou par e-mail. |
Retours
- response
- array of WorkspaceUser
Obtenir la liste des tarifs
Obtenir les tarifs par niveau (espace de travail|projet|tâche|utilisateur).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
Level
|
level | True | string |
Niveau des tarifs : espace de travail, projet, tâche ou utilisateur. |
|
ID de niveau
|
level_id | True | integer |
ID numérique du niveau d’entité. |
|
Type de taux
|
type | string |
Type de valeurs de taux à retourner : billable_rates ou labor_costs. La valeur par défaut est billable_rates. |
Retours
- response
- array of Rate
Obtenir le minuteur web
Obtenir la configuration du minuteur web.
Obtenir le projet d’espace de travail
Obtenir le projet pour un espace de travail donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
ID Projet
|
project_id | True | integer |
ID numérique du projet. |
Retours
- Corps
- Project
Obtenir les contraintes d’entrée de temps de l’espace de travail
Obtenez les contraintes d’entrée de temps pour un espace de travail donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
Retours
- Corps
- TimeEntryConstraints
Obtenir les entrées de temps
Répertorie les dernières entrées d’heure.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Inclure des métadonnées
|
meta | boolean |
La réponse doit-elle contenir des données pour les méta-entités. |
|
|
Inclure le partage
|
include_sharing | boolean |
Incluez les détails du partage dans la réponse. |
|
|
Date depuis
|
since | integer |
Récupérez les éléments créés/modifiés/supprimés depuis cette date à l’aide de l’horodatage UNIX. |
|
|
Avant la date
|
before | string |
Obtenez les entrées avec l’heure de début, avant la date donnée (AAAA-MM-DD) ou avec l’heure au format RFC3339. |
|
|
Date de début
|
start_date | string |
Obtenez des entrées avec l’heure de début, à partir de start_date AAAA-MM-DD ou avec l’heure au format RFC3339. À utiliser avec end_date. |
|
|
Date de fin
|
end_date | string |
Obtenez les entrées avec l’heure de début, jusqu’à end_date AAAA-MM-DD ou avec l’heure au format RFC3339. À utiliser avec start_date. |
Retours
- response
- array of TimeEntry
Obtenir les fonctionnalités utilisateur
Obtenir les fonctionnalités disponibles pour l’utilisateur actuel.
Retours
- response
- array of WorkspaceFeatures
Obtenir les utilisateurs du projet d’espace de travail
Répertorier tous les utilisateurs de projets pour un espace de travail donné.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
ID de projet
|
project_ids | string |
ID numériques des projets, séparés par des virgules. |
|
|
ID d’utilisateur
|
user_id | string |
ID numérique de l’utilisateur, s’il est passé, retourne uniquement les utilisateurs de projet pour les projets de cet utilisateur. |
|
|
Inclure les membres du groupe
|
with_group_members | boolean |
Incluez les membres du groupe. |
Retours
- response
- array of ProjectUser
Obtenir l’emplacement de l’utilisateur
Retourne l’emplacement IP du client. Si aucune donnée n’est présente, la réponse vide est renvoyée.
Retours
- Corps
- LocationResponse
Obtenir l’entrée d’heure actuelle
Obtenir l’entrée d’heure par ID
Entrée de temps de chargement par ID accessible par l’utilisateur actuel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’entrée de temps
|
time_entry_id | True | integer |
ID TimeEntry. |
|
Inclure des métadonnées
|
meta | boolean |
La réponse doit-elle contenir des données pour les méta-entités. |
|
|
Inclure le partage
|
include_sharing | boolean |
Incluez les détails du partage dans la réponse. |
Retours
- Corps
- TimeEntry
Obtenir l’utilisateur actuel
Retourne les détails de l’utilisateur actuel.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Inclure des données associées
|
with_related_data | boolean |
Récupérez les données associées à l’utilisateur (clients, projets, tâches, balises, espaces de travail, entrées de temps, etc.). |
Retours
- Corps
- UserResponse
Obtenir un espace de travail unique
Obtenez des informations sur un espace de travail unique.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
Retours
- Corps
- Workspace
Supprimer l’entrée de temps
Supprime une entrée de temps d’espace de travail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
ID d’entrée de temps
|
time_entry_id | True | integer |
ID TimeEntry. |
Vérifier l’authentification
Permet de vérifier si l’authentification fonctionne.
Déclencheurs
| Lorsqu’une entrée de temps est arrêtée |
Se déclenche lorsqu’une entrée de temps d’exécution est arrêtée dans l’espace de travail. |
| Lorsqu’une entrée de temps est créée |
Se déclenche lorsqu’une nouvelle entrée de temps est créée dans l’espace de travail. |
| Lorsqu’une entrée de temps est mise à jour |
Se déclenche lorsqu’une entrée de temps existante est modifiée dans l’espace de travail. |
| Lorsqu’une entrée de temps est supprimée |
Se déclenche lorsqu’une entrée de temps est supprimée de l’espace de travail. |
| Quand une entrée de temps est démarrée |
Se déclenche lorsqu’une entrée de temps est démarrée (le minuteur commence) dans l’espace de travail. |
Lorsqu’une entrée de temps est arrêtée
Se déclenche lorsqu’une entrée de temps d’exécution est arrêtée dans l’espace de travail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
Entité
|
entity | string |
Toggl Track business entity to filter. |
|
|
Action
|
action | string |
Type de modification appliqué à l’entité. |
Retours
- Corps
- TimeEntryWebhookEvent
Lorsqu’une entrée de temps est créée
Se déclenche lorsqu’une nouvelle entrée de temps est créée dans l’espace de travail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
Entité
|
entity | string |
Toggl Track business entity to filter. |
|
|
Action
|
action | string |
Type de modification appliqué à l’entité. |
Retours
- Corps
- TimeEntryWebhookEvent
Lorsqu’une entrée de temps est mise à jour
Se déclenche lorsqu’une entrée de temps existante est modifiée dans l’espace de travail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
Entité
|
entity | string |
Toggl Track business entity to filter. |
|
|
Action
|
action | string |
Type de modification appliqué à l’entité. |
Retours
- Corps
- TimeEntryWebhookEvent
Lorsqu’une entrée de temps est supprimée
Se déclenche lorsqu’une entrée de temps est supprimée de l’espace de travail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
Entité
|
entity | string |
Toggl Track business entity to filter. |
|
|
Action
|
action | string |
Type de modification appliqué à l’entité. |
Retours
- Corps
- TimeEntryWebhookEvent
Quand une entrée de temps est démarrée
Se déclenche lorsqu’une entrée de temps est démarrée (le minuteur commence) dans l’espace de travail.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID de l’espace de travail
|
workspace_id | True | integer |
ID numérique de l’espace de travail. |
|
Entité
|
entity | string |
Toggl Track business entity to filter. |
|
|
Action
|
action | string |
Type de modification appliqué à l’entité. |
Retours
- Corps
- TimeEntryWebhookEvent
Définitions
UserResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
2FA activée
|
2fa_enabled | boolean |
État activé de l’authentification à deux facteurs. |
|
Jeton d'API
|
api_token | string |
Le jeton d’API est omis s’il est vide. |
|
Dernière mise à jour
|
at | string |
Horodatage de la dernière mise à jour. |
|
Autorisation mise à jour
|
authorization_updated_at | string |
Horodatage de la dernière mise à jour de l’objet de session utilisateur d’autorisation. |
|
Début de la semaine
|
beginning_of_week | integer |
Premier jour de la semaine de l’utilisateur (0=dimanche, 1=lundi, etc.). |
|
Clients
|
clients | array of Client |
Clients, null si with_related_data n’a pas été défini sur true. |
|
ID de pays
|
country_id | integer |
ID de pays de l’utilisateur. |
|
Créé à
|
created_at | string |
Horodatage de création d’utilisateur. |
|
ID d’espace de travail par défaut
|
default_workspace_id | integer |
ID d’espace de travail par défaut de l’utilisateur. |
|
Messagerie électronique
|
string |
Adresse e-mail de l’utilisateur. |
|
|
Nom complet
|
fullname | string |
Nom complet de l’utilisateur. |
|
Possède un mot de passe
|
has_password | boolean |
Indique si l’utilisateur a un jeu de mots de passe. |
|
ID d’utilisateur
|
id | integer |
Identifiant utilisateur. |
|
URL de l’image
|
image_url | string |
URL de l’image de profil de l’utilisateur. |
|
Hachage d’intercom
|
intercom_hash | string |
Le hachage d’intercom est omis s’il est vide. |
|
Fournisseurs OAuth
|
oauth_providers | array of string |
Fournisseurs OAuth disponibles pour l’utilisateur. |
|
E-mail OpenID
|
openid_email | string |
Adresse e-mail OpenID. |
|
OpenID activé
|
openid_enabled | boolean |
État de l’authentification OpenID activée. |
|
Options
|
options | object |
Les options utilisateur sont omises si elles sont vides. |
|
Projets
|
projects | array of Project |
Projets, null si with_related_data n’a pas été défini sur true. |
|
Étiquettes
|
tags | array of Tag |
Balises, null si with_related_data n’a pas été définie sur true. |
|
Tasks
|
tasks | array of Task |
Tâches, null si with_related_data n’a pas été définie sur true. |
|
Entrées temporelles
|
time_entries | array of TimeEntry |
Entrées de temps, null si with_related_data n’a pas été définie sur true. |
|
Timezone
|
timezone | string |
Fuseau horaire de l’utilisateur. |
|
Mise à jour à
|
updated_at | string |
Horodatage de la dernière mise à jour de l’utilisateur. |
|
Espaces de travail
|
workspaces | array of Workspace |
Espaces de travail, null si with_related_data n’a pas été défini sur true. |
UserBasicResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
2FA activée
|
2fa_enabled | boolean |
État activé de l’authentification à deux facteurs. |
|
Jeton d'API
|
api_token | string |
Le jeton d’API est omis s’il est vide. |
|
Dernière mise à jour
|
at | string |
Horodatage de la dernière mise à jour. |
|
Début de la semaine
|
beginning_of_week | integer |
Premier jour de la semaine de l’utilisateur. |
|
ID de pays
|
country_id | integer |
ID de pays de l’utilisateur. |
|
Créé à
|
created_at | string |
Horodatage de création d’utilisateur. |
|
ID d’espace de travail par défaut
|
default_workspace_id | integer |
ID d’espace de travail par défaut de l’utilisateur. |
|
Messagerie électronique
|
string |
Adresse e-mail de l’utilisateur. |
|
|
Nom complet
|
fullname | string |
Nom complet de l’utilisateur. |
|
Possède un mot de passe
|
has_password | boolean |
Indique si l’utilisateur a un jeu de mots de passe. |
|
ID d’utilisateur
|
id | integer |
Identifiant utilisateur. |
|
URL de l’image
|
image_url | string |
URL de l’image de profil de l’utilisateur. |
|
E-mail OpenID
|
openid_email | string |
Adresse e-mail OpenID. |
|
OpenID activé
|
openid_enabled | boolean |
État de l’authentification OpenID activée. |
|
Options
|
options | object |
Les options utilisateur sont omises si elles sont vides. |
|
Timezone
|
timezone | string |
Fuseau horaire de l’utilisateur. |
|
Mise à jour à
|
updated_at | string |
Horodatage de la dernière mise à jour de l’utilisateur. |
Client
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Archivés
|
archived | boolean |
Est true si le client est archivé. |
|
Dernière mise à jour
|
at | string |
Date de la dernière mise à jour. |
|
ID de créateur
|
creator_id | integer |
ID de l’utilisateur qui a créé le client. |
|
Référence externe
|
external_reference | string |
Référence externe à l’entité Track Client. |
|
ID de client
|
id | integer |
ID client. |
|
ID externe d’intégration
|
integration_ext_id | string |
ID externe de l’entité liée dans le système externe. |
|
Type externe d’intégration
|
integration_ext_type | string |
Type externe de l’entité liée dans le système externe. |
|
Fournisseur d’intégration
|
integration_provider | object |
Fournisseur disposant d’une entité liée à cette entité Toggl Track. |
|
Nom du client
|
name | string |
Nom du client. |
|
Remarques
|
notes | string |
Notes du client. |
|
Permissions
|
permissions | array of string |
Liste des autorisations d’autorisation pour ce client. |
|
Nombre total
|
total_count | integer |
Champ total pour stocker le nombre total. |
|
ID de l’espace de travail
|
wid | integer |
ID de l’espace de travail. |
Projet
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Active
|
active | boolean |
Indique si le projet est actif ou archivé. |
|
Heures réelles
|
actual_hours | integer |
Heures réelles consacrées au projet. |
|
Secondes réelles
|
actual_seconds | integer |
Secondes réelles passées sur le projet. |
|
Dernière mise à jour
|
at | string |
Date de la dernière mise à jour. |
|
Estimations automatiques
|
auto_estimates | boolean |
Estimations automatiques activées. |
|
Facturable
|
billable | boolean |
Indique si le projet est facturable. |
|
Peut suivre le temps
|
can_track_time | boolean |
Indique si le temps peut être suivi de ce projet. |
|
ID client (hérité)
|
cid | integer |
Champ hérité de l’ID client. |
|
ID de client
|
client_id | integer |
ID client. |
|
Nom du client
|
client_name | string |
Nom du client. |
|
Color
|
color | string |
Couleur du projet. |
|
Créé à
|
created_at | string |
Date de création. |
|
Monnaie
|
currency | string |
Devise du projet. |
|
Période actuelle
|
current_period | object |
Période de projet actuelle, fonctionnalité Premium. |
|
Date de fin
|
end_date | string |
Date de fin du projet. |
|
Heures estimées
|
estimated_hours | integer |
Heures estimées pour le projet. |
|
Secondes estimées
|
estimated_seconds | integer |
Secondes estimées pour le projet. |
|
Référence externe
|
external_reference | string |
Référence externe à l’entité suivre le projet. |
|
Frais fixes
|
fixed_fee | double |
Frais fixes, fonctionnalité Premium. |
|
ID Projet
|
id | integer |
ID de projet. |
|
ID externe d’intégration
|
integration_ext_id | string |
ID externe de l’entité liée dans le système externe. |
|
Type externe d’intégration
|
integration_ext_type | string |
Type externe de l’entité liée dans le système externe. |
|
Fournisseur d’intégration
|
integration_provider | object |
Fournisseur disposant d’une entité liée à cette entité Toggl Track. |
|
Est privé
|
is_private | boolean |
Indique si le projet est privé. |
|
Nom du projet
|
name | string |
Nom du projet. |
|
Permissions
|
permissions | array of string |
Autorisations de projet. |
|
Épinglé
|
pinned | boolean |
Indique si le projet est épinglé. |
|
Taux horaire
|
rate | double |
Taux horaire pour le projet. |
|
Taux de dernière mise à jour
|
rate_last_updated | string |
Quand le taux a été mis à jour pour la dernière fois. |
|
Recurring
|
recurring | boolean |
Indique si le projet est récurrent, fonctionnalité Premium. |
|
Paramètres récurrents
|
recurring_parameters | array of RecurringParameter |
Paramètres récurrents du projet, fonctionnalité Premium. |
|
Date de début
|
start_date | string |
Date de début du projet. |
|
Statut
|
status | string |
État du projet (à venir, actif, terminé, archivé, supprimé). |
|
Template
|
template | boolean |
Indique si le projet est un modèle. |
|
ID de modèle
|
template_id | integer |
ID de modèle si le projet est basé sur le modèle. |
|
Nombre total
|
total_count | integer |
Nombre total de projets trouvés. |
|
ID d’espace de travail (hérité)
|
wid | integer |
Champ hérité ID de l’espace de travail. |
|
ID de l’espace de travail
|
workspace_id | integer |
ID de l’espace de travail. |
PériodiqueParameter
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Période personnalisée
|
custom_period | integer |
Période personnalisée, utilisée lorsque le champ de période est « personnalisé ». |
|
Secondes estimées
|
estimated_seconds | integer |
Estimation des secondes. |
|
Date de fin du paramètre
|
parameter_end_date | string |
Date de fin du paramètre. |
|
Date de début du paramètre
|
parameter_start_date | string |
Date de début périodique. |
|
Période
|
period | string |
Période périodique. |
|
Date de début du projet
|
project_start_date | string |
Date de début du projet. |
Tag
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Dernière modification
|
at | string |
Lors de la création/de la dernière modification. |
|
ID de créateur
|
creator_id | integer |
ID de l’utilisateur qui a créé la balise. |
|
Supprimé à
|
deleted_at | string |
Quand a été supprimé. |
|
ID de balise
|
id | integer |
ID de balise. |
|
ID externe d’intégration
|
integration_ext_id | string |
ID externe de l’entité liée dans le système externe. |
|
Type externe d’intégration
|
integration_ext_type | string |
Type externe de l’entité liée dans le système externe. |
|
Fournisseur d’intégration
|
integration_provider | object |
Fournisseur disposant d’une entité liée à cette entité Toggl Track. |
|
Nom de la balise
|
name | string |
Nom de la balise. |
|
Permissions
|
permissions | array of string |
Étiqueter les autorisations. |
|
ID de l’espace de travail
|
workspace_id | integer |
ID de l’espace de travail. |
Tâche
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Active
|
active | boolean |
False lorsque la tâche a été effectuée. |
|
Dernière modification
|
at | string |
Lors de la création/de la dernière modification de la tâche. |
|
URL de l’avatar
|
avatar_url | string |
URL de l’avatar. |
|
Nom du client
|
client_name | string |
Nom du client. |
|
Secondes estimées
|
estimated_seconds | integer |
Secondes estimées pour la tâche. |
|
ID de tâche
|
id | integer |
ID de tâche. |
|
ID externe d’intégration
|
integration_ext_id | string |
ID externe de l’entité liée dans le système externe. |
|
Type externe d’intégration
|
integration_ext_type | string |
Type externe de l’entité liée dans le système externe. |
|
Fournisseur d’intégration
|
integration_provider | object |
Fournisseur disposant d’une entité liée à cette entité Toggl Track. |
|
Nom de la tâche
|
name | string |
Nom de la tâche. |
|
Permissions
|
permissions | array of string |
Autorisations de tâche. |
|
Projet facturable
|
project_billable | boolean |
Indique si le projet est facturable. |
|
Couleur du projet
|
project_color | string |
Métadonnées de couleur du projet. |
|
ID Projet
|
project_id | integer |
ID de projet. |
|
Le projet est privé
|
project_is_private | boolean |
Indique si le projet est privé. |
|
Nom du projet
|
project_name | string |
Nom du projet. |
|
Taux
|
rate | double |
Taux pour cette tâche. |
|
Taux de dernière mise à jour
|
rate_last_updated | string |
Quand le taux a été mis à jour pour la dernière fois. |
|
Recurring
|
recurring | boolean |
Indique s’il s’agit d’une tâche périodique. |
|
ID de compte Toggl
|
toggl_accounts_id | string |
ID de compte Toggl. |
|
Secondes suivies
|
tracked_seconds | integer |
La valeur tracked_seconds est en millisecondes, et non en secondes. |
|
ID d’utilisateur
|
user_id | integer |
Identifiant utilisateur. |
|
Nom d'utilisateur
|
user_name | string |
Nom d’utilisateur. |
|
ID de l’espace de travail
|
workspace_id | integer |
ID de l’espace de travail. |
TimeEntry
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Dernière mise à jour
|
at | string |
Une fois la dernière mise à jour, suit le format ISO 8601. |
|
Facturable
|
billable | boolean |
Indique si l’entrée de temps est marquée comme facturable. |
|
Nom du client
|
client_name | string |
Champs méta d’entités associées. |
|
Descriptif
|
description | string |
Description de l’entrée de temps. |
|
Durée
|
duration | integer |
Durée de l’entrée de temps. Pour les entrées en cours d’exécution, il est préférable de -1. |
|
Durée uniquement
|
duronly | boolean |
Permet de créer un TE avec une durée, mais sans temps d’arrêt. |
|
ID de dépenses
|
expense_ids | array of integer |
Frais de travail. |
|
ID d’entrée de temps
|
id | integer |
ID d’entrée de temps. |
|
Permissions
|
permissions | array of string |
Liste d’autorisations. |
|
ID de projet (hérité)
|
pid | integer |
ID de projet, champ hérité. |
|
Projet actif
|
project_active | boolean |
Indique si le projet est actif. |
|
Projet facturable
|
project_billable | boolean |
Indique si le projet est facturable. |
|
Couleur du projet
|
project_color | string |
Couleur du projet. |
|
ID Projet
|
project_id | integer |
ID de projet. |
|
Nom du projet
|
project_name | string |
Nom du projet. |
|
Partagé avec
|
shared_with | array of SharedWith |
Indique avec qui l’entrée de temps a été partagée. |
|
Heure de début
|
start | string |
Heure de début au format UTC. |
|
Heure d’arrêt
|
stop | string |
L’heure d’arrêt au format UTC peut être null si elle est toujours en cours d’exécution. |
|
ID de balise
|
tag_ids | array of integer |
ID de balise, null si les balises n’ont pas été fournies ou ont été supprimées ultérieurement. |
|
Étiquettes
|
tags | array of string |
Noms de balises, Null si les balises n’ont pas été fournies ou ont été supprimées ultérieurement. |
|
ID de tâche
|
task_id | integer |
ID de tâche. |
|
Nom de la tâche
|
task_name | string |
Nom de la tâche. |
|
ID de tâche (hérité)
|
tid | integer |
ID de tâche, champ hérité. |
|
ID utilisateur (hérité)
|
uid | integer |
ID du créateur d’entrée de temps, champ hérité. |
|
URL de l’avatar utilisateur
|
user_avatar_url | string |
URL d’avatar de l’utilisateur. |
|
ID d’utilisateur
|
user_id | integer |
ID du créateur d’entrée de temps. |
|
Nom d'utilisateur
|
user_name | string |
Nom d’utilisateur. |
|
ID d’espace de travail (hérité)
|
wid | integer |
ID de l’espace de travail, champ hérité. |
|
ID de l’espace de travail
|
workspace_id | integer |
ID de l’espace de travail. |
SharedWith
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Accepté
|
accepted | boolean |
Indique si le partage a été accepté. |
|
ID d’utilisateur
|
user_id | integer |
ID d’utilisateur de la personne partagée avec. |
|
Nom d'utilisateur
|
user_name | string |
Nom d’utilisateur de la personne partagée avec. |
Workspace
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nombre de projets actifs
|
active_project_count | integer |
Nombre de projets actifs. |
|
Admin
|
admin | boolean |
L’utilisateur actuel est administrateur d’espace de travail (déconseillé). |
|
Jeton d'API
|
api_token | string |
Jeton d’API (déconseillé). |
|
Dernière modification
|
at | string |
Horodatage de la dernière modification de l’espace de travail. |
|
Espace de travail professionnel
|
business_ws | boolean |
Espace de travail sur un abonnement Premium. |
|
Chargement CSV
|
csv_upload | object |
Chargement de données CSV. |
|
Devise par défaut
|
default_currency | string |
Devise par défaut, fonctionnalité Premium. |
|
Taux horaire par défaut
|
default_hourly_rate | double |
Taux horaire par défaut, fonctionnalité Premium. |
|
Désactiver les approbations
|
disable_approvals | boolean |
Désactivez les approbations dans l’espace de travail. |
|
Désactiver l’affichage Feuille de temps
|
disable_timesheet_view | boolean |
Désactivez l’affichage feuille de temps dans l’espace de travail. |
|
Masquer les heures de fin de début
|
hide_start_end_times | boolean |
Masquer les heures de début et de fin. |
|
iCal activé
|
ical_enabled | boolean |
Intégration du calendrier activée. |
|
URL iCal
|
ical_url | string |
URL du calendrier. |
|
ID de l’espace de travail
|
id | integer |
Identificateur de l’espace de travail. |
|
Dernière modification
|
last_modified | string |
Dernière modification des données dans l’espace de travail. |
|
Limiter les données du projet public
|
limit_public_project_data | boolean |
Limitez les données de projets publics dans les rapports aux administrateurs. |
|
Logo URL
|
logo_url | string |
URL du logo de l’espace de travail. |
|
Nombre maximal de jours de rétention des données
|
max_data_retention_days | object |
Jusqu’à quel point les espaces de travail gratuits peuvent accéder aux données. |
|
Nom de l’espace de travail
|
name | string |
Nom de l’espace de travail. |
|
Seuls les administrateurs peuvent créer des projets
|
only_admins_may_create_projects | boolean |
Seuls les administrateurs pourront créer des projets. |
|
Seuls les administrateurs peuvent créer des étiquettes
|
only_admins_may_create_tags | boolean |
Seuls les administrateurs pourront créer des balises. |
|
Seuls les administrateurs voient le tableau de bord d’équipe
|
only_admins_see_team_dashboard | boolean |
Seuls les administrateurs pourront voir le tableau de bord de l’équipe. |
|
ID d’organisation
|
organization_id | integer |
Identificateur de l’organisation. |
|
Permissions
|
permissions | array of string |
Liste des autorisations. |
|
Premium
|
premium | boolean |
Espace de travail sur l’abonnement Starter. |
|
Projets facturables par défaut
|
projects_billable_by_default | boolean |
Les nouveaux projets facturables par défaut. |
|
Projets pouvant être facturés
|
projects_enforce_billable | boolean |
Indique si le temps de suivi des projets applique le paramètre facturable à respecter. |
|
Projets privés par défaut
|
projects_private_by_default | boolean |
Paramètre d’espace de travail pour la visibilité du projet par défaut. |
|
Taux de dernière mise à jour
|
rate_last_updated | string |
Horodatage de la dernière mise à jour du taux d’espace de travail. |
|
Réduction des rapports
|
reports_collapse | boolean |
Indique si les rapports doivent être réduits par défaut. |
|
Role
|
role | string |
Rôle de l’utilisateur actuel dans l’espace de travail. |
|
Arrondi
|
rounding | integer |
Fonctionnalité d’arrondi par défaut, premium. 0 - plus proche, 1 - arrondir, -1 - arrondir vers le bas. |
|
Arrondi de minutes
|
rounding_minutes | integer |
Arrondi par défaut en minutes, fonctionnalité Premium. |
|
Subscription
|
subscription | object |
Détails de l’abonnement (déconseillés). |
|
Suspendu à
|
suspended_at | string |
Horodatage de suspension. |
|
Contraintes d’entrée de temps
|
te_constraints | object |
Paramètre de contraintes d’entrée de temps. |
|
Heures de travail en minutes
|
working_hours_in_minutes | integer |
Heures de travail en minutes. |
Caractéristique
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Enabled
|
enabled | boolean |
Indique si la fonctionnalité est activée. |
|
ID de la fonctionnalité
|
feature_id | integer |
ID de fonctionnalité. |
|
Nom de la fonctionnalité
|
name | string |
Nom de la fonctionnalité. |
Espace de travailFonctionnalités
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Fonctionnalités
|
features | array of Feature |
Liste des fonctionnalités. |
|
ID de l’espace de travail
|
workspace_id | integer |
ID de l’espace de travail. |
LocationResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Ville
|
city | string |
Nom de la ville. |
|
Coordonnées de la ville
|
city_lat_long | string |
Latitude et longitude de la ville. |
|
Code pays
|
country_code | string |
Code du pays. |
|
Nom du pays
|
country_name | string |
Nom du pays. |
|
État
|
state | string |
État ou région. |
Organisation
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Admin
|
admin | boolean |
Indique si le demandeur est un administrateur de l’organisation. |
|
Dernière modification
|
at | string |
Date de la dernière modification de l’organisation. |
|
Créé à
|
created_at | string |
Date de création de l’organisation. |
|
ID d’organisation
|
id | integer |
ID de l’organisation. |
|
Multi-espace de travail activé
|
is_multi_workspace_enabled | boolean |
Est true lorsque l’option d’organisation is_multi_workspace_enabled est définie. |
|
Est unifié
|
is_unified | boolean |
Est une organisation unifiée. |
|
Nombre maximal de jours de rétention des données
|
max_data_retention_days | object |
Jusqu’à quel point les espaces de travail gratuits de cette organisation peuvent accéder aux données. |
|
Nombre maximal d’espaces de travail
|
max_workspaces | integer |
Nombre maximal d’espaces de travail autorisés pour l’organisation. |
|
Nom de l’organisation
|
name | string |
Nom de l’organisation. |
|
Propriétaire
|
owner | boolean |
Indique si le demandeur est le propriétaire de l’organisation. |
|
Permissions
|
permissions | array of string |
Autorisations de l’organisation. |
|
Plan tarifaire Entreprise
|
pricing_plan_enterprise | boolean |
Le plan d’abonnement est un plan d’entreprise. |
|
ID du plan tarifaire
|
pricing_plan_id | integer |
ID du plan d’organisation. |
|
Nom du plan tarifaire
|
pricing_plan_name | string |
Le nom du plan d’abonnement sur lequel l’organisation est actuellement activée. |
|
Suspendu à
|
suspended_at | string |
Indique si l’organisation est actuellement suspendue. |
|
trial_info
|
trial_info | TrialInfo | |
|
Nombre d’utilisateurs
|
user_count | integer |
Nombre d’utilisateurs de l’organisation. |
TrialInfo
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Peut avoir un essai
|
can_have_trial | boolean |
Est vrai si ni l’organisation ni le propriétaire n’a jamais eu de procès avant. |
|
Dernier ID du plan tarifaire
|
last_pricing_plan_id | integer |
DERNIER ID du plan tarifaire. |
|
Date de paiement suivante
|
next_payment_date | string |
Date de paiement suivante. |
|
Essai
|
trial | boolean |
Indique si l’abonnement de l’organisation est actuellement en version d’évaluation. |
|
Version d’évaluation disponible
|
trial_available | boolean |
Lorsqu’une version d’évaluation est disponible pour cette organisation (déconseillée). |
|
Date de fin de l’essai
|
trial_end_date | string |
Date de fin de l’essai. |
|
ID du plan d’évaluation
|
trial_plan_id | integer |
ID du plan d’évaluation. |
TrackReminder
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Créé à
|
created_at | string |
Heure de création du rappel. |
|
Fréquence
|
frequency | integer |
La fréquence du rappel en jours doit être de 1 ou 7. |
|
ID de groupe
|
group_ids | array of integer |
ID de groupes auxquels envoyer le rappel. |
|
ID de rappel
|
reminder_id | integer |
ID de rappel. |
|
Seuil
|
threshold | integer |
Le seuil est le nombre d’heures après lesquelles le rappel sera envoyé. |
|
ID d’utilisateur
|
user_ids | array of integer |
ID utilisateur à envoyer le rappel. |
|
ID de l’espace de travail
|
workspace_id | integer |
ID de l’espace de travail. |
TrackRemindersResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Suivi des rappels
|
items | array of TrackReminder |
Retourne une liste de rappels de suivi. |
BulkEditResponse
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Échecs
|
failure | array of BulkEditFailure |
Liste des opérations ayant échoué. |
|
ID de réussite
|
success | array of integer |
ID pour lesquels le correctif a réussi. |
BulkEditFailure
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID ayant échoué
|
id | integer |
ID pour lequel l’opération de correctif a échoué. |
|
Message d'erreur
|
message | string |
Raison de l’échec de l’opération. |
WorkspaceUser
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
2FA activée
|
2fa_enabled | boolean |
Indicateur indiquant si l’utilisation a 2FA activée ou non. |
|
Active
|
active | boolean |
Indicateur indiquant si l’utilisateur a accepté l’invitation. |
|
Admin
|
admin | boolean |
Indicateur indiquant si l’utilisateur est administrateur. |
|
Dernière mise à jour
|
at | string |
Horodatage de la dernière mise à jour. |
|
URL de l’avatar
|
avatar_file_name | string |
URL de l’avatar. |
|
Messagerie électronique
|
string |
E-mail de l’utilisateur. |
|
|
ID de groupe
|
group_ids | array of integer |
Liste des groupes auxquels appartient l’utilisateur. |
|
ID de l’espace de travail utilisateur
|
id | integer |
Identificateur de l’espace de travail utilisateur. |
|
Inactif
|
inactive | boolean |
Indicateur indiquant si l’utilisateur a été désactivé par l’administrateur de l’espace de travail. |
|
Code d’invitation
|
invitation_code | string |
Code d’invitation interne. |
|
URL d’invitation
|
invite_url | string |
URL d’invitation interne. |
|
Est membre direct
|
is_direct | boolean |
Indicateur indiquant si l’utilisateur est un membre direct de l’espace de travail (n’est pas affecté à l’espace de travail à l’aide du groupe). |
|
Coût du travail
|
labor_cost | double |
Coût du travail affecté à l’utilisateur. |
|
Coût du travail dernière mise à jour
|
labor_cost_last_updated | string |
Horodatage de la dernière mise à jour du coût du travail. |
|
Nom
|
name | string |
Nom de l'utilisateur. |
|
Administrateur de l’organisation
|
organization_admin | boolean |
Indicateur indiquant si l’utilisateur est administrateur au sein de l’organisation. |
|
Taux
|
rate | double |
Taux attribué à l’utilisateur. |
|
Taux de dernière mise à jour
|
rate_last_updated | string |
Horodatage de la dernière mise à jour du taux. |
|
Role
|
role | string |
Rôle de l’utilisateur. |
|
ID de rôle
|
role_id | integer |
ID de rôle. |
|
Timezone
|
timezone | string |
Fuseau horaire de l’utilisateur. |
|
ID d’utilisateur global
|
uid | integer |
Identificateur d’utilisateur global. |
|
ID d’utilisateur
|
user_id | integer |
Champ JSON alternative UserID, utilisé uniquement par get-organization-workspaces-workspaceusers. |
|
Afficher les tarifs facturables d’édition
|
view_edit_billable_rates | boolean |
Indicateurs d’autorisation de taux granulaires. Prend uniquement effet sur les rôles disposant d’autorisations de taux conditionnel. |
|
Afficher les coûts de travail d’édition
|
view_edit_labor_costs | boolean |
Afficher l’autorisation modifier les coûts du travail. |
|
ID de l’espace de travail
|
wid | integer |
Identificateur de l’espace de travail. |
|
Heures de travail en minutes
|
working_hours_in_minutes | integer |
Valeur des heures de travail en minutes. |
|
Administrateur de l’espace de travail
|
workspace_admin | boolean |
Indicateur indiquant si l’utilisateur est administrateur dans l’espace de travail. |
|
ID de l’espace de travail
|
workspace_id | integer |
Champ JSON alternative UserID, utilisé uniquement par get-organization-workspaces-workspaceusers. |
Taux
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Montant
|
amount | double |
Montant du taux. |
|
Créé à
|
created_at | string |
Date de création du taux. |
|
ID de créateur
|
creator_id | integer |
ID du créateur. |
|
Supprimé à
|
deleted_at | string |
La date de suppression du taux, en cas de valeur Null, signifie que les taux sont actifs. |
|
Date de fin
|
end | string |
Heure de fin du taux. |
|
ID de débit
|
id | integer |
Identificateur du taux. |
|
ID de tâche planifié
|
planned_task_id | integer |
ID de tâche planifié auquel le taux est appliqué. |
|
ID Projet
|
project_id | integer |
ID de projet que le taux est appliqué. |
|
ID utilisateur du projet
|
project_user_id | integer |
ID utilisateur du projet auquel le taux est appliqué. |
|
Mode de modification du taux
|
rate_change_mode | string |
Mode de modification du taux. |
|
Date de début
|
start | string |
Heure de début du taux. |
|
Type
|
type | string |
Type de taux. |
|
Mise à jour à
|
updated_at | string |
Date de la dernière mise à jour du taux. |
|
ID de l’espace de travail
|
workspace_id | integer |
ID de l’espace de travail auquel le taux est appliqué. |
|
ID utilisateur de l’espace de travail
|
workspace_user_id | integer |
ID utilisateur de l’espace de travail auquel le taux est appliqué. |
WorkspaceStatistics
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Administrateurs
|
admins | array of WorkspaceAdmin |
Liste des administrateurs d’espace de travail. |
|
Nombre de groupes
|
groups_count | integer |
Nombre de groupes dans l’espace de travail. |
|
Nombre de membres
|
members_count | integer |
Nombre de membres dans l’espace de travail. |
WorkspaceAdmin
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nom
|
name | string |
Nom de l’administrateur. |
|
ID d’utilisateur
|
user_id | integer |
ID d’utilisateur administrateur. |
TimeEntryConstraints
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Description requise
|
description_present | boolean |
La description est requise pour les entrées de temps. |
|
Projet obligatoire
|
project_present | boolean |
Le projet est requis pour les entrées de temps. |
|
Balise obligatoire
|
tag_present | boolean |
L’étiquette est requise pour les entrées de temps. |
|
Tâche requise
|
task_present | boolean |
La tâche est requise pour les entrées de temps. |
|
Contraintes activées
|
time_entry_constraints_enabled | boolean |
Les contraintes d’entrée de temps sont activées. |
WorkspaceUserSimple
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Messagerie électronique
|
string |
E-mail de l’utilisateur. |
|
|
Nom complet
|
fullname | string |
Nom de l'utilisateur. |
|
ID d’utilisateur
|
id | integer |
Identificateur d’utilisateur global. |
|
Inactif
|
inactive | boolean |
Inactif indique si l’utilisateur est désactivé ou non dans l’espace de travail. |
|
Est actif
|
is_active | boolean |
IsActive indique si l’utilisateur a rejoint l’espace de travail. |
|
Est administrateur (déconseillé)
|
is_admin | boolean |
Indicateur indiquant si l’utilisateur est administrateur (déconseillé). |
|
Role
|
role | string |
Rôle de l’utilisateur. |
ProjectUser
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Dernière modification
|
at | string |
Date de la dernière modification. |
|
ID de groupe (hérité)
|
gid | integer |
ID de groupe, champ hérité. |
|
ID de groupe
|
group_id | integer |
ID de groupe. |
|
ID utilisateur du projet
|
id | integer |
ID d’utilisateur du projet. |
|
Coût du travail
|
labor_cost | double |
Coût du travail pour cet utilisateur de projet. |
|
Coût du travail dernière mise à jour
|
labor_cost_last_updated | string |
Date de la dernière mise à jour du coût du travail. |
|
Gestionnaire
|
manager | boolean |
Indique si l’utilisateur est responsable du projet. |
|
ID Projet
|
project_id | integer |
ID de projet. |
|
Taux
|
rate | double |
Taux pour cet utilisateur de projet. |
|
Taux de dernière mise à jour
|
rate_last_updated | string |
Date de la dernière mise à jour du taux. |
|
ID d’utilisateur
|
user_id | integer |
Identifiant utilisateur. |
|
ID de l’espace de travail
|
workspace_id | integer |
ID de l’espace de travail. |
TimeEntryWebhookEvent
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ID de l’événement
|
event_id | integer |
Identificateur unique de l’événement webhook. |
|
Identifiant d’abonnement
|
subscription_id | integer |
ID de l’abonnement webhook qui a déclenché cet événement. |
|
Événement créé à l’adresse
|
created_at | string |
Lorsque l’événement a été créé. |
|
Horodateur d’événements
|
timestamp | string |
Lorsque l’événement a été envoyé. |
|
ID de créateur
|
creator_id | integer |
ID de l’utilisateur qui a déclenché l’événement. |
|
Callback URL (URL de rappel)
|
url_callback | string |
URL de rappel de cet événement. |
|
Type de requête
|
metadata.request_type | string |
Type de requête qui a déclenché l’événement. |
|
ID d’utilisateur d’événement
|
metadata.event_user_id | integer |
ID de l’utilisateur associé à l’événement. |
|
Action
|
metadata.action | string |
Action effectuée (créée, mise à jour, supprimée, démarrée, arrêtée). |
|
payload
|
payload | TimeEntry |