Udostępnij przez


Toggl Track (niezależny wydawca) (wersja zapoznawcza)

Jedyne oprogramowanie do śledzenia czasu, które tworzy niestandardowe raporty z danych czasowych twojego zespołu w celu zmaksymalizowania produktywności i przychodów. Nasze rozwiązanie do śledzenia czasu rejestruje oś czasu kalendarza wszystkich działań służbowych przez cały dzień.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Troy Taylor
adres URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Metadane łącznika
Publisher troystaylor
Witryna internetowa https://toggl.com/track/automated-time-tracker/
Zasady ochrony prywatności https://toggl.com/legal/track/privacy/
Kategorie Produktywność

Toggl Track

Jedyne oprogramowanie do śledzenia czasu, które tworzy niestandardowe raporty z danych czasowych twojego zespołu w celu zmaksymalizowania produktywności i przychodów. Nasze rozwiązanie do śledzenia czasu rejestruje oś czasu kalendarza wszystkich działań służbowych przez cały dzień.

Wydawca: Troy Taylor, Spółka Solutions

Wymagania wstępne

Musisz zarejestrować się w celu uzyskania konta w usłudze Toggl.

Uzyskiwanie poświadczeń

Ten łącznik używa uwierzytelniania podstawowego przy użyciu adresu e-mail i hasła.

Obsługiwane operacje

Pobieranie bieżącego użytkownika

Zwraca szczegóły bieżącego użytkownika.

Aktualizowanie bieżącego użytkownika

Aktualizuje szczegóły bieżącego użytkownika.

Pobieranie klientów użytkowników

Pobierz klientów dla bieżącego użytkownika.

Uzyskiwanie funkcji użytkownika

Pobierz funkcje dostępne dla bieżącego użytkownika.

Uzyskiwanie lokalizacji użytkownika

Zwraca lokalizację opartą na adresie IP klienta. Jeśli żadne dane nie są obecne, zostanie zwrócona pusta odpowiedź.

Sprawdzanie uwierzytelniania

Służy do sprawdzania, czy uwierzytelnianie działa.

Pobieranie organizacji użytkowników

Pobieranie wszystkich organizacji danego użytkownika jest częścią.

Pobieranie projektów użytkowników

Pobieranie projektów dla bieżącego użytkownika.

Pobieranie projektów użytkowników podzielonych na strony

Pobieranie projektów podzielonych na strony dla bieżącego użytkownika.

Pobieranie tagów użytkowników

Zwraca tagi dla bieżącego użytkownika.

Pobieranie zadań użytkownika

Zwraca zadania z projektów, w których uczestniczy użytkownik.

Pobieranie przypomnień o śledzeniu

Zwraca listę przypomnień dotyczących śledzenia.

Pobieranie czasomierza internetowego

Uzyskaj konfigurację czasomierza internetowego.

Pobieranie obszarów roboczych użytkowników

Wyświetla listę obszarów roboczych dla danego użytkownika.

Pobieranie wpisów czasu

Wyświetla listę najnowszych wpisów czasu.

Pobieranie bieżącego wpisu czasu

Załaduj wpis czasu uruchomienia dla identyfikatora użytkownika.

Uzyskiwanie wpisu czasu według identyfikatora

Załaduj wpis czasu według identyfikatora, który jest dostępny dla bieżącego użytkownika.

Pobieranie użytkowników obszaru roboczego (poziom organizacji)

Zwraca wszystkich użytkowników, którzy należą do obszaru roboczego bezpośrednio lub za pośrednictwem co najmniej jednej grupy.

Pobieranie użytkowników obszaru roboczego

Wyświetl listę wszystkich użytkowników dla danego obszaru roboczego.

Pobieranie użytkowników projektu obszaru roboczego

Wyświetl listę wszystkich użytkowników projektów dla danego obszaru roboczego.

Pobieranie klientów użytkowników

Pobierz klientów dla bieżącego użytkownika.

Pobieranie organizacji użytkowników

Pobieranie wszystkich organizacji danego użytkownika jest częścią.

Pobieranie użytkowników obszaru roboczego (poziom organizacji)

Zwraca wszystkich użytkowników, którzy należą do obszaru roboczego bezpośrednio lub za pośrednictwem co najmniej jednej grupy.

Pobieranie projektów użytkowników

Pobieranie projektów dla bieżącego użytkownika.

Pobieranie projektów użytkowników podzielonych na strony

Pobieranie projektów podzielonych na strony dla bieżącego użytkownika.

Pobieranie użytkowników projektu obszaru roboczego

Wyświetl listę wszystkich użytkowników projektów dla danego obszaru roboczego.

Pobieranie projektów obszaru roboczego

Pobieranie projektów dla danego obszaru roboczego.

Pobieranie projektu obszaru roboczego

Pobierz projekt dla danego obszaru roboczego.

Pobieranie tagów użytkowników

Zwraca tagi dla bieżącego użytkownika.

Pobieranie zadań użytkownika

Zwraca zadania z projektów, w których uczestniczy użytkownik.

Pobieranie obszarów roboczych użytkowników

Wyświetla listę obszarów roboczych dla danego użytkownika.

Tworzenie wpisu czasu

Tworzy nowy wpis czasu obszaru roboczego.

Usuwanie wpisu czasu

Usuwa wpis czasu obszaru roboczego.

Aktualizowanie wpisu czasu

Aktualizuje wpis czasu obszaru roboczego.

Zbiorcze edytowanie wpisów czasu

Zbiorcze edytowanie wpisów czasu. Poprawka zostanie wykonana częściowo, gdy wystąpią błędy z niektórymi rekordami. Brak transakcji, bez wycofywania.

Wpis czasu zatrzymania

Zatrzymuje wpis czasu obszaru roboczego.

Pobieranie użytkowników obszaru roboczego (poziom organizacji)

Zwraca wszystkich użytkowników, którzy należą do obszaru roboczego bezpośrednio lub za pośrednictwem co najmniej jednej grupy.

Uzyskiwanie pojedynczego obszaru roboczego

Uzyskaj informacje o pojedynczym obszarze roboczym.

Pobieranie listy stawek

Pobieranie stawek według poziomu (obszar roboczy|projekt|zadanie|użytkownik).

Pobieranie statystyk obszaru roboczego

Zwraca listę administratorów obszaru roboczego, liczbę członków i liczbę grup.

Pobieranie ograniczeń dotyczących wprowadzania czasu obszaru roboczego

Uzyskaj ograniczenia dotyczące wprowadzania czasu dla danego obszaru roboczego.

Pobieranie przypomnień dotyczących śledzenia obszaru roboczego

Zwraca listę przypomnień dotyczących śledzenia.

Pobieranie użytkowników obszaru roboczego

Wyświetl listę wszystkich użytkowników dla danego obszaru roboczego.

Pobieranie użytkowników projektu obszaru roboczego

Wyświetl listę wszystkich użytkowników projektów dla danego obszaru roboczego.

Pobieranie projektów obszaru roboczego

Pobieranie projektów dla danego obszaru roboczego.

Pobieranie projektu obszaru roboczego

Pobierz projekt dla danego obszaru roboczego.

Pobieranie wpisów czasu

Wyświetla listę najnowszych wpisów czasu.

Pobieranie bieżącego wpisu czasu

Załaduj wpis czasu uruchomienia dla identyfikatora użytkownika.

Uzyskiwanie wpisu czasu według identyfikatora

Załaduj wpis czasu według identyfikatora, który jest dostępny dla bieżącego użytkownika.

Po utworzeniu wpisu czasu

Wyzwala wyzwalane po utworzeniu nowego wpisu czasu w obszarze roboczym.

Po zaktualizowaniu wpisu czasu

Wyzwala, gdy istniejący wpis czasu zostanie zmodyfikowany w obszarze roboczym.

Po usunięciu wpisu czasu

Wyzwala, gdy wpis czasu zostanie usunięty z obszaru roboczego.

Po uruchomieniu wpisu czasu

Wyzwala wyzwalane po uruchomieniu wpisu czasu (rozpoczyna się czasomierz) w obszarze roboczym.

Po zatrzymaniu wpisu czasu

Wyzwalacze po zatrzymaniu wpisu czasu uruchomienia w obszarze roboczym.

Znane problemy i ograniczenia

Obecnie nie ma znanych problemów.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: Wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Nazwa użytkownika securestring Nazwa użytkownika dla tego interfejsu API Prawda
Hasło securestring Hasło dla tego interfejsu API Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Aktualizowanie bieżącego użytkownika

