Toggl Track (Server di pubblicazione indipendente) (anteprima)
L'unico software di rilevamento dell'ora che crea report personalizzati dai dati temporali del team per ottimizzare la produttività e i ricavi. La soluzione di rilevamento del tempo registra una sequenza temporale del calendario di tutte le attività lavorative durante il giorno.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Di alta qualità | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | Troy Taylor |
| URL | https://www.hitachisolutions.com |
| ttaylor@hitachisolutions.com |
| Metadati del connettore | |
|---|---|
| Editore | troystaylor |
| Sito web | https://toggl.com/track/automated-time-tracker/ |
| Informativa sulla privacy | https://toggl.com/legal/track/privacy/ |
| Categorie | Produttività |
Attiva/Disattiva traccia
L'unico software di rilevamento dell'ora che crea report personalizzati dai dati temporali del team per ottimizzare la produttività e i ricavi. La soluzione di rilevamento del tempo registra una sequenza temporale del calendario di tutte le attività lavorative durante il giorno.
Editore: Troy Taylor, Hitachi Solutions
Prerequisiti
È necessario iscriversi per ottenere un account con Toggl.
Recupero delle credenziali
Questo connettore usa l'autenticazione di base con l'indirizzo di posta elettronica e la password.
Operazioni supportate
Ottenere l'utente corrente
Restituisce i dettagli per l'utente corrente.
Aggiornare l'utente corrente
Aggiorna i dettagli per l'utente corrente.
Ottenere i client utente
Ottenere i client per l'utente corrente.
Ottenere le funzionalità utente
Ottenere le funzionalità disponibili per l'utente corrente.
Ottenere la posizione dell'utente
Restituisce il percorso basato su IP del client. Se non sono presenti dati, verrà restituita una risposta vuota.
Controllare l'autenticazione
Usato per verificare se l'autenticazione funziona.
Ottenere le organizzazioni utente
Ottenere tutte le organizzazioni di cui fa parte un determinato utente.
Ottenere progetti utente
Ottenere progetti per l'utente corrente.
Ottenere progetti utente impaginati
Ottiene progetti impaginati per l'utente corrente.
Ottenere tag utente
Restituisce i tag per l'utente corrente.
Ottenere attività utente
Restituisce attività dai progetti in cui l'utente partecipa.
Ottenere promemoria di traccia
Restituisce un elenco di promemoria di traccia.
Ottenere il timer Web
Ottenere la configurazione del timer Web.
Ottenere le aree di lavoro utente
Elenca le aree di lavoro per un determinato utente.
Ottenere le voci relative all'ora
Elenca le voci relative all'ora più recenti.
Ottenere l'immissione dell'ora corrente
Caricare la voce di tempo di esecuzione per l'ID utente.
Ottenere l'immissione dell'ora in base all'ID
Inserimento tempo di caricamento in base all'ID accessibile dall'utente corrente.
Ottenere gli utenti dell'area di lavoro (livello organizzazione)
Restituisce tutti gli utenti che appartengono direttamente all'area di lavoro o tramite almeno un gruppo.
Ottenere gli utenti dell'area di lavoro
Elencare tutti gli utenti per una determinata area di lavoro.
Ottenere gli utenti del progetto dell'area di lavoro
Elencare tutti gli utenti di progetti per una determinata area di lavoro.
Ottenere i client utente
Ottenere i client per l'utente corrente.
Ottenere le organizzazioni utente
Ottenere tutte le organizzazioni di cui fa parte un determinato utente.
Ottenere gli utenti dell'area di lavoro (livello organizzazione)
Restituisce tutti gli utenti che appartengono direttamente all'area di lavoro o tramite almeno un gruppo.
Ottenere progetti utente
Ottenere progetti per l'utente corrente.
Ottenere progetti utente impaginati
Ottiene progetti impaginati per l'utente corrente.
Ottenere gli utenti del progetto dell'area di lavoro
Elencare tutti gli utenti di progetti per una determinata area di lavoro.
Ottenere progetti di area di lavoro
Ottenere progetti per un'area di lavoro specifica.
Ottenere il progetto dell'area di lavoro
Ottenere un progetto per un'area di lavoro specifica.
Ottenere tag utente
Restituisce i tag per l'utente corrente.
Ottenere attività utente
Restituisce attività dai progetti in cui l'utente partecipa.
Ottenere le aree di lavoro utente
Elenca le aree di lavoro per un determinato utente.
Creare una voce di ora
Crea una nuova voce relativa all'ora dell'area di lavoro.
Elimina voce di ora
Elimina una voce relativa all'ora dell'area di lavoro.
Aggiornare la voce di ora
Aggiorna una voce relativa all'ora dell'area di lavoro.
Voci relative all'ora di modifica bulk
Voci temporali di modifica bulk. Patch verrà eseguita parzialmente quando sono presenti errori con alcuni record. Nessuna transazione, nessun rollback.
Stop time entry
Arresta una voce relativa all'ora dell'area di lavoro.
Ottenere gli utenti dell'area di lavoro (livello organizzazione)
Restituisce tutti gli utenti che appartengono direttamente all'area di lavoro o tramite almeno un gruppo.
Ottenere una singola area di lavoro
Ottenere informazioni su una singola area di lavoro.
Ottenere l'elenco delle tariffe
Ottenere le tariffe per livello (area di lavoro|progetto|attività|utente).
Ottenere le statistiche dell'area di lavoro
Restituisce l'elenco degli amministratori dell'area di lavoro, il numero di membri e il numero di gruppi.
Ottenere vincoli di immissione dell'ora dell'area di lavoro
Ottenere i vincoli di immissione dell'ora per una determinata area di lavoro.
Ottenere promemoria per tenere traccia dell'area di lavoro
Restituisce un elenco di promemoria di traccia.
Ottenere gli utenti dell'area di lavoro
Elencare tutti gli utenti per una determinata area di lavoro.
Ottenere gli utenti del progetto dell'area di lavoro
Elencare tutti gli utenti di progetti per una determinata area di lavoro.
Ottenere progetti di area di lavoro
Ottenere progetti per un'area di lavoro specifica.
Ottenere il progetto dell'area di lavoro
Ottenere un progetto per un'area di lavoro specifica.
Ottenere le voci relative all'ora
Elenca le voci relative all'ora più recenti.
Ottenere l'immissione dell'ora corrente
Caricare la voce di tempo di esecuzione per l'ID utente.
Ottenere l'immissione dell'ora in base all'ID
Inserimento tempo di caricamento in base all'ID accessibile dall'utente corrente.
Quando viene creata una voce temporale
Attiva quando viene creata una nuova voce temporale nell'area di lavoro.
Quando viene aggiornata una voce di ora
Attiva quando viene modificata una voce di ora esistente nell'area di lavoro.
Quando viene eliminata una voce di ora
Attiva quando una voce temporale viene eliminata dall'area di lavoro.
Quando viene avviata una voce di ora
Attiva l'avvio di una voce di ora (inizio del timer) nell'area di lavoro.
Quando viene arrestata una voce di ora
Si attiva quando viene arrestata una voce di runtime nell'area di lavoro.
Problemi noti e limitazioni
Al momento non sono presenti problemi noti.
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | TIPO | Description | Obbligatorio |
|---|---|---|---|
| Nome utente | securestring | Nome utente per questa API | Vero |
| Parola chiave | securestring | Password per questa API | Vero |
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 100 | 60 secondi |
Azioni
| Aggiornare l'utente corrente |
Aggiorna i dettagli per l'utente corrente. |
| Aggiornare la voce di ora |
Aggiorna una voce relativa all'ora dell'area di lavoro. |
| Controllare l'autenticazione |
Usato per verificare se l'autenticazione funziona. |
| Creare una voce di ora |
Crea una nuova area di lavoro TimeEntry. |
| Elimina voce di ora |
Elimina una voce relativa all'ora dell'area di lavoro. |
| Ottenere attività utente |
Restituisce attività dai progetti in cui l'utente partecipa. |
| Ottenere gli utenti del progetto dell'area di lavoro |
Elencare tutti gli utenti di progetti per una determinata area di lavoro. |
| Ottenere gli utenti dell'area di lavoro |
Elencare tutti gli utenti per una determinata area di lavoro. |
| Ottenere gli utenti dell'area di lavoro (livello organizzazione) |
Restituisce tutti gli utenti che appartengono direttamente all'area di lavoro o tramite almeno un gruppo. |
| Ottenere i client utente |
Ottenere i client per l'utente corrente. |
| Ottenere il progetto dell'area di lavoro |
Ottenere un progetto per un'area di lavoro specifica. |
| Ottenere il timer Web |
Ottenere la configurazione del timer Web. |
| Ottenere l'elenco delle tariffe |
Ottenere le tariffe per livello (area di lavoro|progetto|attività|utente). |
| Ottenere l'immissione dell'ora corrente |
Caricare la voce di tempo di esecuzione per l'ID utente. |
| Ottenere l'immissione dell'ora in base all'ID |
Inserimento tempo di caricamento in base all'ID accessibile dall'utente corrente. |
| Ottenere l'utente corrente |
Restituisce i dettagli per l'utente corrente. |
| Ottenere la posizione dell'utente |
Restituisce il percorso basato su IP del client. Se non sono presenti dati, verrà restituita una risposta vuota. |
| Ottenere le aree di lavoro utente |
Elenca le aree di lavoro per un determinato utente. |
| Ottenere le funzionalità utente |
Ottenere le funzionalità disponibili per l'utente corrente. |
| Ottenere le organizzazioni utente |
Ottenere tutte le organizzazioni di cui fa parte un determinato utente. |
| Ottenere le statistiche dell'area di lavoro |
Restituisce l'elenco degli amministratori dell'area di lavoro, il numero di membri e il numero di gruppi. |
| Ottenere le voci relative all'ora |
Elenca le voci relative all'ora più recenti. |
| Ottenere progetti di area di lavoro |
Ottenere progetti per un'area di lavoro specifica. |
| Ottenere progetti utente |
Ottenere progetti per l'utente corrente. |
| Ottenere progetti utente impaginati |
Ottiene progetti impaginati per l'utente corrente. |
| Ottenere promemoria di traccia |
Restituisce un elenco di promemoria di traccia. |
| Ottenere promemoria per tenere traccia dell'area di lavoro |
Restituisce un elenco di promemoria di traccia. |
| Ottenere tag utente |
Restituisce i tag per l'utente corrente. |
| Ottenere una singola area di lavoro |
Ottenere informazioni su una singola area di lavoro. |
| Ottenere vincoli di immissione dell'ora dell'area di lavoro |
Ottenere i vincoli di immissione dell'ora per una determinata area di lavoro. |
| Stop time entry |
Arresta una voce relativa all'ora dell'area di lavoro. |
| Voci relative all'ora di modifica bulk |
Voci temporali di modifica bulk. Patch verrà eseguita parzialmente quando sono presenti errori con alcuni record. Nessuna transazione, nessun rollback. |
Aggiornare l'utente corrente
Aggiorna i dettagli per l'utente corrente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Inizio settimana
|
beginning_of_week | integer |
Primo giorno della settimana dell'utente. Domenica: 0, lunedì: 1, ecc. |
|
|
ID paese
|
country_id | integer |
ID paese dell'utente. |
|
|
Password corrente
|
current_password | string |
Password corrente dell'utente (usata per modificare la password corrente). |
|
|
ID area di lavoro predefinito
|
default_workspace_id | integer |
ID dell'area di lavoro predefinito dell'utente. |
|
|
Email
|
string |
Indirizzo di posta elettronica dell'utente. |
||
|
Nome completo
|
fullname | string |
Nome completo dell'utente. |
|
|
Nuova password
|
password | string |
Nuova password dell'utente (è necessario specificare anche quella corrente). |
|
|
Timezone
|
timezone | string |
Fuso orario dell'utente. |
Restituisce
- Corpo
- UserBasicResponse
Aggiornare la voce di ora
Aggiorna una voce relativa all'ora dell'area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
ID voce ora
|
time_entry_id | True | integer |
ID TimeEntry. |
|
Includi metadati
|
meta | boolean |
Se la risposta contiene dati per le metaentità. |
|
|
Includi condivisione
|
include_sharing | boolean |
Includere i dettagli di condivisione nella risposta. |
|
|
Fatturabile
|
billable | boolean |
Indica se la voce dell'ora è contrassegnata come fatturabile, facoltativa, predefinita false. |
|
|
Creato con
|
created_with | string |
Deve essere specificato durante la creazione di una voce di ora e deve identificare il servizio o l'applicazione usata per crearla. |
|
|
Description
|
description | string |
Descrizione voce ora, facoltativa. |
|
|
Durata
|
duration | integer |
Durata dell'immissione del tempo. Per le voci in esecuzione deve essere negativo, preferibile -1. |
|
|
Solo durata
|
duronly | boolean |
Deprecato: usato per creare una voce di tempo con una durata, ma senza un tempo di arresto. Questo parametro può essere ignorato. |
|
|
Caratteristica origine
|
origin_feature | string |
Nome della funzionalità di origine. |
|
|
Conteggio obiettivi visibili
|
visible_goals_count | integer |
Numero di obiettivi visibili. |
|
|
ID spese
|
expense_ids | array of integer |
Spese di lavoro associate all'immissione dell'ora. |
|
|
ID progetto (legacy)
|
pid | integer |
ID progetto, campo legacy. |
|
|
ID del progetto
|
project_id | integer |
ID progetto, facoltativo. |
|
|
Condiviso con ID utente
|
shared_with_user_ids | array of integer |
Elenco di ID utente con cui condividere questa voce di tempo. |
|
|
Ora di avvio
|
start | string |
Ora di inizio in formato UTC, necessaria per la creazione. Formato: 2006-01-02T15:04:05Z. |
|
|
Data di inizio
|
start_date | string |
Se specificato durante la creazione, la parte relativa alla data avrà la precedenza rispetto alla parte relativa alla data di inizio. Formato: 2006-11-07. |
|
|
Ora di arresto
|
stop | string |
L'ora di arresto in formato UTC può essere omessa se è ancora in esecuzione o creata con "duration". Se vengono forniti 'stop' e 'duration', i valori devono essere coerenti (start + duration == stop). |
|
|
Azione tag
|
tag_action | string |
Può essere 'add' o 'delete'. Utilizzato durante l'aggiornamento di una voce di ora esistente. |
|
|
ID tag
|
tag_ids | array of integer |
ID di tag da aggiungere/rimuovere. |
|
|
Etichette
|
tags | array of string |
Nomi dei tag da aggiungere/rimuovere. Se il nome non esiste come tag, ne verrà creato automaticamente uno. |
|
|
ID attività
|
task_id | integer |
ID attività, facoltativo. |
|
|
ID attività (legacy)
|
tid | integer |
ID attività, campo legacy. |
|
|
ID utente (legacy)
|
uid | integer |
ID autore voce temporale, campo legacy. |
|
|
ID utente
|
user_id | integer |
TIME Entry creator ID (ID autore voce temporale), se omesso userà l'ID utente richiedente. |
|
|
ID area di lavoro (legacy)
|
wid | integer |
ID area di lavoro, campo legacy. |
|
|
ID area di lavoro
|
workspace_id | integer |
ID area di lavoro, obbligatorio. |
Restituisce
- Corpo
- TimeEntry
Controllare l'autenticazione
Usato per verificare se l'autenticazione funziona.
Creare una voce di ora
Crea una nuova area di lavoro TimeEntry.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
Includi metadati
|
meta | boolean |
Se la risposta contiene dati per le metaentità. |
|
|
Fatturabile
|
billable | boolean |
Indica se la voce dell'ora è contrassegnata come fatturabile, facoltativa, predefinita false. |
|
|
Creato con
|
created_with | string |
Deve essere specificato durante la creazione di una voce di ora e deve identificare il servizio o l'applicazione usata per crearla. |
|
|
Description
|
description | string |
Descrizione voce ora, facoltativa. |
|
|
Durata
|
duration | integer |
Durata dell'immissione del tempo. Per le voci in esecuzione deve essere negativo, preferibile -1. |
|
|
Solo durata
|
duronly | boolean |
Deprecato: usato per creare una voce di tempo con una durata, ma senza un tempo di arresto. Questo parametro può essere ignorato. |
|
|
Caratteristica origine
|
origin_feature | string |
Nome della funzionalità di origine. |
|
|
Conteggio obiettivi visibili
|
visible_goals_count | integer |
Numero di obiettivi visibili. |
|
|
ID spese
|
expense_ids | array of integer |
Spese di lavoro associate all'immissione dell'ora. |
|
|
ID progetto (legacy)
|
pid | integer |
ID progetto, campo legacy. |
|
|
ID del progetto
|
project_id | integer |
ID progetto, facoltativo. |
|
|
Condiviso con ID utente
|
shared_with_user_ids | array of integer |
Elenco di ID utente con cui condividere questa voce di tempo. |
|
|
Ora di avvio
|
start | string |
Ora di inizio in formato UTC, necessaria per la creazione. Formato: 2006-01-02T15:04:05Z. |
|
|
Data di inizio
|
start_date | string |
Se specificato durante la creazione, la parte relativa alla data avrà la precedenza rispetto alla parte relativa alla data di inizio. Formato: 2006-11-07. |
|
|
Ora di arresto
|
stop | string |
L'ora di arresto in formato UTC può essere omessa se è ancora in esecuzione o creata con "duration". Se vengono forniti 'stop' e 'duration', i valori devono essere coerenti (start + duration == stop). |
|
|
Azione tag
|
tag_action | string |
Può essere 'add' o 'delete'. Utilizzato durante l'aggiornamento di una voce di ora esistente. |
|
|
ID tag
|
tag_ids | array of integer |
ID di tag da aggiungere/rimuovere. |
|
|
Etichette
|
tags | array of string |
Nomi dei tag da aggiungere/rimuovere. Se il nome non esiste come tag, ne verrà creato automaticamente uno. |
|
|
ID attività
|
task_id | integer |
ID attività, facoltativo. |
|
|
ID attività (legacy)
|
tid | integer |
ID attività, campo legacy. |
|
|
ID utente (legacy)
|
uid | integer |
ID autore voce temporale, campo legacy. |
|
|
ID utente
|
user_id | integer |
TIME Entry creator ID (ID autore voce temporale), se omesso userà l'ID utente richiedente. |
|
|
ID area di lavoro (legacy)
|
wid | integer |
ID area di lavoro, campo legacy. |
|
|
ID area di lavoro
|
workspace_id | integer |
ID area di lavoro, obbligatorio. |
Restituisce
- Corpo
- TimeEntry
Elimina voce di ora
Elimina una voce relativa all'ora dell'area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
ID voce ora
|
time_entry_id | True | integer |
ID TimeEntry. |
Ottenere attività utente
Restituisce attività dai progetti in cui l'utente partecipa.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Includi metadati
|
meta | boolean |
Se la risposta contiene dati per le metaentità. |
|
|
Dalla data di inizio
|
since | integer |
Recuperare gli elementi creati/modificati/eliminati da questa data usando il timestamp UNIX. |
|
|
Includi attività inattive
|
include_not_active | string |
Includere le attività contrassegnate come eseguite. |
|
|
Offset impaginazione
|
offset | integer |
Offset da cui riprendere la paginazione successiva. |
|
|
Elementi per pagina
|
per_page | integer |
Numero di elementi per pagina, valore predefinito 201. |
Restituisce
- response
- array of Task
Ottenere gli utenti del progetto dell'area di lavoro
Elencare tutti gli utenti di progetti per una determinata area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
ID progetto
|
project_ids | string |
ID numerici di progetti, delimitati da virgole. |
|
|
ID utente
|
user_id | string |
ID numerico dell'utente, se passato restituisce solo gli utenti del progetto per i progetti dell'utente. |
|
|
Includi membri del gruppo
|
with_group_members | boolean |
Includere i membri del gruppo. |
Restituisce
- response
- array of ProjectUser
Ottenere gli utenti dell'area di lavoro
Elencare tutti gli utenti per una determinata area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
Escludi eliminato
|
exclude_deleted | boolean |
Escludere i record eliminati nella risposta. |
Restituisce
- response
- array of WorkspaceUserSimple
Ottenere gli utenti dell'area di lavoro (livello organizzazione)
Restituisce tutti gli utenti che appartengono direttamente all'area di lavoro o tramite almeno un gruppo.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID organizzazione
|
organization_id | True | integer |
ID numerico dell'organizzazione. |
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
Numero pagina
|
page | integer |
Numero di pagina. |
|
|
Elementi per pagina
|
per_page | integer |
Numero di elementi per pagina, valore predefinito 201. |
|
|
Filtro tariffe personalizzate
|
custom_rates | boolean |
Restituisce solo gli utenti con o senza una tariffa oraria personalizzata rispettivamente. |
|
|
Solo utenti attivi
|
active | boolean |
Restituisce solo gli utenti attivi. |
|
|
Filtro dei nomi
|
name | string |
Nome utente dell'area di lavoro da filtrare. |
|
|
Filtro di ricerca
|
search | string |
Filtro dell'area di lavoro in base al nome o al messaggio di posta elettronica. |
Restituisce
- response
- array of WorkspaceUser
Ottenere i client utente
Ottenere i client per l'utente corrente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Dalla data di inizio
|
since | integer |
Recuperare gli elementi creati/modificati/eliminati da questa data usando il timestamp UNIX. |
Restituisce
- response
- array of Client
Ottenere il progetto dell'area di lavoro
Ottenere un progetto per un'area di lavoro specifica.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
ID del progetto
|
project_id | True | integer |
ID numerico del progetto. |
Restituisce
- Corpo
- Project
Ottenere il timer Web
Ottenere la configurazione del timer Web.
Ottenere l'elenco delle tariffe
Ottenere le tariffe per livello (area di lavoro|progetto|attività|utente).
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
Level
|
level | True | string |
Livello di frequenza: area di lavoro, progetto, attività o utente. |
|
ID livello
|
level_id | True | integer |
ID numerico del livello di entità. |
|
Tipo di frequenza
|
type | string |
Tipo di valori di frequenza da restituire: billable_rates o labor_costs. Il valore predefinito è billable_rates. |
Restituisce
- response
- array of Rate
Ottenere l'immissione dell'ora corrente
Ottenere l'immissione dell'ora in base all'ID
Inserimento tempo di caricamento in base all'ID accessibile dall'utente corrente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID voce ora
|
time_entry_id | True | integer |
ID TimeEntry. |
|
Includi metadati
|
meta | boolean |
Se la risposta contiene dati per le metaentità. |
|
|
Includi condivisione
|
include_sharing | boolean |
Includere i dettagli di condivisione nella risposta. |
Restituisce
- Corpo
- TimeEntry
Ottenere l'utente corrente
Restituisce i dettagli per l'utente corrente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Includi dati correlati
|
with_related_data | boolean |
Recuperare i dati correlati all'utente (client, progetti, attività, tag, aree di lavoro, voci temporali e così via). |
Restituisce
- Corpo
- UserResponse
Ottenere la posizione dell'utente
Restituisce il percorso basato su IP del client. Se non sono presenti dati, verrà restituita una risposta vuota.
Restituisce
- Corpo
- LocationResponse
Ottenere le aree di lavoro utente
Elenca le aree di lavoro per un determinato utente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Dalla data di inizio
|
since | integer |
Recuperare gli elementi creati/modificati/eliminati da questa data usando il timestamp UNIX. |
Restituisce
- response
- array of Workspace
Ottenere le funzionalità utente
Ottenere le funzionalità disponibili per l'utente corrente.
Restituisce
- response
- array of WorkspaceFeatures
Ottenere le organizzazioni utente
Ottenere tutte le organizzazioni di cui fa parte un determinato utente.
Restituisce
- response
- array of Organization
Ottenere le statistiche dell'area di lavoro
Restituisce l'elenco degli amministratori dell'area di lavoro, il numero di membri e il numero di gruppi.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
Restituisce
- Corpo
- WorkspaceStatistics
Ottenere le voci relative all'ora
Elenca le voci relative all'ora più recenti.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Includi metadati
|
meta | boolean |
Se la risposta contiene dati per le metaentità. |
|
|
Includi condivisione
|
include_sharing | boolean |
Includere i dettagli di condivisione nella risposta. |
|
|
Dalla data di inizio
|
since | integer |
Recuperare gli elementi creati/modificati/eliminati da questa data usando il timestamp UNIX. |
|
|
Prima della data
|
before | string |
Ottiene le voci con ora di inizio, prima della data specificata (AAAA-MM-DD) o con l'ora nel formato RFC3339. |
|
|
Data di inizio
|
start_date | string |
Ottenere voci con ora di inizio, da start_date AAAA-MM-DD o con l'ora in formato RFC3339. Da usare con end_date. |
|
|
Data di fine
|
end_date | string |
Ottenere le voci con ora di inizio, fino a end_date AAAA-MM-DD o con l'ora nel formato RFC3339. Da usare con start_date. |
Restituisce
- response
- array of TimeEntry
Ottenere progetti di area di lavoro
Ottenere progetti per un'area di lavoro specifica.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
Ordinamento aggiunto
|
sort_pinned | True | boolean |
Posizionare i progetti aggiunti all'inizio della risposta. |
|
Solo utenti attivi
|
active | boolean |
Restituisce solo gli utenti attivi. |
|
|
Dalla data di inizio
|
since | integer |
Recuperare gli elementi creati/modificati/eliminati da questa data usando il timestamp UNIX. |
|
|
Fatturabile
|
billable | boolean |
Filtra in base allo stato fatturabile. |
|
|
ID utente
|
user_ids | array |
ID utente per cui filtrare. |
|
|
ID client
|
client_ids | array |
ID client per cui filtrare. |
|
|
ID gruppo
|
group_ids | array |
ID di gruppo per cui filtrare. |
|
|
ID progetto
|
project_ids | string |
ID numerici di progetti, delimitati da virgole. |
|
|
Stati
|
statuses | array |
Stato del progetto in base a cui filtrare. |
|
|
Filtro dei nomi
|
name | string |
Nome utente dell'area di lavoro da filtrare. |
|
|
Numero pagina
|
page | integer |
Numero di pagina. |
|
|
Campo di ordinamento
|
sort_field | True | string |
Campo per cui eseguire l'ordinamento. |
|
Ordine di ordinamento
|
sort_order | True | string |
Ordinamento (asc/desc). |
|
Solo modelli
|
only_templates | True | boolean |
Restituisce solo i modelli di progetto. |
|
Solo progetti personali
|
only_me | boolean |
Ottiene solo i progetti assegnati all'utente corrente. |
|
|
Elementi per pagina
|
per_page | integer |
Numero di elementi per pagina, valore predefinito 201. |
Restituisce
- response
- array of Project
Ottenere progetti utente
Ottenere progetti per l'utente corrente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Includi archiviato
|
include_archived | string |
Includere progetti archiviati. |
|
|
Dalla data di inizio
|
since | integer |
Recuperare gli elementi creati/modificati/eliminati da questa data usando il timestamp UNIX. |
Restituisce
- response
- array of Project
Ottenere progetti utente impaginati
Ottiene progetti impaginati per l'utente corrente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Avviare l'ID progetto
|
start_project_id | integer |
ID progetto da cui riprendere la paginazione successiva. |
|
|
Dalla data di inizio
|
since | integer |
Recuperare gli elementi creati/modificati/eliminati da questa data usando il timestamp UNIX. |
|
|
Elementi per pagina
|
per_page | integer |
Numero di elementi per pagina, valore predefinito 201. |
Restituisce
- response
- array of Project
Ottenere promemoria di traccia
Ottenere promemoria per tenere traccia dell'area di lavoro
Restituisce un elenco di promemoria di traccia.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
Restituisce
- Corpo
- TrackRemindersResponse
Ottenere tag utente
Restituisce i tag per l'utente corrente.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Dalla data di inizio
|
since | integer |
Recuperare gli elementi creati/modificati/eliminati da questa data usando il timestamp UNIX. |
Restituisce
- response
- array of Tag
Ottenere una singola area di lavoro
Ottenere informazioni su una singola area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
Restituisce
- Corpo
- Workspace
Ottenere vincoli di immissione dell'ora dell'area di lavoro
Ottenere i vincoli di immissione dell'ora per una determinata area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
Restituisce
- Corpo
- TimeEntryConstraints
Stop time entry
Arresta una voce relativa all'ora dell'area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
ID voce ora
|
time_entry_id | True | integer |
ID TimeEntry. |
Restituisce
- Corpo
- TimeEntry
Voci relative all'ora di modifica bulk
Voci temporali di modifica bulk. Patch verrà eseguita parzialmente quando sono presenti errori con alcuni record. Nessuna transazione, nessun rollback.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
ID voce di ora
|
time_entry_ids | True | string |
ID numerici di time_entries separati da virgole. Ad esempio: 204301830,202700150,202687559. Il limite è 100 ID per richiesta. |
|
Includi metadati
|
meta | boolean |
Se la risposta contiene dati per le metaentità. |
|
|
Operation
|
op | True | string |
Operazione (aggiunta/rimozione/sostituzione). |
|
Percorso
|
path | True | string |
Percorso dell'entità da applicare alle patch ,ad esempio /description. |
|
Value
|
value | object |
Nuovo valore per l'entità nel percorso. |
Restituisce
- Corpo
- BulkEditResponse
Trigger
| Quando viene aggiornata una voce di ora |
Attiva quando viene modificata una voce di ora esistente nell'area di lavoro. |
| Quando viene arrestata una voce di ora |
Si attiva quando viene arrestata una voce di runtime nell'area di lavoro. |
| Quando viene avviata una voce di ora |
Attiva l'avvio di una voce di ora (inizio del timer) nell'area di lavoro. |
| Quando viene creata una voce temporale |
Attiva quando viene creata una nuova voce temporale nell'area di lavoro. |
| Quando viene eliminata una voce di ora |
Attiva quando una voce temporale viene eliminata dall'area di lavoro. |
Quando viene aggiornata una voce di ora
Attiva quando viene modificata una voce di ora esistente nell'area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
Entità
|
entity | string |
Attiva/Disattiva traccia entità business da filtrare. |
|
|
Action
|
action | string |
Tipo di modifica applicata all'entità. |
Restituisce
- Corpo
- TimeEntryWebhookEvent
Quando viene arrestata una voce di ora
Si attiva quando viene arrestata una voce di runtime nell'area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
Entità
|
entity | string |
Attiva/Disattiva traccia entità business da filtrare. |
|
|
Action
|
action | string |
Tipo di modifica applicata all'entità. |
Restituisce
- Corpo
- TimeEntryWebhookEvent
Quando viene avviata una voce di ora
Attiva l'avvio di una voce di ora (inizio del timer) nell'area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
Entità
|
entity | string |
Attiva/Disattiva traccia entità business da filtrare. |
|
|
Action
|
action | string |
Tipo di modifica applicata all'entità. |
Restituisce
- Corpo
- TimeEntryWebhookEvent
Quando viene creata una voce temporale
Attiva quando viene creata una nuova voce temporale nell'area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
Entità
|
entity | string |
Attiva/Disattiva traccia entità business da filtrare. |
|
|
Action
|
action | string |
Tipo di modifica applicata all'entità. |
Restituisce
- Corpo
- TimeEntryWebhookEvent
Quando viene eliminata una voce di ora
Attiva quando una voce temporale viene eliminata dall'area di lavoro.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID area di lavoro
|
workspace_id | True | integer |
ID numerico dell'area di lavoro. |
|
Entità
|
entity | string |
Attiva/Disattiva traccia entità business da filtrare. |
|
|
Action
|
action | string |
Tipo di modifica applicata all'entità. |
Restituisce
- Corpo
- TimeEntryWebhookEvent
Definizioni
UserResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
2FA abilitata
|
2fa_enabled | boolean |
Stato abilitato per l'autenticazione a due fattori. |
|
API Token
|
api_token | string |
Il token API verrà omesso se vuoto. |
|
Ultimo aggiornamento
|
at | string |
Timestamp ultimo aggiornamento. |
|
Autorizzazione aggiornata
|
authorization_updated_at | string |
Timestamp dell'ultimo aggiornamento dell'oggetto sessione utente di autorizzazione. |
|
Inizio settimana
|
beginning_of_week | integer |
Primo giorno della settimana dell'utente (0=domenica, 1=lunedì e così via). |
|
Clients
|
clients | array of Client |
Client, null se with_related_data non è stato impostato su true. |
|
ID paese
|
country_id | integer |
ID paese dell'utente. |
|
Creato all'indirizzo
|
created_at | string |
Timestamp di creazione utente. |
|
ID area di lavoro predefinito
|
default_workspace_id | integer |
ID dell'area di lavoro predefinito dell'utente. |
|
Email
|
string |
Indirizzo di posta elettronica dell'utente. |
|
|
Nome completo
|
fullname | string |
Nome completo dell'utente. |
|
Ha la password
|
has_password | boolean |
Indica se l'utente ha un set di password. |
|
ID utente
|
id | integer |
ID utente. |
|
URL immagine
|
image_url | string |
URL dell'immagine del profilo dell'utente. |
|
Intercom Hash
|
intercom_hash | string |
L'hash intercom verrà omesso se vuoto. |
|
Provider OAuth
|
oauth_providers | array of string |
Provider OAuth disponibili per l'utente. |
|
Indirizzo di posta elettronica OpenID
|
openid_email | string |
Indirizzo di posta elettronica OpenID. |
|
OpenID abilitato
|
openid_enabled | boolean |
Stato abilitato per l'autenticazione OpenID. |
|
Options
|
options | object |
Le opzioni utente verranno omesse se vuote. |
|
Progetti
|
projects | array of Project |
Projects, null se with_related_data non è stato impostato su true. |
|
Etichette
|
tags | array of Tag |
Tag, null se with_related_data non è stato impostato su true. |
|
Tasks
|
tasks | array of Task |
Attività, null se with_related_data non è stato impostato su true. |
|
Voci temporali
|
time_entries | array of TimeEntry |
Voci di ora, null se with_related_data non è stato impostato su true. |
|
Timezone
|
timezone | string |
Fuso orario dell'utente. |
|
Aggiornato all'indirizzo
|
updated_at | string |
Timestamp dell'ultimo aggiornamento dell'utente. |
|
Aree di lavoro
|
workspaces | array of Workspace |
Aree di lavoro, null se with_related_data non è stato impostato su true. |
UserBasicResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
2FA abilitata
|
2fa_enabled | boolean |
Stato abilitato per l'autenticazione a due fattori. |
|
API Token
|
api_token | string |
Il token API verrà omesso se vuoto. |
|
Ultimo aggiornamento
|
at | string |
Timestamp ultimo aggiornamento. |
|
Inizio settimana
|
beginning_of_week | integer |
Primo giorno della settimana dell'utente. |
|
ID paese
|
country_id | integer |
ID paese dell'utente. |
|
Creato all'indirizzo
|
created_at | string |
Timestamp di creazione utente. |
|
ID area di lavoro predefinito
|
default_workspace_id | integer |
ID dell'area di lavoro predefinito dell'utente. |
|
Email
|
string |
Indirizzo di posta elettronica dell'utente. |
|
|
Nome completo
|
fullname | string |
Nome completo dell'utente. |
|
Ha la password
|
has_password | boolean |
Indica se l'utente ha un set di password. |
|
ID utente
|
id | integer |
ID utente. |
|
URL immagine
|
image_url | string |
URL dell'immagine del profilo dell'utente. |
|
Indirizzo di posta elettronica OpenID
|
openid_email | string |
Indirizzo di posta elettronica OpenID. |
|
OpenID abilitato
|
openid_enabled | boolean |
Stato abilitato per l'autenticazione OpenID. |
|
Options
|
options | object |
Le opzioni utente verranno omesse se vuote. |
|
Timezone
|
timezone | string |
Fuso orario dell'utente. |
|
Aggiornato all'indirizzo
|
updated_at | string |
Timestamp dell'ultimo aggiornamento dell'utente. |
Cliente
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Archived
|
archived | boolean |
True se il client è archiviato. |
|
Ultimo aggiornamento
|
at | string |
Quando è stato l'ultimo aggiornamento. |
|
ID creatore
|
creator_id | integer |
ID dell'utente che ha creato il client. |
|
Riferimento esterno
|
external_reference | string |
Riferimento esterno all'entità Track Client. |
|
ID cliente
|
id | integer |
ID client |
|
ID esterno integrazione
|
integration_ext_id | string |
ID esterno dell'entità collegata nel sistema esterno. |
|
Tipo esterno di integrazione
|
integration_ext_type | string |
Tipo esterno dell'entità collegata nel sistema esterno. |
|
Provider di integrazione
|
integration_provider | object |
Provider con un'entità collegata all'entità Toggl Track. |
|
Nome client
|
name | string |
Nome del client. |
|
Note
|
notes | string |
Note client. |
|
Permissions
|
permissions | array of string |
Elenco delle autorizzazioni di autorizzazione per questo client. |
|
Conteggio totale
|
total_count | integer |
Campo totale per archiviare il conteggio totale. |
|
ID area di lavoro
|
wid | integer |
ID area di lavoro. |
Progetto
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Active
|
active | boolean |
Indica se il progetto è attivo o archiviato. |
|
Ore effettive
|
actual_hours | integer |
Ore effettive trascorse per il progetto. |
|
Secondi effettivi
|
actual_seconds | integer |
Secondi effettivi trascorsi per il progetto. |
|
Ultimo aggiornamento
|
at | string |
Data ultimo aggiornamento. |
|
Stime automatica
|
auto_estimates | boolean |
Stime automatica abilitate. |
|
Fatturabile
|
billable | boolean |
Indica se il progetto è fatturabile. |
|
Può tenere traccia dell'ora
|
can_track_time | boolean |
Indica se è possibile tenere traccia dell'ora in questo progetto. |
|
ID client (legacy)
|
cid | integer |
Campo legacy ID client. |
|
ID cliente
|
client_id | integer |
ID client |
|
Nome client
|
client_name | string |
Nome client. |
|
Colore
|
color | string |
Colore del progetto. |
|
Creato all'indirizzo
|
created_at | string |
Data di creazione. |
|
Valuta
|
currency | string |
Valuta del progetto. |
|
Periodo corrente
|
current_period | object |
Periodo di progetto corrente, funzionalità Premium. |
|
Data di fine
|
end_date | string |
Data di fine del progetto. |
|
Ore stimate
|
estimated_hours | integer |
Ore stimate per il progetto. |
|
Secondi stimati
|
estimated_seconds | integer |
Secondi stimati per il progetto. |
|
Riferimento esterno
|
external_reference | string |
Riferimento esterno all'entità track project. |
|
Tariffa fissa
|
fixed_fee | double |
Tariffa fissa, funzionalità Premium. |
|
ID del progetto
|
id | integer |
ID progetto. |
|
ID esterno integrazione
|
integration_ext_id | string |
ID esterno dell'entità collegata nel sistema esterno. |
|
Tipo esterno di integrazione
|
integration_ext_type | string |
Tipo esterno dell'entità collegata nel sistema esterno. |
|
Provider di integrazione
|
integration_provider | object |
Provider con un'entità collegata all'entità Toggl Track. |
|
È privato
|
is_private | boolean |
Indica se il progetto è privato. |
|
Nome progetto
|
name | string |
Nome progetto. |
|
Permissions
|
permissions | array of string |
Autorizzazioni per il progetto. |
|
Aggiunti
|
pinned | boolean |
Indica se il progetto è stato aggiunto. |
|
Tariffa oraria
|
rate | double |
Frequenza oraria per il progetto. |
|
Rate Last Updated
|
rate_last_updated | string |
Data dell'ultimo aggiornamento della frequenza. |
|
Ricorrente
|
recurring | boolean |
Indica se il progetto è ricorrente, funzionalità Premium. |
|
Parametri ricorrenti
|
recurring_parameters | array of RecurringParameter |
Parametri ricorrenti del progetto, funzionalità Premium. |
|
Data di inizio
|
start_date | string |
Data di inizio del progetto. |
|
stato
|
status | string |
Stato del progetto (imminente, attivo, terminato, archiviato, eliminato). |
|
Template
|
template | boolean |
Indica se il progetto è un modello. |
|
ID modello
|
template_id | integer |
ID modello se il progetto è basato sul modello. |
|
Conteggio totale
|
total_count | integer |
Numero totale di progetti trovati. |
|
ID area di lavoro (legacy)
|
wid | integer |
Campo legacy ID area di lavoro. |
|
ID area di lavoro
|
workspace_id | integer |
ID area di lavoro. |
RicorrenteParameter
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Periodo personalizzato
|
custom_period | integer |
Periodo personalizzato, usato quando il campo periodo è "personalizzato". |
|
Secondi stimati
|
estimated_seconds | integer |
Secondi stimati. |
|
Data di fine parametro
|
parameter_end_date | string |
Data di fine del parametro. |
|
Data inizio parametro
|
parameter_start_date | string |
Data di inizio ricorrente. |
|
Periodo
|
period | string |
Periodo ricorrente. |
|
Data inizio progetto
|
project_start_date | string |
Data di inizio del progetto. |
Tag
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Ultima modifica
|
at | string |
Data di creazione/ultima modifica. |
|
ID creatore
|
creator_id | integer |
ID dell'utente che ha creato il tag. |
|
Eliminato all'indirizzo
|
deleted_at | string |
Quando è stato eliminato. |
|
Tag ID
|
id | integer |
ID tag. |
|
ID esterno integrazione
|
integration_ext_id | string |
ID esterno dell'entità collegata nel sistema esterno. |
|
Tipo esterno di integrazione
|
integration_ext_type | string |
Tipo esterno dell'entità collegata nel sistema esterno. |
|
Provider di integrazione
|
integration_provider | object |
Provider con un'entità collegata all'entità Toggl Track. |
|
Nome del tag
|
name | string |
Nome tag. |
|
Permissions
|
permissions | array of string |
Autorizzazioni per i tag. |
|
ID area di lavoro
|
workspace_id | integer |
ID area di lavoro. |
Task
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Active
|
active | boolean |
False al termine dell'attività. |
|
Ultima modifica
|
at | string |
Quando l'attività è stata creata o modificata per l'ultima volta. |
|
Avatar URL
|
avatar_url | string |
URL avatar. |
|
Nome client
|
client_name | string |
Nome client. |
|
Secondi stimati
|
estimated_seconds | integer |
Secondi stimati per l'attività. |
|
ID attività
|
id | integer |
ID attività. |
|
ID esterno integrazione
|
integration_ext_id | string |
ID esterno dell'entità collegata nel sistema esterno. |
|
Tipo esterno di integrazione
|
integration_ext_type | string |
Tipo esterno dell'entità collegata nel sistema esterno. |
|
Provider di integrazione
|
integration_provider | object |
Provider con un'entità collegata all'entità Toggl Track. |
|
Nome attività
|
name | string |
Nome attività. |
|
Permissions
|
permissions | array of string |
Autorizzazioni per le attività. |
|
Progetto fatturabile
|
project_billable | boolean |
Indica se il progetto è fatturabile. |
|
Colore progetto
|
project_color | string |
Metadati del colore del progetto. |
|
ID del progetto
|
project_id | integer |
ID progetto. |
|
Project è privato
|
project_is_private | boolean |
Indica se il progetto è privato. |
|
Nome progetto
|
project_name | string |
Nome progetto. |
|
Rate
|
rate | double |
Frequenza per questa attività. |
|
Rate Last Updated
|
rate_last_updated | string |
Data dell'ultimo aggiornamento della frequenza. |
|
Ricorrente
|
recurring | boolean |
Indica se si tratta di un'attività ricorrente. |
|
ID account di attivazione/disattivazione
|
toggl_accounts_id | string |
ID account Attiva/Disattiva. |
|
Secondi rilevati
|
tracked_seconds | integer |
Il valore tracked_seconds è espresso in millisecondi, non in secondi. |
|
ID utente
|
user_id | integer |
ID utente. |
|
Nome utente
|
user_name | string |
Nome utente. |
|
ID area di lavoro
|
workspace_id | integer |
ID area di lavoro. |
TimeEntry
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Ultimo aggiornamento
|
at | string |
Quando è stato aggiornato l'ultimo aggiornamento, segue il formato ISO 8601. |
|
Fatturabile
|
billable | boolean |
Indica se la voce dell'ora è contrassegnata come fatturabile. |
|
Nome client
|
client_name | string |
Meta campi meta entità correlate. |
|
Description
|
description | string |
Descrizione dell'immissione dell'ora. |
|
Durata
|
duration | integer |
Durata dell'immissione del tempo. Per le voci in esecuzione deve essere negativo, preferibile -1. |
|
Solo durata
|
duronly | boolean |
Usato per creare un TE con una durata, ma senza un tempo di arresto. |
|
ID spese
|
expense_ids | array of integer |
Spese di lavoro. |
|
ID voce ora
|
id | integer |
ID voce ora. |
|
Permissions
|
permissions | array of string |
Elenco di autorizzazioni. |
|
ID progetto (legacy)
|
pid | integer |
ID progetto, campo legacy. |
|
Progetto attivo
|
project_active | boolean |
Indica se il progetto è attivo. |
|
Progetto fatturabile
|
project_billable | boolean |
Indica se il progetto è fatturabile. |
|
Colore progetto
|
project_color | string |
Colore del progetto. |
|
ID del progetto
|
project_id | integer |
ID progetto. |
|
Nome progetto
|
project_name | string |
Nome progetto. |
|
Condiviso con
|
shared_with | array of SharedWith |
Indica con chi è stata condivisa l'immissione dell'ora. |
|
Ora di avvio
|
start | string |
Ora di inizio in formato UTC. |
|
Ora di arresto
|
stop | string |
L'ora di arresto in formato UTC può essere Null se è ancora in esecuzione. |
|
ID tag
|
tag_ids | array of integer |
ID tag, null se i tag non sono stati specificati o sono stati eliminati in un secondo momento. |
|
Etichette
|
tags | array of string |
Nomi di tag, null se i tag non sono stati specificati o sono stati eliminati in un secondo momento. |
|
ID attività
|
task_id | integer |
ID attività. |
|
Nome attività
|
task_name | string |
Nome attività. |
|
ID attività (legacy)
|
tid | integer |
ID attività, campo legacy. |
|
ID utente (legacy)
|
uid | integer |
ID autore voce temporale, campo legacy. |
|
URL avatar utente
|
user_avatar_url | string |
URL avatar utente. |
|
ID utente
|
user_id | integer |
ID creatore voce temporale. |
|
Nome utente
|
user_name | string |
Nome utente. |
|
ID area di lavoro (legacy)
|
wid | integer |
ID area di lavoro, campo legacy. |
|
ID area di lavoro
|
workspace_id | integer |
ID area di lavoro. |
SharedWith
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Accettato
|
accepted | boolean |
Indica se la condivisione è stata accettata. |
|
ID utente
|
user_id | integer |
ID utente della persona con cui è condiviso. |
|
Nome utente
|
user_name | string |
Nome utente della persona con cui è condiviso. |
Workspace
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Conteggio progetti attivi
|
active_project_count | integer |
Numero di progetti attivi. |
|
Admin
|
admin | boolean |
L'utente corrente è amministratore dell'area di lavoro (deprecato). |
|
API Token
|
api_token | string |
Token API (deprecato). |
|
Ultima modifica
|
at | string |
Timestamp dell'ultima modifica dell'area di lavoro. |
|
Area di lavoro aziendale
|
business_ws | boolean |
Area di lavoro nella sottoscrizione Premium. |
|
Caricamento CSV
|
csv_upload | object |
Caricamento csv dei dati. |
|
Valuta predefinita
|
default_currency | string |
Valuta predefinita, funzionalità Premium. |
|
Tariffa oraria predefinita
|
default_hourly_rate | double |
La tariffa oraria predefinita, la funzionalità Premium. |
|
Disabilitare le approvazioni
|
disable_approvals | boolean |
Disabilitare le approvazioni nell'area di lavoro. |
|
Disabilita visualizzazione scheda attività
|
disable_timesheet_view | boolean |
Disabilitare la visualizzazione scheda attività nell'area di lavoro. |
|
Nascondi ora di fine inizio
|
hide_start_end_times | boolean |
Nascondere l'ora di inizio e di fine. |
|
iCal Enabled
|
ical_enabled | boolean |
Integrazione del calendario abilitata. |
|
URL iCal
|
ical_url | string |
URL del calendario. |
|
ID area di lavoro
|
id | integer |
Identificatore dell'area di lavoro. |
|
Ultima modifica
|
last_modified | string |
Ultima modifica dei dati nell'area di lavoro. |
|
Limitare i dati del progetto pubblico
|
limit_public_project_data | boolean |
Limitare i dati dei progetti pubblici nei report agli amministratori. |
|
Logo URL
|
logo_url | string |
URL del logo dell'area di lavoro. |
|
Numero massimo di giorni di conservazione dei dati
|
max_data_retention_days | object |
Fino a quando le aree di lavoro gratuite possono accedere ai dati. |
|
Nome area di lavoro
|
name | string |
Nome dell'area di lavoro. |
|
Solo gli amministratori possono creare progetti
|
only_admins_may_create_projects | boolean |
Solo gli amministratori potranno creare progetti. |
|
Solo gli amministratori possono creare tag
|
only_admins_may_create_tags | boolean |
Solo gli amministratori potranno creare tag. |
|
Solo gli amministratori visualizzano il dashboard del team
|
only_admins_see_team_dashboard | boolean |
Solo gli amministratori potranno visualizzare il dashboard del team. |
|
ID organizzazione
|
organization_id | integer |
Identificatore dell'organizzazione. |
|
Permissions
|
permissions | array of string |
Elenco delle autorizzazioni. |
|
Di alta qualità
|
premium | boolean |
Area di lavoro nella sottoscrizione starter. |
|
Progetti fatturabili per impostazione predefinita
|
projects_billable_by_default | boolean |
Nuovi progetti fatturabili per impostazione predefinita. |
|
Progetti Imponi fatturabili
|
projects_enforce_billable | boolean |
Indica se il rilevamento del tempo per i progetti imponi l'impostazione fatturabile deve essere rispettata. |
|
Progetti privati per impostazione predefinita
|
projects_private_by_default | boolean |
Impostazione dell'area di lavoro per la visibilità predefinita del progetto. |
|
Rate Last Updated
|
rate_last_updated | string |
Timestamp dell'ultimo aggiornamento della frequenza dell'area di lavoro. |
|
Comprimi report
|
reports_collapse | boolean |
Indica se i report devono essere compressi per impostazione predefinita. |
|
Ruolo
|
role | string |
Ruolo dell'utente corrente nell'area di lavoro. |
|
Arrotondamento
|
rounding | integer |
Arrotondamento predefinito, funzionalità Premium. 0 - più vicino, 1 - arrotondamento, -1 - arrotondamento verso il basso. |
|
Arrotondamento minuti
|
rounding_minutes | integer |
Arrotondamento predefinito in minuti, funzionalità Premium. |
|
Subscription
|
subscription | object |
Dettagli della sottoscrizione (deprecato). |
|
Sospeso all'indirizzo
|
suspended_at | string |
Timestamp della sospensione. |
|
Vincoli di immissione di tempo
|
te_constraints | object |
Impostazione dei vincoli di immissione temporale. |
|
Ore lavorative in minuti
|
working_hours_in_minutes | integer |
Ore lavorative in minuti. |
Caratteristica / Funzionalità
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Enabled
|
enabled | boolean |
Indica se la funzionalità è abilitata. |
|
ID funzionalità
|
feature_id | integer |
ID funzionalità. |
|
Nome funzionalità
|
name | string |
Nome della funzionalità. |
Funzionalità dell'area di lavoro
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Funzionalità
|
features | array of Feature |
Elenco delle funzionalità. |
|
ID area di lavoro
|
workspace_id | integer |
ID area di lavoro. |
LocationResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Città
|
city | string |
Nome città. |
|
Coordinate della città
|
city_lat_long | string |
Latitudine e longitudine della città. |
|
Codice paese
|
country_code | string |
Codice paese. |
|
Nome paese
|
country_name | string |
Nome paese. |
|
stato
|
state | string |
Stato o area geografica. |
Organizzazione
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Admin
|
admin | boolean |
Indica se il richiedente è un amministratore dell'organizzazione. |
|
Ultima modifica
|
at | string |
Data dell'ultima modifica dell'organizzazione. |
|
Creato all'indirizzo
|
created_at | string |
Data di creazione dell'organizzazione. |
|
ID organizzazione
|
id | integer |
ID organizzazione. |
|
Più aree di lavoro abilitate
|
is_multi_workspace_enabled | boolean |
È true quando l'opzione dell'organizzazione is_multi_workspace_enabled è impostata. |
|
Is Unified
|
is_unified | boolean |
Organizzazione unificata. |
|
Numero massimo di giorni di conservazione dei dati
|
max_data_retention_days | object |
Fino a quando le aree di lavoro gratuite in questa organizzazione possono accedere ai dati. |
|
Numero massimo di aree di lavoro
|
max_workspaces | integer |
Numero massimo di aree di lavoro consentite per l'organizzazione. |
|
Nome organizzazione
|
name | string |
Nome organizzazione. |
|
Proprietario
|
owner | boolean |
Indica se il richiedente è un proprietario dell'organizzazione. |
|
Permissions
|
permissions | array of string |
Autorizzazioni per l'organizzazione. |
|
Piano tariffario Enterprise
|
pricing_plan_enterprise | boolean |
Il piano di sottoscrizione è un piano aziendale. |
|
ID piano tariffario
|
pricing_plan_id | integer |
ID piano organizzazione. |
|
Nome piano tariffario
|
pricing_plan_name | string |
Il nome del piano di sottoscrizione in cui è attualmente attiva l'organizzazione. |
|
Sospeso all'indirizzo
|
suspended_at | string |
Indica se l'organizzazione è attualmente sospesa. |
|
trial_info
|
trial_info | TrialInfo | |
|
Conteggio utenti
|
user_count | integer |
Numero di utenti dell'organizzazione. |
TrialInfo
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Può avere una versione di valutazione
|
can_have_trial | boolean |
È true se né l'organizzazione né il proprietario non ha mai avuto una versione di valutazione prima. |
|
ULTIMO ID piano tariffario
|
last_pricing_plan_id | integer |
ID ultimo piano tariffario. |
|
Data di pagamento successiva
|
next_payment_date | string |
Data di pagamento successiva. |
|
Trial
|
trial | boolean |
Indica se la sottoscrizione dell'organizzazione è attualmente in fase di valutazione. |
|
Versione di valutazione disponibile
|
trial_available | boolean |
Quando è disponibile una versione di valutazione per questa organizzazione (deprecata). |
|
Data di fine versione di valutazione
|
trial_end_date | string |
Data di fine della versione di valutazione. |
|
ID piano di valutazione
|
trial_plan_id | integer |
ID piano di valutazione. |
TrackReminder
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Creato all'indirizzo
|
created_at | string |
Tempo di creazione del promemoria. |
|
Frequenza
|
frequency | integer |
La frequenza del promemoria in giorni deve essere 1 o 7. |
|
ID gruppo
|
group_ids | array of integer |
ID di gruppi a cui inviare il promemoria. |
|
ID promemoria
|
reminder_id | integer |
ID promemoria. |
|
Soglia
|
threshold | integer |
Soglia è il numero di ore dopo le quali verrà inviato il promemoria. |
|
ID utente
|
user_ids | array of integer |
ID utente a cui inviare il promemoria. |
|
ID area di lavoro
|
workspace_id | integer |
ID area di lavoro. |
TrackRemindersResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Tenere traccia dei promemoria
|
items | array of TrackReminder |
Restituisce un elenco di promemoria di traccia. |
BulkEditResponse
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Errori
|
failure | array of BulkEditFailure |
Elenco di operazioni non riuscite. |
|
ID operazione riuscita
|
success | array of integer |
ID per cui la patch ha avuto esito positivo. |
BulkEditFailure
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID non riuscito
|
id | integer |
ID per il quale l'operazione di patch non è riuscita. |
|
Messaggio di errore
|
message | string |
Motivo dell'errore dell'operazione. |
WorkspaceUser
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
2FA abilitata
|
2fa_enabled | boolean |
Flag che indica se l'uso è abilitato o meno per 2FA. |
|
Active
|
active | boolean |
Flag che indica se l'utente ha accettato l'invito. |
|
Admin
|
admin | boolean |
Flag che indica se l'utente è amministratore. |
|
Ultimo aggiornamento
|
at | string |
Timestamp dell'ultimo aggiornamento. |
|
Avatar URL
|
avatar_file_name | string |
URL dell'avatar. |
|
Email
|
string |
Indirizzo di posta elettronica dell'utente. |
|
|
ID gruppo
|
group_ids | array of integer |
Elenco di gruppi a cui appartiene l'utente. |
|
ID area di lavoro utente
|
id | integer |
Identificatore dell'area di lavoro utente. |
|
Inattivi
|
inactive | boolean |
Flag che indica se l'utente è stato disattivato dall'amministratore dell'area di lavoro. |
|
Codice di invito
|
invitation_code | string |
Codice di invito interno. |
|
URL invito
|
invite_url | string |
URL dell'invito interno. |
|
Membro diretto
|
is_direct | boolean |
Flag che indica se l'utente è un membro diretto dell'area di lavoro (non è assegnato all'area di lavoro usando il gruppo). |
|
Costo manodopera
|
labor_cost | double |
Costo del lavoro assegnato all'utente. |
|
Costo lavoro ultimo aggiornamento
|
labor_cost_last_updated | string |
Timestamp dell'ultimo aggiornamento dei costi del lavoro. |
|
Nome
|
name | string |
Nome dell'utente. |
|
Amministratore dell'organizzazione
|
organization_admin | boolean |
Flag che indica se l'utente è amministratore all'interno dell'organizzazione. |
|
Rate
|
rate | double |
Frequenza assegnata all'utente. |
|
Rate Last Updated
|
rate_last_updated | string |
Timestamp dell'ultimo aggiornamento della frequenza. |
|
Ruolo
|
role | string |
Ruolo dell'utente. |
|
ID ruolo
|
role_id | integer |
ID ruolo. |
|
Timezone
|
timezone | string |
Fuso orario dell'utente. |
|
ID utente globale
|
uid | integer |
Identificatore utente globale. |
|
ID utente
|
user_id | integer |
Campo JSON alternativo userID, usato solo da get-organization-workspaces-workspaceusers. |
|
Visualizzare le tariffe fatturabili di modifica
|
view_edit_billable_rates | boolean |
Flag di autorizzazione per la frequenza granulare. Ha effetto solo sui ruoli con autorizzazioni di frequenza condizionale. |
|
Visualizzare modifica costi di manodopera
|
view_edit_labor_costs | boolean |
Visualizzare l'autorizzazione di modifica dei costi di manodopera. |
|
ID area di lavoro
|
wid | integer |
Identificatore dell'area di lavoro. |
|
Ore lavorative in minuti
|
working_hours_in_minutes | integer |
Valore dell'orario di lavoro in minuti. |
|
Amministratore dell'area di lavoro
|
workspace_admin | boolean |
Flag che indica se l'utente è amministratore all'interno dell'area di lavoro. |
|
ID area di lavoro
|
workspace_id | integer |
Campo JSON alternativo userID, usato solo da get-organization-workspaces-workspaceusers. |
Rate
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Importo
|
amount | double |
Importo della tariffa. |
|
Creato all'indirizzo
|
created_at | string |
Data di creazione della frequenza. |
|
ID creatore
|
creator_id | integer |
ID creatore. |
|
Eliminato all'indirizzo
|
deleted_at | string |
Data di eliminazione della frequenza, nel caso in cui sia null significa che le tariffe sono attive. |
|
Data di fine
|
end | string |
Data di fine della tariffa. |
|
ID frequenza
|
id | integer |
Identificatore della frequenza. |
|
ID attività pianificata
|
planned_task_id | integer |
ID attività pianificata a cui viene applicata la frequenza. |
|
ID del progetto
|
project_id | integer |
ID progetto a cui viene applicata la frequenza. |
|
ID utente progetto
|
project_user_id | integer |
ID utente progetto a cui viene applicata la frequenza. |
|
Modalità di modifica della frequenza
|
rate_change_mode | string |
Modalità di modifica della frequenza. |
|
Data di inizio
|
start | string |
Data di inizio della tariffa. |
|
TIPO
|
type | string |
Tipo di frequenza. |
|
Aggiornato all'indirizzo
|
updated_at | string |
Data dell'ultimo aggiornamento della tariffa. |
|
ID area di lavoro
|
workspace_id | integer |
ID area di lavoro a cui viene applicata la frequenza. |
|
ID utente dell'area di lavoro
|
workspace_user_id | integer |
ID utente dell'area di lavoro a cui viene applicata la frequenza. |
WorkspaceStatistics
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Amministratori
|
admins | array of WorkspaceAdmin |
Elenco di amministratori dell'area di lavoro. |
|
Conteggio gruppi
|
groups_count | integer |
Numero di gruppi nell'area di lavoro. |
|
Conteggio membri
|
members_count | integer |
Numero di membri nell'area di lavoro. |
WorkspaceAdmin
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Nome
|
name | string |
Nome amministratore. |
|
ID utente
|
user_id | integer |
ID utente amministratore. |
TimeEntryConstraints
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Descrizione obbligatoria
|
description_present | boolean |
La descrizione è necessaria per le voci temporali. |
|
Progetto obbligatorio
|
project_present | boolean |
Il progetto è obbligatorio per le voci temporali. |
|
Tag obbligatorio
|
tag_present | boolean |
Il tag è obbligatorio per le voci temporali. |
|
Attività obbligatoria
|
task_present | boolean |
L'attività è necessaria per le voci temporali. |
|
Vincoli abilitati
|
time_entry_constraints_enabled | boolean |
I vincoli di immissione del tempo sono abilitati. |
WorkspaceUserSimple
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Email
|
string |
Indirizzo di posta elettronica dell'utente. |
|
|
Nome completo
|
fullname | string |
Nome dell'utente. |
|
ID utente
|
id | integer |
Identificatore utente globale. |
|
Inattivi
|
inactive | boolean |
Inattivo indica se l'utente è disattivato o meno nell'area di lavoro. |
|
È attivo
|
is_active | boolean |
IsActive indica se l'utente ha aggiunto l'area di lavoro. |
|
Amministratore (deprecato)
|
is_admin | boolean |
Flag che indica se l'utente è amministratore (deprecato). |
|
Ruolo
|
role | string |
Ruolo dell'utente. |
ProjectUser
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Ultima modifica
|
at | string |
Data dell'ultima modifica. |
|
ID gruppo (legacy)
|
gid | integer |
ID gruppo, campo legacy. |
|
ID del Gruppo
|
group_id | integer |
ID gruppo. |
|
ID utente progetto
|
id | integer |
ID utente progetto. |
|
Costo manodopera
|
labor_cost | double |
Costo del lavoro per questo utente del progetto. |
|
Costo lavoro ultimo aggiornamento
|
labor_cost_last_updated | string |
Data dell'ultimo aggiornamento del costo del lavoro. |
|
Direttore
|
manager | boolean |
Indica se l'utente è responsabile del progetto. |
|
ID del progetto
|
project_id | integer |
ID progetto. |
|
Rate
|
rate | double |
Frequenza per l'utente del progetto. |
|
Rate Last Updated
|
rate_last_updated | string |
Data dell'ultimo aggiornamento della frequenza. |
|
ID utente
|
user_id | integer |
ID utente. |
|
ID area di lavoro
|
workspace_id | integer |
ID area di lavoro. |
TimeEntryWebhookEvent
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
ID evento
|
event_id | integer |
Identificatore univoco per l'evento webhook. |
|
ID sottoscrizione
|
subscription_id | integer |
ID della sottoscrizione webhook che ha attivato questo evento. |
|
Evento creato all'indirizzo
|
created_at | string |
Al momento della creazione dell'evento. |
|
Timestamp dell'evento
|
timestamp | string |
Quando l'evento è stato inviato. |
|
ID creatore
|
creator_id | integer |
ID dell'utente che ha attivato l'evento. |
|
Callback URL (URL callback)
|
url_callback | string |
URL di callback per questo evento. |
|
Tipo di richiesta
|
metadata.request_type | string |
Tipo di richiesta che ha attivato l'evento. |
|
ID utente evento
|
metadata.event_user_id | integer |
ID dell'utente associato all'evento. |
|
Action
|
metadata.action | string |
Azione eseguita (creata, aggiornata, eliminata, avviata, arrestata). |
|
payload
|
payload | TimeEntry |