Aktualizuje szczegóły bieżącego użytkownika.

Aktualizowanie wpisu czasu

Aktualizuje wpis czasu obszaru roboczego.

Pobieranie bieżącego użytkownika

Zwraca szczegóły bieżącego użytkownika.

Pobieranie bieżącego wpisu czasu

Załaduj wpis czasu uruchomienia dla identyfikatora użytkownika.

Pobieranie czasomierza internetowego

Uzyskaj konfigurację czasomierza internetowego.

Pobieranie klientów użytkowników

Pobierz klientów dla bieżącego użytkownika.

Pobieranie listy stawek

Pobieranie stawek według poziomu (obszar roboczy|projekt|zadanie|użytkownik).

Pobieranie obszarów roboczych użytkowników

Wyświetla listę obszarów roboczych dla danego użytkownika.

Pobieranie ograniczeń dotyczących wprowadzania czasu obszaru roboczego

Uzyskaj ograniczenia dotyczące wprowadzania czasu dla danego obszaru roboczego.

Pobieranie organizacji użytkowników

Pobieranie wszystkich organizacji danego użytkownika jest częścią.

Pobieranie projektu obszaru roboczego

Pobierz projekt dla danego obszaru roboczego.

Pobieranie projektów obszaru roboczego

Pobieranie projektów dla danego obszaru roboczego.

Pobieranie projektów użytkowników

Pobieranie projektów dla bieżącego użytkownika.

Pobieranie projektów użytkowników podzielonych na strony

Pobieranie projektów podzielonych na strony dla bieżącego użytkownika.

Pobieranie przypomnień dotyczących śledzenia obszaru roboczego

Zwraca listę przypomnień dotyczących śledzenia.

Pobieranie przypomnień o śledzeniu

Zwraca listę przypomnień dotyczących śledzenia.

Pobieranie statystyk obszaru roboczego

Zwraca listę administratorów obszaru roboczego, liczbę członków i liczbę grup.

Pobieranie tagów użytkowników

Zwraca tagi dla bieżącego użytkownika.

Pobieranie użytkowników obszaru roboczego

Wyświetl listę wszystkich użytkowników dla danego obszaru roboczego.

Pobieranie użytkowników obszaru roboczego (poziom organizacji)

Zwraca wszystkich użytkowników, którzy należą do obszaru roboczego bezpośrednio lub za pośrednictwem co najmniej jednej grupy.

Pobieranie użytkowników projektu obszaru roboczego

Wyświetl listę wszystkich użytkowników projektów dla danego obszaru roboczego.

Pobieranie wpisów czasu

Wyświetla listę najnowszych wpisów czasu.

Pobieranie zadań użytkownika

Zwraca zadania z projektów, w których uczestniczy użytkownik.

Sprawdzanie uwierzytelniania

Służy do sprawdzania, czy uwierzytelnianie działa.

Tworzenie wpisu czasu

Tworzy nowy obszar roboczy TimeEntry.

Usuwanie wpisu czasu

Usuwa wpis czasu obszaru roboczego.

Uzyskiwanie funkcji użytkownika

Pobierz funkcje dostępne dla bieżącego użytkownika.

Uzyskiwanie lokalizacji użytkownika

Zwraca lokalizację opartą na adresie IP klienta. Jeśli żadne dane nie są obecne, zostanie zwrócona pusta odpowiedź.

Uzyskiwanie pojedynczego obszaru roboczego

Uzyskaj informacje o pojedynczym obszarze roboczym.

Uzyskiwanie wpisu czasu według identyfikatora

Załaduj wpis czasu według identyfikatora, który jest dostępny dla bieżącego użytkownika.

Wpis czasu zatrzymania

Zatrzymuje wpis czasu obszaru roboczego.

Zbiorcze edytowanie wpisów czasu

Zbiorcze edytowanie wpisów czasu. Poprawka zostanie wykonana częściowo, gdy wystąpią błędy z niektórymi rekordami. Brak transakcji, bez wycofywania.

Aktualizowanie bieżącego użytkownika

Aktualizuje szczegóły bieżącego użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Początek tygodnia
beginning_of_week integer

Pierwszy dzień tygodnia użytkownika. Niedziela: 0, poniedziałek: 1, itp.

Identyfikator kraju
country_id integer

Identyfikator kraju użytkownika.

Bieżące hasło
current_password string

Bieżące hasło użytkownika (używane do zmiany bieżącego hasła).

Domyślny identyfikator obszaru roboczego
default_workspace_id integer

Domyślny identyfikator obszaru roboczego użytkownika.

Email
email string

Adres e-mail użytkownika.

Pełna nazwa
fullname string

Pełna nazwa użytkownika.

Nowe hasło
password string

Nowe hasło użytkownika (należy również podać bieżące).

Strefa czasowa
timezone string

Strefa czasowa użytkownika.

Zwraca

Aktualizowanie wpisu czasu

Aktualizuje wpis czasu obszaru roboczego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Identyfikator wpisu czasu
time_entry_id True integer

TimeEntry ID.

Dołączanie metadanych
meta boolean

Jeśli odpowiedź zawiera dane dla jednostek meta.

Dołączanie udostępniania
include_sharing boolean

Dołącz szczegóły udostępniania w odpowiedzi.

Płatne
billable boolean

Czy wpis czasu jest oznaczony jako rozliczany, opcjonalny, domyślny fałsz.

Utworzono za pomocą polecenia
created_with string

Należy podać podczas tworzenia wpisu czasu i należy zidentyfikować usługę/aplikację używaną do jej utworzenia.

Description
description string

Opis wpisu czasu, opcjonalny.

Czas trwania
duration integer

Czas trwania wpisu czasu. W przypadku uruchomionych wpisów powinny być ujemne, najlepiej -1.

Tylko czas trwania
duronly boolean

Przestarzałe: służy do tworzenia wpisu czasu z czasem trwania, ale bez czasu zatrzymania. Ten parametr można zignorować.

Funkcja źródła
origin_feature string

Nazwa funkcji źródła.

Widoczna liczba celów
visible_goals_count integer

Liczba widocznych celów.

Identyfikatory wydatków
expense_ids array of integer

Wydatki pracy skojarzone z wpisem czasu.

Identyfikator projektu (starsza wersja)
pid integer

Identyfikator projektu, starsze pole.

Identyfikator projektu
project_id integer

Identyfikator projektu, opcjonalnie.

Udostępnione identyfikatory użytkowników
shared_with_user_ids array of integer

Lista identyfikatorów użytkowników do udostępnienia tego wpisu czasu.

Godzina rozpoczęcia
start string

Godzina rozpoczęcia w formacie UTC wymagana do utworzenia. Format: 2006-01-02T15:04:05Z.

Data rozpoczęcia
start_date string

Jeśli zostanie podana podczas tworzenia, część daty będzie mieć pierwszeństwo przed częścią daty "start". Format: 2006-11-07.

Czas zatrzymania
stop string

Czas zatrzymania w formacie UTC można pominąć, jeśli nadal jest uruchomiony lub utworzony z wartością "duration". Jeśli podano wartości "stop" i "duration", wartości muszą być spójne (start + duration == stop).

Akcja tagu
tag_action string

Może to być wartość "add" lub "delete". Używany podczas aktualizowania istniejącego wpisu czasu.

Identyfikatory tagów
tag_ids array of integer

Identyfikatory tagów do dodawania/usuwania.

Etykiety
tags array of string

Nazwy tagów do dodania/usunięcia. Jeśli nazwa nie istnieje jako tag, zostanie utworzona automatycznie.

Identyfikator zadania
task_id integer

Identyfikator zadania, opcjonalnie.

Identyfikator zadania (starsza wersja)
tid integer

Identyfikator zadania, starsze pole.

Identyfikator użytkownika (starsza wersja)
uid integer

Identyfikator twórcy wpisu czasowego, starsze pole.

Identyfikator użytkownika
user_id integer

Identyfikator twórcy wpisu czasowego, jeśli pominięty użyje identyfikatora użytkownika osoby żądającego.

Identyfikator obszaru roboczego (starsza wersja)
wid integer

Identyfikator obszaru roboczego, starsze pole.

Identyfikator obszaru roboczego
workspace_id integer

Wymagany identyfikator obszaru roboczego.

Zwraca

Body
TimeEntry

Pobieranie bieżącego użytkownika

Zwraca szczegóły bieżącego użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uwzględnij powiązane dane
with_related_data boolean

Pobieranie danych powiązanych z użytkownikiem (klientów, projektów, zadań, tagów, obszarów roboczych, wpisów czasu itp.).

Zwraca

Pobieranie bieżącego wpisu czasu

Załaduj wpis czasu uruchomienia dla identyfikatora użytkownika.

Zwraca

Body
TimeEntry

Pobieranie czasomierza internetowego

Uzyskaj konfigurację czasomierza internetowego.

Pobieranie klientów użytkowników

Pobierz klientów dla bieżącego użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Od daty
since integer

Pobierz elementy utworzone/zmodyfikowane/usunięte od tej daty przy użyciu znacznika czasu systemu UNIX.

Zwraca

response
array of Client

Pobieranie listy stawek

Pobieranie stawek według poziomu (obszar roboczy|projekt|zadanie|użytkownik).

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Level
level True string

Poziom stawek: obszar roboczy, projekt, zadanie lub użytkownik.

Identyfikator poziomu
level_id True integer

Numeryczny identyfikator poziomu jednostki.

Typ stawki
type string

Typ zwracanych wartości szybkości: billable_rates lub labor_costs. Wartość domyślna to billable_rates.

Zwraca

response
array of Rate

Pobieranie obszarów roboczych użytkowników

Wyświetla listę obszarów roboczych dla danego użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Od daty
since integer

Pobierz elementy utworzone/zmodyfikowane/usunięte od tej daty przy użyciu znacznika czasu systemu UNIX.

Zwraca

Pobieranie ograniczeń dotyczących wprowadzania czasu obszaru roboczego

Uzyskaj ograniczenia dotyczące wprowadzania czasu dla danego obszaru roboczego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Zwraca

Pobieranie organizacji użytkowników

Pobieranie wszystkich organizacji danego użytkownika jest częścią.

Zwraca

Pobieranie projektu obszaru roboczego

Pobierz projekt dla danego obszaru roboczego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Identyfikator projektu
project_id True integer

Numeryczny identyfikator projektu.

Zwraca

Body
Project

Pobieranie projektów obszaru roboczego

Pobieranie projektów dla danego obszaru roboczego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Sortuj przypięte
sort_pinned True boolean

Umieść przypięte projekty na początku odpowiedzi.

Tylko aktywni użytkownicy
active boolean

Zwraca tylko aktywnych użytkowników.

Od daty
since integer

Pobierz elementy utworzone/zmodyfikowane/usunięte od tej daty przy użyciu znacznika czasu systemu UNIX.

Płatne
billable boolean

Filtruj według stanu rozliczanego.

Identyfikatory użytkowników
user_ids array

Identyfikatory użytkowników do filtrowania według.

Identyfikatory klientów
client_ids array

Identyfikatory klientów do filtrowania według.

Identyfikatory grup
group_ids array

Identyfikatory grup do filtrowania według.

Identyfikatory projektów
project_ids string

Identyfikatory liczbowe projektów rozdzielone przecinkami.

Statusy
statuses array

Stany projektu do filtrowania według.

Filtr nazw
name string

Nazwa użytkownika obszaru roboczego do filtrowania według.

Numer strony
page integer

Numer strony.

Sortuj pole
sort_field True string

Pole do sortowania według.

Kolejność sortowania
sort_order True string

Kolejność sortowania (asc/desc).

Tylko szablony
only_templates True boolean

Zwracaj tylko szablony projektów.

Tylko moje projekty
only_me boolean

Pobierz tylko projekty przypisane do bieżącego użytkownika.

Elementy na stronę
per_page integer

Liczba elementów na stronę, domyślna 201.

Zwraca

response
array of Project

Pobieranie projektów użytkowników

Pobieranie projektów dla bieżącego użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uwzględnij zarchiwizowane
include_archived string

Uwzględnij zarchiwizowane projekty.

Od daty
since integer

Pobierz elementy utworzone/zmodyfikowane/usunięte od tej daty przy użyciu znacznika czasu systemu UNIX.

Zwraca

response
array of Project

Pobieranie projektów użytkowników podzielonych na strony

Pobieranie projektów podzielonych na strony dla bieżącego użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Uruchom identyfikator projektu
start_project_id integer

Identyfikator projektu w celu wznowienia następnej stronicowania.

Od daty
since integer

Pobierz elementy utworzone/zmodyfikowane/usunięte od tej daty przy użyciu znacznika czasu systemu UNIX.

Elementy na stronę
per_page integer

Liczba elementów na stronę, domyślna 201.

Zwraca

response
array of Project

Pobieranie przypomnień dotyczących śledzenia obszaru roboczego

Zwraca listę przypomnień dotyczących śledzenia.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Zwraca

Pobieranie przypomnień o śledzeniu

Zwraca listę przypomnień dotyczących śledzenia.

Zwraca

Pobieranie statystyk obszaru roboczego

Zwraca listę administratorów obszaru roboczego, liczbę członków i liczbę grup.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Zwraca

Pobieranie tagów użytkowników

Zwraca tagi dla bieżącego użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Od daty
since integer

Pobierz elementy utworzone/zmodyfikowane/usunięte od tej daty przy użyciu znacznika czasu systemu UNIX.

Zwraca

response
array of Tag

Pobieranie użytkowników obszaru roboczego

Wyświetl listę wszystkich użytkowników dla danego obszaru roboczego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Wyklucz usunięto
exclude_deleted boolean

Wyklucz usunięte rekordy w odpowiedzi.

Zwraca

Pobieranie użytkowników obszaru roboczego (poziom organizacji)

Zwraca wszystkich użytkowników, którzy należą do obszaru roboczego bezpośrednio lub za pośrednictwem co najmniej jednej grupy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator organizacji
organization_id True integer

Numeryczny identyfikator organizacji.

Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Numer strony
page integer

Numer strony.

Elementy na stronę
per_page integer

Liczba elementów na stronę, domyślna 201.

Filtr niestandardowych stawek
custom_rates boolean

Zwraca tylko użytkowników z lub bez niestandardowej stawki godzinowej odpowiednio.

Tylko aktywni użytkownicy
active boolean

Zwraca tylko aktywnych użytkowników.

Filtr nazw
name string

Nazwa użytkownika obszaru roboczego do filtrowania według.

Filtr wyszukiwania
search string

Filtruj obszar roboczy według nazwy lub wiadomości e-mail.

Zwraca

Pobieranie użytkowników projektu obszaru roboczego

Wyświetl listę wszystkich użytkowników projektów dla danego obszaru roboczego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Identyfikatory projektów
project_ids string

Identyfikatory liczbowe projektów rozdzielone przecinkami.

Identyfikator użytkownika
user_id string

Numeryczny identyfikator użytkownika, jeśli przekazany zwraca tylko użytkowników projektu dla projektów tego użytkownika.

Dołączanie członków grupy
with_group_members boolean

Uwzględnij członków grupy.

Zwraca

Pobieranie wpisów czasu

Wyświetla listę najnowszych wpisów czasu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Dołączanie metadanych
meta boolean

Jeśli odpowiedź zawiera dane dla jednostek meta.

Dołączanie udostępniania
include_sharing boolean

Dołącz szczegóły udostępniania w odpowiedzi.

Od daty
since integer

Pobierz elementy utworzone/zmodyfikowane/usunięte od tej daty przy użyciu znacznika czasu systemu UNIX.

Przed datą
before string

Pobierz wpisy z godziną rozpoczęcia, przed daną datą (RRRR-MM-DD) lub godziną w formacie RFC3339.

Data rozpoczęcia
start_date string

Pobierz wpisy z czasem rozpoczęcia, od start_date RRRR-MM-DD lub z czasem w formacie RFC3339. Do użycia z end_date.

Data zakończenia
end_date string

Pobierz wpisy z czasem rozpoczęcia, aż end_date RRRR-MM-DD lub z czasem w formacie RFC3339. Do użycia z start_date.

Zwraca

Pobieranie zadań użytkownika

Zwraca zadania z projektów, w których uczestniczy użytkownik.

Parametry

Nazwa Klucz Wymagane Typ Opis
Dołączanie metadanych
meta boolean

Jeśli odpowiedź zawiera dane dla jednostek meta.

Od daty
since integer

Pobierz elementy utworzone/zmodyfikowane/usunięte od tej daty przy użyciu znacznika czasu systemu UNIX.

Uwzględnij zadania nieaktywne
include_not_active string

Uwzględnij zadania oznaczone jako gotowe.

Przesunięcie stronicowania
offset integer

Przesunięcie, aby wznowić kolejną stronicowanie z.

Elementy na stronę
per_page integer

Liczba elementów na stronę, domyślna 201.

Zwraca

response
array of Task

Sprawdzanie uwierzytelniania

Służy do sprawdzania, czy uwierzytelnianie działa.

Tworzenie wpisu czasu

Tworzy nowy obszar roboczy TimeEntry.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Dołączanie metadanych
meta boolean

Jeśli odpowiedź zawiera dane dla jednostek meta.

Płatne
billable boolean

Czy wpis czasu jest oznaczony jako rozliczany, opcjonalny, domyślny fałsz.

Utworzono za pomocą polecenia
created_with string

Należy podać podczas tworzenia wpisu czasu i należy zidentyfikować usługę/aplikację używaną do jej utworzenia.

Description
description string

Opis wpisu czasu, opcjonalny.

Czas trwania
duration integer

Czas trwania wpisu czasu. W przypadku uruchomionych wpisów powinny być ujemne, najlepiej -1.

Tylko czas trwania
duronly boolean

Przestarzałe: służy do tworzenia wpisu czasu z czasem trwania, ale bez czasu zatrzymania. Ten parametr można zignorować.

Funkcja źródła
origin_feature string

Nazwa funkcji źródła.

Widoczna liczba celów
visible_goals_count integer

Liczba widocznych celów.

Identyfikatory wydatków
expense_ids array of integer

Wydatki pracy skojarzone z wpisem czasu.

Identyfikator projektu (starsza wersja)
pid integer

Identyfikator projektu, starsze pole.

Identyfikator projektu
project_id integer

Identyfikator projektu, opcjonalnie.

Udostępnione identyfikatory użytkowników
shared_with_user_ids array of integer

Lista identyfikatorów użytkowników do udostępnienia tego wpisu czasu.

Godzina rozpoczęcia
start string

Godzina rozpoczęcia w formacie UTC wymagana do utworzenia. Format: 2006-01-02T15:04:05Z.

Data rozpoczęcia
start_date string

Jeśli zostanie podana podczas tworzenia, część daty będzie mieć pierwszeństwo przed częścią daty "start". Format: 2006-11-07.

Czas zatrzymania
stop string

Czas zatrzymania w formacie UTC można pominąć, jeśli nadal jest uruchomiony lub utworzony z wartością "duration". Jeśli podano wartości "stop" i "duration", wartości muszą być spójne (start + duration == stop).

Akcja tagu
tag_action string

Może to być wartość "add" lub "delete". Używany podczas aktualizowania istniejącego wpisu czasu.

Identyfikatory tagów
tag_ids array of integer

Identyfikatory tagów do dodawania/usuwania.

Etykiety
tags array of string

Nazwy tagów do dodania/usunięcia. Jeśli nazwa nie istnieje jako tag, zostanie utworzona automatycznie.

Identyfikator zadania
task_id integer

Identyfikator zadania, opcjonalnie.

Identyfikator zadania (starsza wersja)
tid integer

Identyfikator zadania, starsze pole.

Identyfikator użytkownika (starsza wersja)
uid integer

Identyfikator twórcy wpisu czasowego, starsze pole.

Identyfikator użytkownika
user_id integer

Identyfikator twórcy wpisu czasowego, jeśli pominięty użyje identyfikatora użytkownika osoby żądającego.

Identyfikator obszaru roboczego (starsza wersja)
wid integer

Identyfikator obszaru roboczego, starsze pole.

Identyfikator obszaru roboczego
workspace_id integer

Wymagany identyfikator obszaru roboczego.

Zwraca

Body
TimeEntry

Usuwanie wpisu czasu

Usuwa wpis czasu obszaru roboczego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Identyfikator wpisu czasu
time_entry_id True integer

TimeEntry ID.

Uzyskiwanie funkcji użytkownika

Pobierz funkcje dostępne dla bieżącego użytkownika.

Zwraca

Uzyskiwanie lokalizacji użytkownika

Zwraca lokalizację opartą na adresie IP klienta. Jeśli żadne dane nie są obecne, zostanie zwrócona pusta odpowiedź.

Zwraca

Uzyskiwanie pojedynczego obszaru roboczego

Uzyskaj informacje o pojedynczym obszarze roboczym.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Zwraca

Body
Workspace

Uzyskiwanie wpisu czasu według identyfikatora

Załaduj wpis czasu według identyfikatora, który jest dostępny dla bieżącego użytkownika.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator wpisu czasu
time_entry_id True integer

TimeEntry ID.

Dołączanie metadanych
meta boolean

Jeśli odpowiedź zawiera dane dla jednostek meta.

Dołączanie udostępniania
include_sharing boolean

Dołącz szczegóły udostępniania w odpowiedzi.

Zwraca

Body
TimeEntry

Wpis czasu zatrzymania

Zatrzymuje wpis czasu obszaru roboczego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Identyfikator wpisu czasu
time_entry_id True integer

TimeEntry ID.

Zwraca

Body
TimeEntry

Zbiorcze edytowanie wpisów czasu

Zbiorcze edytowanie wpisów czasu. Poprawka zostanie wykonana częściowo, gdy wystąpią błędy z niektórymi rekordami. Brak transakcji, bez wycofywania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Identyfikatory wprowadzania czasu
time_entry_ids True string

Identyfikatory liczbowe time_entries oddzielone przecinkami. Na przykład: 204301830,202700150,202687559. Limit to 100 identyfikatorów na żądanie.

Dołączanie metadanych
meta boolean

Jeśli odpowiedź zawiera dane dla jednostek meta.

Operation
op True string

Operacja (dodawanie/usuwanie/zastępowanie).

Ścieżka
path True string

Ścieżka do jednostki do poprawki (np. /description).

Wartość
value object

Nowa wartość jednostki w ścieżce.

Zwraca

Wyzwalacze

Po uruchomieniu wpisu czasu

Wyzwala wyzwalane po uruchomieniu wpisu czasu (rozpoczyna się czasomierz) w obszarze roboczym.

Po usunięciu wpisu czasu

Wyzwala, gdy wpis czasu zostanie usunięty z obszaru roboczego.

Po utworzeniu wpisu czasu

Wyzwala wyzwalane po utworzeniu nowego wpisu czasu w obszarze roboczym.

Po zaktualizowaniu wpisu czasu

Wyzwala, gdy istniejący wpis czasu zostanie zmodyfikowany w obszarze roboczym.

Po zatrzymaniu wpisu czasu

Wyzwalacze po zatrzymaniu wpisu czasu uruchomienia w obszarze roboczym.

Po uruchomieniu wpisu czasu

Wyzwala wyzwalane po uruchomieniu wpisu czasu (rozpoczyna się czasomierz) w obszarze roboczym.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Encja
entity string

Toggl Track business entity to filter (Śledzenie jednostki biznesowej do filtrowania).

Akcja
action string

Typ modyfikacji zastosowanej do jednostki.

Zwraca

Po usunięciu wpisu czasu

Wyzwala, gdy wpis czasu zostanie usunięty z obszaru roboczego.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Encja
entity string

Toggl Track business entity to filter (Śledzenie jednostki biznesowej do filtrowania).

Akcja
action string

Typ modyfikacji zastosowanej do jednostki.

Zwraca

Po utworzeniu wpisu czasu

Wyzwala wyzwalane po utworzeniu nowego wpisu czasu w obszarze roboczym.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Encja
entity string

Toggl Track business entity to filter (Śledzenie jednostki biznesowej do filtrowania).

Akcja
action string

Typ modyfikacji zastosowanej do jednostki.

Zwraca

Po zaktualizowaniu wpisu czasu

Wyzwala, gdy istniejący wpis czasu zostanie zmodyfikowany w obszarze roboczym.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Encja
entity string

Toggl Track business entity to filter (Śledzenie jednostki biznesowej do filtrowania).

Akcja
action string

Typ modyfikacji zastosowanej do jednostki.

Zwraca

Po zatrzymaniu wpisu czasu

Wyzwalacze po zatrzymaniu wpisu czasu uruchomienia w obszarze roboczym.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator obszaru roboczego
workspace_id True integer

Numeryczny identyfikator obszaru roboczego.

Encja
entity string

Toggl Track business entity to filter (Śledzenie jednostki biznesowej do filtrowania).

Akcja
action string

Typ modyfikacji zastosowanej do jednostki.

Zwraca

Definicje

UserResponse

Nazwa Ścieżka Typ Opis
Włączone uwierzytelnianie 2FA
2fa_enabled boolean

Stan włączonego uwierzytelniania dwuskładnikowego.

Token API
api_token string

Token interfejsu API zostanie pominięty, jeśli jest pusty.

Ostatnia aktualizacja
at string

Znacznik czasu ostatniej aktualizacji.

Zaktualizowano autoryzację
authorization_updated_at string

Sygnatura czasowa ostatniej aktualizacji obiektu sesji użytkownika autoryzacji.

Początek tygodnia
beginning_of_week integer

Pierwszy dzień tygodnia użytkownika (0=niedziela, 1=poniedziałek itp.).

Clients
clients array of Client

Klienci, wartość null, jeśli with_related_data nie została ustawiona na wartość true.

Identyfikator kraju
country_id integer

Identyfikator kraju użytkownika.

Utworzono pod adresem
created_at string

Sygnatura czasowa tworzenia użytkownika.

Domyślny identyfikator obszaru roboczego
default_workspace_id integer

Domyślny identyfikator obszaru roboczego użytkownika.

Email
email string

Adres e-mail użytkownika.

Pełna nazwa
fullname string

Pełna nazwa użytkownika.

Ma hasło
has_password boolean

Czy użytkownik ma zestaw haseł.

Identyfikator użytkownika
id integer

Identyfikator użytkownika.

Adres URL obrazu
image_url string

Adres URL obrazu profilu użytkownika.

Skrót interkomu
intercom_hash string

Skrót interkomu zostanie pominięty, jeśli jest pusty.

Dostawcy OAuth
oauth_providers array of string

Dostawcy OAuth dostępni dla użytkownika.

Adres e-mail OpenID
openid_email string

Adres e-mail OpenID.

Identyfikator OpenID włączony
openid_enabled boolean

Stan włączonego uwierzytelniania OpenID.

Opcje
options object

Opcje użytkownika zostaną pominięte, jeśli są puste.

Projekty
projects array of Project

Projekty, wartość null, jeśli with_related_data nie została ustawiona na wartość true.

Etykiety
tags array of Tag

Tagi, wartość null, jeśli with_related_data nie została ustawiona na wartość true.

Tasks
tasks array of Task

Zadania, wartość null, jeśli with_related_data nie została ustawiona na wartość true.

Wpisy czasu
time_entries array of TimeEntry

Wpisy czasu, wartość null, jeśli with_related_data nie została ustawiona na wartość true.

Strefa czasowa
timezone string

Strefa czasowa użytkownika.

Zaktualizowano o
updated_at string

Znacznik czasu ostatniej aktualizacji użytkownika.

Przestrzenie robocze
workspaces array of Workspace

Obszary robocze, wartość null, jeśli with_related_data nie została ustawiona na wartość true.

UserBasicResponse

Nazwa Ścieżka Typ Opis
Włączone uwierzytelnianie 2FA
2fa_enabled boolean

Stan włączonego uwierzytelniania dwuskładnikowego.

Token API
api_token string

Token interfejsu API zostanie pominięty, jeśli jest pusty.

Ostatnia aktualizacja
at string

Znacznik czasu ostatniej aktualizacji.

Początek tygodnia
beginning_of_week integer

Pierwszy dzień tygodnia użytkownika.

Identyfikator kraju
country_id integer

Identyfikator kraju użytkownika.

Utworzono pod adresem
created_at string

Sygnatura czasowa tworzenia użytkownika.

Domyślny identyfikator obszaru roboczego
default_workspace_id integer

Domyślny identyfikator obszaru roboczego użytkownika.

Email
email string

Adres e-mail użytkownika.

Pełna nazwa
fullname string

Pełna nazwa użytkownika.

Ma hasło
has_password boolean

Czy użytkownik ma zestaw haseł.

Identyfikator użytkownika
id integer

Identyfikator użytkownika.

Adres URL obrazu
image_url string

Adres URL obrazu profilu użytkownika.

Adres e-mail OpenID
openid_email string

Adres e-mail OpenID.

Identyfikator OpenID włączony
openid_enabled boolean

Stan włączonego uwierzytelniania OpenID.

Opcje
options object

Opcje użytkownika zostaną pominięte, jeśli są puste.

Strefa czasowa
timezone string

Strefa czasowa użytkownika.

Zaktualizowano o
updated_at string

Znacznik czasu ostatniej aktualizacji użytkownika.

Client

Nazwa Ścieżka Typ Opis
Archiwizowane
archived boolean

Ma wartość true, jeśli klient jest zarchiwizowany.

Ostatnia aktualizacja
at string

Kiedy była ostatnia aktualizacja.

Identyfikator twórcy
creator_id integer

Identyfikator użytkownika, który utworzył klienta.

Dokumentacja zewnętrzna
external_reference string

Odwołanie zewnętrzne do jednostki Track Client.

ID klienta
id integer

Identyfikator klienta.

Identyfikator zewnętrzny integracji
integration_ext_id string

Identyfikator zewnętrzny połączonej jednostki w systemie zewnętrznym.

Typ zewnętrzny integracji
integration_ext_type string

Typ zewnętrzny połączonej jednostki w systemie zewnętrznym.

Dostawca integracji
integration_provider object

Dostawca, który ma jednostkę połączoną z tą jednostką Toggl Track.

Nazwa klienta
name string

Nazwa klienta.

Notatki
notes string

Uwagi klienta.

Permissions
permissions array of string

Lista uprawnień autoryzacji dla tego klienta.

Łączna liczba
total_count integer

Łączna liczba pól do przechowywania łącznej liczby.

Identyfikator obszaru roboczego
wid integer

Identyfikator obszaru roboczego.

Projekt

Nazwa Ścieżka Typ Opis
Aktywna
active boolean

Niezależnie od tego, czy projekt jest aktywny, czy zarchiwizowany.

Godziny rzeczywiste
actual_hours integer

Rzeczywiste godziny spędzone w projekcie.

Rzeczywiste sekundy
actual_seconds integer

Rzeczywiste sekundy spędzone w projekcie.

Ostatnia aktualizacja
at string

Data ostatniej aktualizacji.

Automatyczne szacowania
auto_estimates boolean

Włączone automatyczne szacowania.

Płatne
billable boolean

Czy projekt jest rozliczany.

Może śledzić czas
can_track_time boolean

Określa, czy czas można śledzić w tym projekcie.

Identyfikator klienta (starsza wersja)
cid integer

Starsze pole identyfikatora klienta.

ID klienta
client_id integer

Identyfikator klienta.

Nazwa klienta
client_name string

Nazwa klienta.

Kolor
color string

Kolor projektu.

Utworzono pod adresem
created_at string

Data utworzenia.

Waluta
currency string

Waluta projektu.

Bieżący okres
current_period object

Bieżący okres projektu, funkcja Premium.

Data zakończenia
end_date string

Data zakończenia projektu.

Szacowane godziny
estimated_hours integer

Szacowane godziny projektu.

Szacowane sekundy
estimated_seconds integer

Szacowane sekundy dla projektu.

Dokumentacja zewnętrzna
external_reference string

Odwołanie zewnętrzne do jednostki śledzenia projektu.

Stała opłata
fixed_fee double

Stała opłata, funkcja premium.

Identyfikator projektu
id integer

Identyfikator projektu.

Identyfikator zewnętrzny integracji
integration_ext_id string

Identyfikator zewnętrzny połączonej jednostki w systemie zewnętrznym.

Typ zewnętrzny integracji
integration_ext_type string

Typ zewnętrzny połączonej jednostki w systemie zewnętrznym.

Dostawca integracji
integration_provider object

Dostawca, który ma jednostkę połączoną z tą jednostką Toggl Track.

Jest prywatny
is_private boolean

Czy projekt jest prywatny.

Nazwa projektu
name string

Nazwa projektu.

Permissions
permissions array of string

Uprawnienia projektu.

Przypięte
pinned boolean

Czy projekt jest przypięty.

Stawka godzinowa
rate double

Stawka godzinowa dla projektu.

Oceń ostatnio zaktualizowano
rate_last_updated string

Kiedy stawka została ostatnio zaktualizowana.

Płatność cykliczna
recurring boolean

Czy projekt jest cykliczny, funkcja Premium.

Parametry cykliczne
recurring_parameters array of RecurringParameter

Parametry cykliczne projektu, funkcja Premium.

Data rozpoczęcia
start_date string

Data rozpoczęcia projektu.

Status
status string

Stan projektu (nadchodzący, aktywny, zakończony, zarchiwizowany, usunięty).

Template
template boolean

Czy projekt jest szablonem.

Identyfikator szablonu
template_id integer

Identyfikator szablonu, jeśli projekt jest oparty na szablonie.

Łączna liczba
total_count integer

Całkowita liczba znalezionych projektów.

Identyfikator obszaru roboczego (starsza wersja)
wid integer

Starsze pole identyfikatora obszaru roboczego.

Identyfikator obszaru roboczego
workspace_id integer

Identyfikator obszaru roboczego.

Parametr cykliczny

Nazwa Ścieżka Typ Opis
Okres niestandardowy
custom_period integer

Okres niestandardowy, używany, gdy pole kropki jest "niestandardowe".

Szacowane sekundy
estimated_seconds integer

Szacowane sekundy.

Data zakończenia parametru
parameter_end_date string

Data zakończenia parametru.

Data rozpoczęcia parametru
parameter_start_date string

Cykliczna data rozpoczęcia.

Okres
period string

Okres cykliczny.

Data rozpoczęcia projektu
project_start_date string

Data rozpoczęcia projektu.

Tag

Nazwa Ścieżka Typ Opis
Ostatnia modyfikacja
at string

Po utworzeniu/ostatniej modyfikacji.

Identyfikator twórcy
creator_id integer

Identyfikator użytkownika, który utworzył tag.

Usunięto o
deleted_at string

Kiedy został usunięty.

Identyfikator tagu
id integer

Identyfikator tagu.

Identyfikator zewnętrzny integracji
integration_ext_id string

Identyfikator zewnętrzny połączonej jednostki w systemie zewnętrznym.

Typ zewnętrzny integracji
integration_ext_type string

Typ zewnętrzny połączonej jednostki w systemie zewnętrznym.

Dostawca integracji
integration_provider object

Dostawca, który ma jednostkę połączoną z tą jednostką Toggl Track.

Nazwa tagu
name string

Nazwa tagu.

Permissions
permissions array of string

Uprawnienia tagu.

Identyfikator obszaru roboczego
workspace_id integer

Identyfikator obszaru roboczego.

Zadanie

Nazwa Ścieżka Typ Opis
Aktywna
active boolean

Fałsz, gdy zadanie zostało wykonane.

Ostatnia modyfikacja
at string

Po utworzeniu/ostatniej modyfikacji zadania.

Adres URL awatara
avatar_url string

Adres URL awatara.

Nazwa klienta
client_name string

Nazwa klienta.

Szacowane sekundy
estimated_seconds integer

Szacowane sekundy zadania.

Identyfikator zadania
id integer

Identyfikator zadania.

Identyfikator zewnętrzny integracji
integration_ext_id string

Identyfikator zewnętrzny połączonej jednostki w systemie zewnętrznym.

Typ zewnętrzny integracji
integration_ext_type string

Typ zewnętrzny połączonej jednostki w systemie zewnętrznym.

Dostawca integracji
integration_provider object

Dostawca, który ma jednostkę połączoną z tą jednostką Toggl Track.

Nazwa zadania
name string

Nazwa zadania.

Permissions
permissions array of string

Uprawnienia zadania.

Projekt rozliczany
project_billable boolean

Czy projekt jest rozliczany.

Kolor projektu
project_color string

Metadane koloru projektu.

Identyfikator projektu
project_id integer

Identyfikator projektu.

Projekt jest prywatny
project_is_private boolean

Czy projekt jest prywatny.

Nazwa projektu
project_name string

Nazwa projektu.

Rate
rate double

Oceń dla tego zadania.

Oceń ostatnio zaktualizowano
rate_last_updated string

Kiedy stawka została ostatnio zaktualizowana.

Płatność cykliczna
recurring boolean

Czy jest to zadanie cykliczne.

Identyfikator kont toggl
toggl_accounts_id string

Identyfikator kont toggl.

Śledzone sekundy
tracked_seconds integer

Wartość tracked_seconds jest wyrażona w milisekundach, a nie w sekundach.

Identyfikator użytkownika
user_id integer

Identyfikator użytkownika.

Nazwa użytkownika
user_name string

Nazwa użytkownika.

Identyfikator obszaru roboczego
workspace_id integer

Identyfikator obszaru roboczego.

TimeEntry

Nazwa Ścieżka Typ Opis
Ostatnia aktualizacja
at string

Po ostatniej aktualizacji jest zgodny z formatem ISO 8601.

Płatne
billable boolean

Określa, czy wpis czasu jest oznaczony jako rozliczany.

Nazwa klienta
client_name string

Pola meta powiązanych jednostek.

Description
description string

Opis wpisu czasu.

Czas trwania
duration integer

Czas trwania wpisu czasu. W przypadku uruchomionych wpisów powinny być ujemne, najlepiej -1.

Tylko czas trwania
duronly boolean

Służy do tworzenia te z czasem trwania, ale bez czasu zatrzymania.

Identyfikatory wydatków
expense_ids array of integer

Wydatki na pracę.

Identyfikator wpisu czasu
id integer

Identyfikator wpisu czasu.

Permissions
permissions array of string

Lista uprawnień.

Identyfikator projektu (starsza wersja)
pid integer

Identyfikator projektu, starsze pole.

Projekt aktywny
project_active boolean

Czy projekt jest aktywny.

Projekt rozliczany
project_billable boolean

Czy projekt jest rozliczany.

Kolor projektu
project_color string

Kolor projektu.

Identyfikator projektu
project_id integer

Identyfikator projektu.

Nazwa projektu
project_name string

Nazwa projektu.

Udostępnione
shared_with array of SharedWith

Wskazuje, kto wpis czasu został udostępniony.

Godzina rozpoczęcia
start string

Godzina rozpoczęcia w formacie UTC.

Czas zatrzymania
stop string

Czas zatrzymania w formacie UTC może mieć wartość null, jeśli nadal jest uruchomiony.

Identyfikatory tagów
tag_ids array of integer

Identyfikatory tagów, null, jeśli nie podano tagów lub zostały później usunięte.

Etykiety
tags array of string

Nazwy tagów, wartości null, jeśli nie podano tagów lub zostały później usunięte.

Identyfikator zadania
task_id integer

Identyfikator zadania.

Nazwa zadania
task_name string

Nazwa zadania.

Identyfikator zadania (starsza wersja)
tid integer

Identyfikator zadania, starsze pole.

Identyfikator użytkownika (starsza wersja)
uid integer

Identyfikator twórcy wpisu czasowego, starsze pole.

Adres URL awatara użytkownika
user_avatar_url string

Adres URL awatara użytkownika.

Identyfikator użytkownika
user_id integer

Identyfikator twórcy wpisu czasowego.

Nazwa użytkownika
user_name string

Nazwa użytkownika.

Identyfikator obszaru roboczego (starsza wersja)
wid integer

Identyfikator obszaru roboczego, starsze pole.

Identyfikator obszaru roboczego
workspace_id integer

Identyfikator obszaru roboczego.

Udostępnione z

Nazwa Ścieżka Typ Opis
Zaakceptowano
accepted boolean

Czy udział został zaakceptowany.

Identyfikator użytkownika
user_id integer

Identyfikator użytkownika osoby udostępnionej.

Nazwa użytkownika
user_name string

Nazwa użytkownika osoby udostępnionej.

Workspace

Nazwa Ścieżka Typ Opis
Liczba aktywnych projektów
active_project_count integer

Liczba aktywnych projektów.

Admin
admin boolean

Bieżący użytkownik jest administratorem obszaru roboczego (przestarzałe).

Token API
api_token string

Token interfejsu API (przestarzały).

Ostatnia zmiana
at string

Sygnatura czasowa ostatniej zmiany obszaru roboczego.

Obszar roboczy firmy
business_ws boolean

Obszar roboczy w subskrypcji Premium.

Przekazywanie pliku CSV
csv_upload object

Przekazywanie danych w formacie CSV.

Waluta domyślna
default_currency string

Domyślna waluta, funkcja Premium.

Domyślna stawka godzinowa
default_hourly_rate double

Domyślna stawka godzinowa, funkcja Premium.

Wyłączanie zatwierdzeń
disable_approvals boolean

Wyłącz zatwierdzenia w obszarze roboczym.

Wyłącz widok grafiku
disable_timesheet_view boolean

Wyłącz widok grafiku w obszarze roboczym.

Ukryj godziny zakończenia rozpoczęcia
hide_start_end_times boolean

Ukryj godziny rozpoczęcia i zakończenia.

Włączono funkcję iCal
ical_enabled boolean

Włączono integrację kalendarza.

Adres URL pliku iCal
ical_url string

Adres URL kalendarza.

Identyfikator obszaru roboczego
id integer

Identyfikator obszaru roboczego.

Ostatnia modyfikacja
last_modified string

Ostatnia modyfikacja danych w obszarze roboczym.

Ograniczanie publicznych danych projektu
limit_public_project_data boolean

Ogranicz dane projektów publicznych w raportach do administratorów.

Logo URL
logo_url string

Adres URL logo obszaru roboczego.

Maksymalna liczba dni przechowywania danych
max_data_retention_days object

Jak daleko z powrotem bezpłatne obszary robocze mogą uzyskiwać dostęp do danych.

Nazwa obszaru roboczego
name string

Nazwa obszaru roboczego.

Tylko administratorzy mogą tworzyć projekty
only_admins_may_create_projects boolean

Tylko administratorzy będą mogli tworzyć projekty.

Tylko administratorzy mogą tworzyć tagi
only_admins_may_create_tags boolean

Tylko administratorzy będą mogli tworzyć tagi.

Tylko administratorzy widzą pulpit nawigacyjny zespołu
only_admins_see_team_dashboard boolean

Tylko administratorzy będą mogli wyświetlać pulpit nawigacyjny zespołu.

Identyfikator organizacji
organization_id integer

Identyfikator organizacji.

Permissions
permissions array of string

Lista uprawnień.

Premium
premium boolean

Obszar roboczy w subskrypcji starter.

Projekty rozliczane domyślnie
projects_billable_by_default boolean

Nowe projekty domyślnie rozliczane.

Projekty wymuszają rozliczanie
projects_enforce_billable boolean

Określa, czy czas śledzenia projektów będzie wymuszać rozliczane ustawienie, które ma być przestrzegane.

Projekty prywatne domyślnie
projects_private_by_default boolean

Ustawienie obszaru roboczego dla domyślnej widoczności projektu.

Oceń ostatnio zaktualizowano
rate_last_updated string

Sygnatura czasowa ostatniej aktualizacji stawki obszaru roboczego.

Zwiń raporty
reports_collapse boolean

Czy raporty powinny być domyślnie zwinięte.

Role
role string

Rola bieżącego użytkownika w obszarze roboczym.

Zaokrąglanie
rounding integer

Domyślna funkcja zaokrąglania, premium. 0 - najbliższe, 1 - zaokrąglić w górę, -1 - zaokrąglić w dół.

Zaokrąglanie minut
rounding_minutes integer

Domyślne zaokrąglanie w minutach, funkcja Premium.

Subscription
subscription object

Szczegóły subskrypcji (przestarzałe).

Zawieszone o
suspended_at string

Sygnatura czasowa zawieszenia.

Ograniczenia dotyczące wprowadzania czasu
te_constraints object

Ustawienie ograniczeń wprowadzania czasu.

Godziny pracy w minutach
working_hours_in_minutes integer

Godziny pracy w minutach.

Funkcja

Nazwa Ścieżka Typ Opis
Włączona
enabled boolean

Czy ta funkcja jest włączona.

Identyfikator funkcji
feature_id integer

Identyfikator funkcji.

Nazwa funkcji
name string

Nazwa funkcji.

Przestrzeń roboczaFunkcje

Nazwa Ścieżka Typ Opis
Funkcje
features array of Feature

Lista funkcji.

Identyfikator obszaru roboczego
workspace_id integer

Identyfikator obszaru roboczego.

LocationResponse

Nazwa Ścieżka Typ Opis
Miejscowość
city string

Nazwa miasta.

Współrzędne miasta
city_lat_long string

Szerokość geograficzna i długość geograficzna miasta.

Kod kraju
country_code string

Kod kraju.

Nazwa kraju
country_name string

Nazwa kraju.

State
state string

Stan lub region.

Organization

Nazwa Ścieżka Typ Opis
Admin
admin boolean

Czy żądający jest administratorem organizacji.

Ostatnia modyfikacja
at string

Data ostatniej modyfikacji organizacji.

Utworzono pod adresem
created_at string

Data utworzenia organizacji.

Identyfikator organizacji
id integer

Identyfikator organizacji.

Włączono wiele obszarów roboczych
is_multi_workspace_enabled boolean

Ma wartość true, jeśli opcja organizacji is_multi_workspace_enabled jest ustawiona.

Jest ujednolicony
is_unified boolean

Jest ujednoliconą organizacją.

Maksymalna liczba dni przechowywania danych
max_data_retention_days object

Jak daleko do bezpłatnych obszarów roboczych w tej organizacji mogą uzyskiwać dostęp do danych.

Maksymalna liczba obszarów roboczych
max_workspaces integer

Maksymalna liczba obszarów roboczych dozwolonych dla organizacji.

Nazwa organizacji
name string

Nazwa organizacji.

Właściciel
owner boolean

Czy żądający jest właścicielem organizacji.

Permissions
permissions array of string

Uprawnienia organizacji.

Plan cenowy Enterprise
pricing_plan_enterprise boolean

Plan subskrypcji to plan przedsiębiorstwa.

Identyfikator planu cenowego
pricing_plan_id integer

Identyfikator planu organizacji.

Nazwa planu cenowego
pricing_plan_name string

Nazwa planu subskrypcji, w ramach których jest obecnie włączona organizacja.

Zawieszone o
suspended_at string

Czy organizacja jest obecnie zawieszona.

trial_info
trial_info TrialInfo
Liczba użytkowników
user_count integer

Liczba użytkowników organizacji.

Informacje o wersji próbnej

Nazwa Ścieżka Typ Opis
Może mieć wersję próbną
can_have_trial boolean

To prawda, jeśli ani organizacja, ani właściciel nigdy wcześniej nie miał okresu próbnego.

Ostatni identyfikator planu cenowego
last_pricing_plan_id integer

Ostatni identyfikator planu cenowego.

Następna data płatności
next_payment_date string

Następna data płatności.

Proces sądowy
trial boolean

Określa, czy subskrypcja organizacji jest obecnie w wersji próbnej.

Dostępna wersja próbna
trial_available boolean

Gdy wersja próbna jest dostępna dla tej organizacji (przestarzała).

Data zakończenia wersji próbnej
trial_end_date string

Data zakończenia wersji próbnej.

Identyfikator planu wersji próbnej
trial_plan_id integer

Identyfikator planu wersji próbnej.

TrackReminder

Nazwa Ścieżka Typ Opis
Utworzono pod adresem
created_at string

Czas tworzenia przypomnienia.

Częstotliwość
frequency integer

Częstotliwość przypomnienia w dniach powinna mieć wartość 1 lub 7.

Identyfikatory grup
group_ids array of integer

Identyfikatory grup do wysłania przypomnienia.

Identyfikator przypomnienia
reminder_id integer

Identyfikator przypomnienia.

Próg
threshold integer

Próg to liczba godzin, po których zostanie wysłane przypomnienie.

Identyfikatory użytkowników
user_ids array of integer

Identyfikatory użytkowników do wysłania przypomnienia.

Identyfikator obszaru roboczego
workspace_id integer

Identyfikator obszaru roboczego.

TrackRemindersResponse

Nazwa Ścieżka Typ Opis
Śledzenie przypomnień
items array of TrackReminder

Zwraca listę przypomnień dotyczących śledzenia.

BulkEditResponse

Nazwa Ścieżka Typ Opis
Awarii
failure array of BulkEditFailure

Lista operacji, które zakończyły się niepowodzeniem.

Identyfikatory sukcesów
success array of integer

Identyfikatory, dla których poprawka zakończyła się pomyślnie.

BulkEditFailure

Nazwa Ścieżka Typ Opis
Identyfikator niepowodzenia
id integer

Identyfikator, dla którego operacja stosowania poprawek nie powiodła się.

Komunikat o błędzie
message string

Przyczyna niepowodzenia operacji.

Obszar roboczyUżytkownik

Nazwa Ścieżka Typ Opis
Włączone uwierzytelnianie 2FA
2fa_enabled boolean

Flaga wskazująca, czy jest włączona funkcja 2FA.

Aktywna
active boolean

Flaga wskazująca, czy użytkownik zaakceptował zaproszenie.

Admin
admin boolean

Flaga wskazująca, czy użytkownik jest administratorem.

Ostatnia aktualizacja
at string

Sygnatura czasowa ostatniej aktualizacji.

Adres URL awatara
avatar_file_name string

Adres URL awatara.

Email
email string

Adres e-mail użytkownika.

Identyfikatory grup
group_ids array of integer

Lista grup, do których należy użytkownik.

Identyfikator obszaru roboczego użytkownika
id integer

Identyfikator obszaru roboczego użytkownika.

Nieaktywny
inactive boolean

Flaga wskazująca, czy użytkownik został zdezaktywowany przez administratora obszaru roboczego.

Kod zaproszenia
invitation_code string

Wewnętrzny kod zaproszenia.

Adres URL zaproszenia
invite_url string

Wewnętrzny adres URL zaproszenia.

Jest bezpośrednim elementem członkowskim
is_direct boolean

Flaga wskazująca, czy użytkownik jest bezpośrednim członkiem obszaru roboczego (nie jest przypisany do obszaru roboczego przy użyciu grupy).

Koszt pracy
labor_cost double

Koszt pracy przypisany do użytkownika.

Ostatnia aktualizacja kosztu pracy
labor_cost_last_updated string

Sygnatura czasowa ostatniej aktualizacji kosztów pracy.

Name
name string

Imię i nazwisko użytkownika.

Administrator organizacji
organization_admin boolean

Flaga wskazująca, czy użytkownik jest administratorem wewnątrz organizacji.

Rate
rate double

Stawka przypisana użytkownikowi.

Oceń ostatnio zaktualizowano
rate_last_updated string

Sygnatura czasowa ostatniej aktualizacji stawki.

Role
role string

Rola użytkownika.

Identyfikator roli
role_id integer

Identyfikator roli.

Strefa czasowa
timezone string

Strefa czasowa użytkownika.

Identyfikator użytkownika globalnego
uid integer

Identyfikator użytkownika globalnego.

Identyfikator użytkownika
user_id integer

Alternatywne pole JSON userID, używane tylko przez użytkownika get-organization-workspaces-workspaceusers.

Wyświetlanie pozycji Edytuj stawki rozliczane
view_edit_billable_rates boolean

Flagi uprawnień stopnia szczegółowości. Ma wpływ tylko na role z uprawnieniami szybkości warunkowej.

Wyświetlanie edycji kosztów pracy
view_edit_labor_costs boolean

Wyświetlanie uprawnień do edytowania kosztów pracy.

Identyfikator obszaru roboczego
wid integer

Identyfikator obszaru roboczego.

Godziny pracy w minutach
working_hours_in_minutes integer

Wartość godzin pracy w minutach.

Administrator obszaru roboczego
workspace_admin boolean

Flaga wskazująca, czy użytkownik jest administratorem w obszarze roboczym.

Identyfikator obszaru roboczego
workspace_id integer

Alternatywne pole JSON userID, używane tylko przez użytkownika get-organization-workspaces-workspaceusers.

Rate

Nazwa Ścieżka Typ Opis
Kwota
amount double

Wielkość stawki.

Utworzono pod adresem
created_at string

Data utworzenia stawki.

Identyfikator twórcy
creator_id integer

Identyfikator twórcy.

Usunięto o
deleted_at string

Data usunięcia stawki, jeśli ma wartość null, oznacza to, że stawki są aktywne.

Data zakończenia
end string

Data zakończenia stawki.

Identyfikator stawki
id integer

Identyfikator stawki.

Identyfikator zaplanowanego zadania
planned_task_id integer

Identyfikator zaplanowanego zadania, który jest stosowany.

Identyfikator projektu
project_id integer

Identyfikator projektu, który jest stosowany.

Identyfikator użytkownika projektu
project_user_id integer

Identyfikator użytkownika projektu, którego stawka jest stosowana.

Tryb zmiany szybkości
rate_change_mode string

Tryb zmiany szybkości.

Data rozpoczęcia
start string

Data rozpoczęcia stawki.

Typ
type string

Typ stawki.

Zaktualizowano o
updated_at string

Data ostatniej aktualizacji stawki.

Identyfikator obszaru roboczego
workspace_id integer

Identyfikator obszaru roboczego, w którym jest stosowana stawka.

Identyfikator użytkownika obszaru roboczego
workspace_user_id integer

Identyfikator użytkownika obszaru roboczego, który jest stosowany.

Statystyka obszaru roboczego

Nazwa Ścieżka Typ Opis
Administratorzy
admins array of WorkspaceAdmin

Lista administratorów obszaru roboczego.

Liczba grup
groups_count integer

Liczba grup w obszarze roboczym.

Liczba członków
members_count integer

Liczba członków w obszarze roboczym.

Administrator obszaru roboczego

Nazwa Ścieżka Typ Opis
Name
name string

Nazwa administratora.

Identyfikator użytkownika
user_id integer

Identyfikator użytkownika administratora.

Ograniczenia timeEntry

Nazwa Ścieżka Typ Opis
Opis wymagany
description_present boolean

Opis jest wymagany dla wpisów czasu.

Wymagany projekt
project_present boolean

Projekt jest wymagany dla wpisów czasu.

Wymagany tag
tag_present boolean

Tag jest wymagany dla wpisów czasu.

Wymagane zadanie
task_present boolean

Zadanie jest wymagane dla wpisów czasu.

Włączone ograniczenia
time_entry_constraints_enabled boolean

Ograniczenia dotyczące wprowadzania czasu są włączone.

Obszar roboczyUserSimple

Nazwa Ścieżka Typ Opis
Email
email string

Adres e-mail użytkownika.

Pełna nazwa
fullname string

Imię i nazwisko użytkownika.

Identyfikator użytkownika
id integer

Identyfikator użytkownika globalnego.

Nieaktywny
inactive boolean

Nieaktywny wskazuje, czy użytkownik jest dezaktywowany, czy nie w obszarze roboczym.

Jest aktywny
is_active boolean

IsActive wskazuje, czy użytkownik dołączył do obszaru roboczego.

Jest administratorem (przestarzałe)
is_admin boolean

Flaga wskazująca, czy użytkownik jest administratorem (przestarzałe).

Role
role string

Rola użytkownika.

ProjectUser

Nazwa Ścieżka Typ Opis
Ostatnia modyfikacja
at string

Kiedy ostatnio zmodyfikowano.

Identyfikator grupy (starsza wersja)
gid integer

Identyfikator grupy, starsze pole.

Identyfikator grupy
group_id integer

Identyfikator grupy.

Identyfikator użytkownika projektu
id integer

Identyfikator użytkownika projektu.

Koszt pracy
labor_cost double

Koszt pracy dla tego użytkownika projektu.

Ostatnia aktualizacja kosztu pracy
labor_cost_last_updated string

Data ostatniej aktualizacji kosztu pracy.

Menedżer
manager boolean

Czy użytkownik jest menedżerem projektu.

Identyfikator projektu
project_id integer

Identyfikator projektu.

Rate
rate double

Oceń dla tego użytkownika projektu.

Oceń ostatnio zaktualizowano
rate_last_updated string

Data ostatniej aktualizacji stawki.

Identyfikator użytkownika
user_id integer

Identyfikator użytkownika.

Identyfikator obszaru roboczego
workspace_id integer

Identyfikator obszaru roboczego.

TimeEntryWebhookEvent

Nazwa Ścieżka Typ Opis
Identyfikator zdarzenia
event_id integer

Unikatowy identyfikator zdarzenia elementu webhook.

Identyfikator subskrypcji
subscription_id integer

Identyfikator subskrypcji elementu webhook, która wyzwoliła to zdarzenie.

Zdarzenie utworzone pod adresem
created_at string

Po utworzeniu zdarzenia.

Sygnatura czasowa zdarzenia
timestamp string

Po wysłaniu zdarzenia.

Identyfikator twórcy
creator_id integer

Identyfikator użytkownika, który wyzwolił zdarzenie.

Adres URL wywołania zwrotnego
url_callback string

Adres URL wywołania zwrotnego dla tego zdarzenia.

Typ żądania
metadata.request_type string

Typ żądania, które wyzwoliło zdarzenie.

Identyfikator użytkownika zdarzenia
metadata.event_user_id integer

Identyfikator użytkownika skojarzonego ze zdarzeniem.

Akcja
metadata.action string

Wykonano akcję (utworzono, zaktualizowano, usunięto, uruchomiono, zatrzymano).

ładunek
payload TimeEntry