共用方式為


時間幽靈

timeghost 是專用的 Microsoft 365 / Office 365 解決方案,可與您的工作環境完美整合。 使用 timeghost 連接器生成時間報告、發票和其他文檔。

此連接器適用於以下產品和區域:

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 (DoD)
Power Apps 進階 除下列區域外的所有 Power Apps 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除下列區域外的所有 Power Automate 區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人​​
名稱 timeghost 支持
URL https://support.timeghost.io
Email support@timeghost.io
連接器中繼資料
Publisher timeghost.io
網站 https://timeghost.io
隱私策略 https://timeghost.io/privacy-policy/
類別 生產力;商業智慧

時間幽靈

timeghost 是專用的 Microsoft 365 / Office 365 解決方案,可與您的工作環境完美整合。 使用 timeghost Flow Connector 生成時間報告、發票和其他文檔。

Pre-requisites

若要使用此連接器,您必須擁有公司、學校或 Microsoft 個人帳戶。 您還需要通過以下兩個步驟之一來接受 timeghost 的權限和同意:

  • 團隊:安裝 timeghost Teams 應用程序並啟動它,接受權限和同意。
  • Web:打開 timeghost Web 應用程序並接受權限和同意。

您現在已準備好開始使用此連接器。

支援的作業

連接器支援下列作業:

  • Add Client :將用戶端新增至工作區。
  • Add Custom Feed Event :將事件新增至使用者摘要。 條目將在 180 天后自動刪除。
  • Add Project :將專案新增至工作區。
  • Add Task :將任務新增至工作區。
  • Add Time :將時間新增至工作區內的專案。
  • Add Tag :將時間標籤或專案標籤新增至工作區。
  • Add Group :將群組新增至工作區。
  • Add ComeGo :將工作時間新增至工作區。
  • Create Times Excel Report :傳回包含指定時間報告的 Excel 檔案。
  • Delete Item :從工作區中刪除項目。
  • Get Client Projects :在一個工作區中獲取一個客戶的所有項目。
  • Get Client Times :在一個工作區中獲取一個客戶的所有時間。
  • Get Clients :從工作區取得所有用戶端。
  • Get Project Tasks :在一個工作區中獲取一個項目的所有任務。
  • Get Project Times :在一個工作區中獲取一個項目的所有時間。
  • Get Projects :從工作區取得所有專案。
  • Get Tags :從工作區取得所有標籤。
  • Get Times :從工作區取得所有時間。
  • Get Currentuser :從工作區取得 Currentuser。
  • Get Workspace by Id :依 ID 取得工作區。
  • Get Groups :從工作區取得所有群組。
  • Get ComeGo :從工作區獲取所有工作時間。
  • Update Client :更新工作區中的用戶端。
  • Update Custom Feed Event :更新工作區中的自訂摘要項目。
  • Update Project Tags :更新工作區中的專案標籤。
  • Update Project User :更新工作區中專案的使用者。
  • Update Project Groups :更新工作區中的專案群組。
  • Update Group :更新工作區中的群組。
  • Update Task :更新工作區中的任務。
  • Update Time :更新工作區中的時間。
  • Update Time tag :更新工作區中時間的標籤。
  • Update Tag :更新工作區中的時間標籤或專案標籤。
  • Update ComeGo :更新工作區中的工作時間。
  • Client Trigger :如果在timeghost中建立、變更或刪除客戶端,則會執行此觸發器。
  • Project Trigger :如果在 timeghost 中建立、變更或刪除專案,則會執行此觸發器。
  • Tag Trigger :如果在 timeghost 中建立、變更或刪除標籤,則會執行此觸發器。
  • Task Trigger :如果在 timeghost 中建立、變更或刪除任務,則會執行此觸發器。
  • Time Trigger :如果在 timeghost 中建立、變更或刪除時間,則會執行此觸發器。

部署指示

請使用 這些指示 ,將此連接器部署為 Microsoft Power Automate 和 Power Apps 中的自訂連接器。

如何取得憑證?

使用 timeghost Power Automate 連接器所需的認證是您的 Office/Microsoft 365 登入詳細資料。 不需要額外的認證。

已知問題與限制

沒有已知問題和限制。

正在建立連線

連接器支援下列驗證類型:

預設值 建立連線的參數。 所有區域 不可共享

預設

適用:所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

依 ID 取得工作區

傳回工作區

刪除項目

從工作區中刪除項目。

取得客戶專案

在一個工作區中獲取一個客戶的所有項目。

取得專案任務

在一個工作區中獲取一個項目的所有任務。

取得工作區群組

從工作區取得所有群組。

取得目前使用者

傳回具有工作區的目前使用者物件

建立 Times Excel 報表

傳回包含指定時間報告的 Excel 檔案。

新增任務

將工作新增至工作區。

新增專案

將專案新增至工作區。

新增工作時間

將工作時間新增至工作區。

新增時間

將時間新增至工作區內的專案。

新增用戶端

將用戶端新增至工作區。

新增群組

將群組新增至工作區。

新增自訂摘要事件

將事件新增至使用者摘要。 條目將在 180 天后自動刪除。

更新任何標籤

更新工作區中的時間標籤。

更新專案

更新工作區中的專案。

更新專案的使用者

更新工作區中的專案使用者。

更新專案的標籤

更新工作區中的專案標籤。

更新專案的群組

更新工作區中的專案群組。

更新工作

更新工作區中的工作。

更新工作時間

更新工作區中的工作時數。

更新時間

更新工作區中的時間。

更新時間的標籤

更新工作區中的時間標籤。

更新用戶端

更新工作區中的用戶端。

更新群組

更新工作區中的群組。

更新自訂摘要事件

更新工作區中的自訂摘要項目。

添加任何標籤

將時間標籤新增至工作區。

獲取客戶

從工作區取得所有用戶端。

獲取客戶時間

在一個工作區中獲取一個客戶的所有時間。

獲取專案

從工作區取得所有專案。

獲取工作時間

從工作區取得所有工作時間。

獲取時間

從工作區獲取所有時間。

獲取標籤

從工作區取得所有標籤。

獲取項目時間

在一個工作區中獲取一個項目的所有時間。

依 ID 取得工作區

傳回工作區

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id string

輸入儲存資料的工作區 (工作區識別碼)

工作空間
workspace_id True string

工作區識別碼

傳回

刪除項目

從工作區中刪除項目。

參數

名稱 機碼 必要 類型 Description
項目類型
ItemType True string

將刪除的項目類型

項目 ID
ItemId True string

將刪除的項目的 ID

工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

取得客戶專案

在一個工作區中獲取一個客戶的所有項目。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

客戶
clientid True string

用戶端 (或用戶端 ID)

篩選查詢
$filter string

ODATA 篩選查詢,以限制傳回的專案

傳回

取得專案任務

在一個工作區中獲取一個項目的所有任務。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

客戶
clientid string

用戶端 (或用戶端 ID)

專案
projectid True string

專案 (或專案 ID)

篩選查詢
$filter string

ODATA 篩選查詢,以限制傳回的工作

傳回

取得工作區群組

從工作區取得所有群組。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

傳回

取得目前使用者

傳回具有工作區的目前使用者物件

傳回

身體
UserResponse

建立 Times Excel 報表

傳回包含指定時間報告的 Excel 檔案。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

startDate
startDate True date-time
結束日期
endDate True date-time
可計費
billable string
用戶端
client boolean
專案
project boolean
專案說明
projectDescription boolean
工作
task boolean
描述
description boolean
作者
author boolean
groupedBy專案
groupedByProject True boolean
項目狀態
projectStatus string
enabled
enabled boolean
紀要
minutes integer
型別
type string
timeZone
timeZone string
users
users array of uuid

傳回

Excel 檔案

Excel 檔案
object

新增任務

將工作新增至工作區。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

名稱
name True string

任務名稱

估計 (秒)
estimation True double

任務的預估持續時間(以秒為單位)

專案
id True string

專案 (或專案 ID)

名稱
name string

專案名稱

Cosmos 實體名稱
cosmosEntityName string

Cosmos DB 中的實體名稱

已刪除
deleted boolean

指出專案是否已刪除

Editor
editor string

專案的最後一位編輯者

ID
id True string

群組識別碼

名稱
name True string

群組名稱

使用者
users array of string

指派給此群組的使用者

同步群組
synchronizedGroup boolean

指出群組是否已同步處理

指派的使用者
assignedToUsers array of string
外部 ID
externalId string

此值可用來儲存來自另一個系統的 ID。 有一個簡單的映射。

傳回

新增專案

將專案新增至工作區。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

名稱
name True string

專案名稱

Description
description string

項目說明

客戶
id True string

用戶端 (或用戶端 ID)

名稱
name string

用戶端名稱

顏色
color string

項目的顏色,例如。 “#0000FF”

可計費
billable True boolean

指出專案是否標示為可計費

完成
completed boolean

指出專案是否標示為已完成

基於任務的估計
taskBasedEstimation True boolean

預算取決於任務。

判斷
estimation double

項目的預算預估

私人
private True boolean

將專案設定為公用或私人。

專案類型
projectType string

設定專案類型

User
id True string

使用者 (或使用者 ID)

Role
role True number

在專案中的角色

計費費率
billable_rate double

此使用者在此專案中的計費費率

Removed
removed boolean

指出使用者是否已從專案中移除

Tags
tags array of string

與專案相關聯的標籤

Groups
groups array of string

與專案相關聯的群組

誰可以新增任務
whoCanAddTasks integer

誰可以將任務新增至此專案(例如,1 = 僅限管理員,2 = 所有人)

範本識別碼
templateId string

專案範本的ID

範本複製率
templateCopyRate boolean

指出是否要從範本複製費率

範本複製任務
templateCopyTasks boolean

指出是否要從範本複製任務

範本複製任務指派
templateCopyTaskAssign boolean

指出是否要從範本複製任務指派

傳回

新增工作時間

將工作時間新增至工作區。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

名稱
name string

項目的名稱可以是 null

開始時間
start date-time

ISO 8601 格式的工作項目的開始時間

結束時間
end date-time

ISO 8601 格式的工作項目的結束時間,如果正在進行中,則可以為空

類型
type string

項目類型(例如,“工作”)

時區
timeZone string

記錄條目的時區(例如,“歐洲/柏林”)

使用者識別碼
id string

與此項目相關聯之使用者的唯一 ID

傳回

新增時間

將時間新增至工作區內的專案。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

客戶
id True string

用戶端 (或用戶端 ID)

專案
id True string

專案 (或專案 ID)

任務
id True string

任務 (或任務 ID)

Cosmos 實體名稱
cosmosEntityName string

Cosmos DB 中用於工作的實體名稱

已刪除
deleted boolean

指出工作是否已刪除

名稱
name True string

此時間項目的名稱 (工作名稱)

開始
start True date-time

時間項目的開始日期和開始時間,格式:yyyy-MM-ddTHH:mm:ss。SSSZ

結束
end date-time

時間項目的結束日期和結束時間,格式:yyyy-MM-ddTHH:mm:ss。SSSZ

可計費
billable True boolean

指出時間是否標示為可計費

Cosmos 實體名稱
cosmosEntityName string

Cosmos DB 中用於標籤的實體名稱

已刪除
deleted boolean

指出標籤是否已刪除

Editor
editor string

標籤的最後一位編輯者

時區
timeZone string

時間項目的時區

輸入模式
inputMode string

時間條目的輸入模式(例如,範圍)

Outlook 行事曆參考
outlookCalenderReference string

Outlook 行事曆事件的參考 (如果適用)

傳回

身體
TimesResponse

新增用戶端

將用戶端新增至工作區。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

名稱
name True string

客戶名稱

Description
description string

客戶描述

傳回

新增群組

將群組新增至工作區。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

名稱
name True string

群組名稱

使用者識別碼
id True string

使用者識別碼

同步群組
synchronizedGroup boolean

指出群組是否已同步處理

同步群組類型
synchronizedGroupType string

同步群組的類型 (如果適用)

傳回

新增自訂摘要事件

將事件新增至使用者摘要。 條目將在 180 天后自動刪除。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

名稱
name True string

參賽作品名稱

Description
description string

參賽作品說明

User
id True string

使用者 (或使用者 ID)

開始
start True date-time

摘要項目的開始日期和開始時間

結束
end True date-time

摘要項目的結束日期和結束時間

圖示 URL
imageUrl string

圖示 Url,顯示在摘要項目中。 最好使用 96px96px 和 https。

網址
url string

外部位址的 URL。 例如,詳細資料頁面。 摘要中的此連結可透過內容功能表開啟。

類別
category string

使用稍後可以在介面中篩選的值。 例如“Planner”。

外部 ID
externalId string

此值可用來儲存來自另一個系統的 ID。 有一個簡單的映射。

傳回

更新任何標籤

更新工作區中的時間標籤。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

標記
TagId True string

標籤(或標籤ID)

名稱
name True string

標籤名稱

標籤類型
tagType True integer

標籤的類型

外部 ID
externalId string

此值可用來儲存來自另一個系統的 ID 以進行對映。

Cosmos 實體名稱
cosmosEntityName string

Cosmos DB 中使用的實體名稱

已刪除
deleted boolean

指出標籤是否已刪除

作者
author string

標籤的作者

Editor
editor string

標籤的最後一位編輯者

工作區識別碼
id string

工作區識別碼

分割區索引鍵
partitionKey string

Cosmos DB 中的分割區索引鍵

地位
status string

標籤的狀態

已建立
created date-time

標籤的建立時間戳記

修改
modified date-time

標籤的上次修改時間戳記

傳回

身體
TagsResponse

更新專案

更新工作區中的專案。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

專案
ProjectId True string

專案 (或專案 ID)

名稱
name True string

專案名稱

Description
description string

項目說明

客戶
id True string

用戶端 (或用戶端 ID)

名稱
name string

用戶端名稱

顏色
color string

項目的顏色,例如。 “#0000FF”

可計費
billable True boolean

指出專案是否標示為可計費

完成
completed boolean

指出專案是否標示為已完成

基於任務的估計
taskBasedEstimation True boolean

預算取決於任務。

判斷
estimation double

項目的預算預估

私人
private True boolean

將專案設定為公用或私人。

時薪
hourly_rate double

專案的小時費率

已啟用小時費率
hourly_rate_enabled boolean

指出是否已為專案啟用小時費率

User
id True string

使用者 (或使用者 ID)

Role
role True number

在專案中的角色

計費費率
billable_rate double

此使用者在此專案中的計費費率

標籤 ID
id True string

標籤 ID

標記名稱
name True string

標籤名稱

Groups
groups array of string

與專案相關聯的群組

誰可以新增任務
whoCanAddTasks integer

誰可以將任務新增至此專案(例如,1 = 僅限管理員,2 = 所有人)

地位
status string

專案的狀態

工作區識別碼
id string

工作區識別碼

Cosmos 實體名稱
cosmosEntityName string

Cosmos DB 中使用的實體名稱

作者
author string

項目作者

Editor
editor string

項目編輯

分割區索引鍵
partitionKey string

Cosmos DB 中的分割區索引鍵

傳回

更新專案的使用者

更新工作區中的專案使用者。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

專案
ProjectId True string

專案 (或專案 ID)

User
id True string

使用者 (或使用者 ID)

Role
role True number

在專案中的角色

計費費率
billable_rate double

此使用者在此專案中的計費費率

傳回

更新專案的標籤

更新工作區中的專案標籤。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

專案
ProjectId True string

專案 (或專案 ID)

標記
id True string

標籤(或標籤ID)

傳回

更新專案的群組

更新工作區中的專案群組。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

專案
ProjectId True string

專案 (或專案 ID)

群體
id True string

群組 (或群組 ID)

Role
role True number

在專案中的角色

傳回

更新工作

更新工作區中的工作。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

任務
TaskId True string

任務 (或任務 ID)

名稱
name string

任務名稱

估計 (秒)
estimation double

任務的預估持續時間(以秒為單位)

完成
completed boolean

指出工作是否標示為已完成

客戶
id True string

用戶端 (或用戶端 ID)

名稱
name string

用戶端名稱

專案
id True string

專案 (或專案 ID)

名稱
name string

專案名稱

完成
completed boolean

指出專案是否標示為已完成

ID
id True string

群組識別碼

名稱
name True string

群組名稱

指派的使用者
assignedToUsers array of string
地位
status string

工作的狀態

計費時間
billable double

此工作記錄的計費時間

不可計費時間
notBillable double

為此工作記錄的不可計費時間

工作區識別碼
id string

工作區識別碼

Cosmos 實體名稱
cosmosEntityName string

Cosmos DB 中使用的實體名稱

分割區索引鍵
partitionKey string

Cosmos DB 中的分割區索引鍵

已建立
created date-time

任務的建立時間戳記

修改
modified date-time

任務的上次修改時間戳記

作者
author string

任務的作者

Editor
editor string

任務的最後一個編輯者

可以創造時間
canCreateTime boolean

指出是否可以為此工作建立時間項目

可以編輯
canEdit boolean

指出目前使用者是否可以編輯此工作

傳回

更新工作時間

更新工作區中的工作時數。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

實體名稱
cosmosEntityName string

實體類型,總是「comego」

已刪除
deleted boolean

指出項目是否標示為已刪除

編輯者編號
editor string

上次編輯項目的使用者識別碼

作者編號
author string

建立項目之使用者的識別碼

建立的時間戳記
created date-time

建立項目的時間戳記

修改時間戳記
modified date-time

上次修改項目的時間戳記

項目 ID
id string

ComeGo 條目的唯一 ID

地位
status string

項目的狀態(例如,“新”)

開始時間
start date-time

ISO 8601 格式的工作項目的開始時間

結束時間
end date-time

ISO 8601 格式中工作項目的結束時間

名稱
name string

項目的名稱可以是 null

分割區索引鍵
partitionKey string

CosmosDB 中專案的分割區索引鍵

時區
timeZone string

記錄條目的時區(例如,“歐洲/柏林”)

類型
type string

項目類型(例如,“工作”)

使用者識別碼
id string

與此項目相關聯之使用者的唯一 ID

使用者名
name string

與此項目相關聯的使用者名稱

工作區識別碼
id string

工作區的唯一識別碼

Tags
tags array of string

與項目相關聯的標籤陣列

使用者可以編輯
currentUserCanEdit boolean

指出目前使用者是否可以編輯項目

傳回

更新時間

更新工作區中的時間。

參數

名稱 機碼 必要 類型 Description
時間標識碼
TimeId True string

要更新的時間的唯一 ID

工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

客戶
id True string

用戶端 (或用戶端 ID)

名稱
name string

用戶端名稱

專案
id True string

專案 (或專案 ID)

名稱
name string

專案名稱

完成
completed boolean

指出專案是否已完成

任務
id True string

任務 (或任務 ID)

名稱
name string

任務名稱

完成
completed boolean

指出工作是否已完成

名稱
name string

此時間項目的名稱 (工作名稱)

開始
start date-time

時間項目的開始日期和開始時間,格式:yyyy-MM-ddTHH:mm:ss。SSSZ

結束
end date-time

時間項目的結束日期和結束時間,格式:yyyy-MM-ddTHH:mm:ss。SSSZ

可計費
billable boolean

指出時間是否標示為可計費

ID
id True string

標籤 ID

名稱
name string

標籤名稱

時區
timeZone string

時間項目的時區

輸入模式
inputMode string

時間條目的輸入模式(例如,範圍)

時差
timeDiff integer

時差(以秒為單位)

Outlook 行事曆參考
outlookCalenderReference string

Outlook 行事曆事件的參考 (如果適用)

Cosmos 實體名稱
cosmosEntityName string

Cosmos DB 中使用的實體名稱

分割區索引鍵
partitionKey string

Cosmos DB 中的分割區索引鍵

地位
status string

時間項目的狀態

User
id True string

使用者 (或使用者 ID) - 如果空白,則設定目前使用者

名稱
name string

使用者名

工作區識別碼
id string

工作區識別碼

已建立
created date-time

時間項目的建立時間戳記

修改
modified date-time

時間項目的上次修改時間戳記

傳回

身體
TimesResponse

更新時間的標籤

更新工作區中的時間標籤。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

時間標識碼
TimeId True string

要更新的時間的唯一 ID

標記
id True string

標籤(或標籤ID)

傳回

身體
TimesResponse

更新用戶端

更新工作區中的用戶端。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

客戶
ClientId True string

用戶端 (或用戶端 ID)

名稱
name True string

客戶姓名

Description
description string

客戶描述

顏色
color string

客戶的顏色,例如“#0000FF”

外部 ID
externalId string

此值可用來儲存來自另一個系統的 ID 以進行對映。

Cosmos 實體名稱
cosmosEntityName string

Cosmos DB 中使用的實體名稱

已刪除
deleted boolean

指出用戶端是否已刪除

作者
author string

客戶端的作者

Editor
editor string

客戶端的最後一位編輯者

工作區識別碼
id string

工作區識別碼

分割區索引鍵
partitionKey string

Cosmos DB 中的分割區索引鍵

地位
status string

用戶端的狀態

已建立
created date-time

用戶端的建立時間戳記

修改
modified date-time

用戶端的上次修改時間戳記

電話
phone string

電話號碼

地點
location string

客戶所在地

Email
email string

客戶的電子郵件

主要聯絡人
primaryContact string

主要連絡人姓名

次要聯絡人
secondaryContact string

次要聯絡人姓名

登機日期
onboardDate date

用戶端上線的日期

工業
industry string

客戶的行業

傳回

更新群組

更新工作區中的群組。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

群體
GroupId True string

群組 (或群組 ID)

ID
id True string

群組識別碼

名稱
name True string

群組名稱

同步群組
synchronizedGroup boolean

指出群組是否已同步處理

同步群組類型
synchronizedGroupType string

同步群組的類型 (如果適用)

使用者識別碼
id True string

使用者識別碼

Email
email True string

使用者電子郵件

名稱
name string

使用者名

傳回

更新自訂摘要事件

更新工作區中的自訂摘要項目。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

ID
EventId True string

自訂摘要事件ID

名稱
name string

參賽作品名稱

Description
description string

參賽作品說明

User
id True string

使用者 (或使用者 ID)

開始
start date-time

摘要項目的開始日期和開始時間

結束
end date-time

摘要項目的結束日期和結束時間

圖示 URL
imageUrl string

圖示 Url,顯示在摘要項目中。 最好使用 96px96px 和 https。

網址
url string

外部位址的 URL。 例如,詳細資料頁面。 摘要中的此連結可透過內容功能表開啟。

類別
category string

使用稍後可以在介面中篩選的值。 例如“Planner”。

外部 ID
externalId string

此值可用來儲存來自另一個系統的 ID。 有一個簡單的映射。

傳回

添加任何標籤

將時間標籤新增至工作區。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

名稱
name True string

標籤名稱

標籤類型
tagType True integer

選擇 0 作為專案標籤,或選擇 1 作為時間標籤

傳回

身體
TagsResponse

獲取客戶

從工作區取得所有用戶端。

參數

名稱 機碼 必要 類型 Description
篩選查詢
$filter string

ODATA 篩選查詢,以限制傳回的用戶端

工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

傳回

獲取客戶時間

在一個工作區中獲取一個客戶的所有時間。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

客戶
clientid True string

用戶端 (或用戶端 ID)

日期範圍
$filter-date-range True string

按範圍過濾時間

按用戶過濾
$filter-user string

按用戶過濾時間

篩選查詢
$filter string

ODATA 篩選查詢,以限制傳回的時間

傳回

獲取專案

從工作區取得所有專案。

參數

名稱 機碼 必要 類型 Description
篩選查詢
$filter string

ODATA 篩選查詢,以限制傳回的專案

工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

傳回

獲取工作時間

從工作區取得所有工作時間。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

按用戶過濾
$filter-user string

按用戶過濾時間

篩選查詢
$filter string

ODATA 篩選查詢,以限制傳回的時間

傳回

獲取時間

從工作區獲取所有時間。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

日期範圍
$filter-date-range True string

按範圍過濾時間

按用戶過濾
$filter-user string

按用戶過濾時間

篩選查詢
$filter string

ODATA 篩選查詢,以限制傳回的時間

傳回

獲取標籤

從工作區取得所有標籤。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

篩選查詢
$filter string

ODATA 篩選查詢,以限制傳回的專案

傳回

獲取項目時間

在一個工作區中獲取一個項目的所有時間。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

客戶
clientid string

用戶端 (或用戶端 ID)

專案
projectid True string

專案 (或專案 ID)

日期範圍
$filter-date-range True string

按範圍過濾時間

按用戶過濾
$filter-user string

按用戶過濾時間

篩選查詢
$filter string

ODATA 篩選查詢,以限制傳回的時間

傳回

觸發程序

任務觸發程序

如果在 timeghost 中創建、更改或刪除任務,則會運行此觸發器。

專案觸發器

如果在 timeghost 中創建、更改或刪除項目,則運行此觸發器。

時間觸發器

如果在 timeghost 中建立、變更或刪除時間,則會執行此觸發器。

標籤觸發器

如果在 timeghost 中建立、變更或刪除標籤,則會執行此觸發器。

用戶端觸發器

如果在 timeghost 中建立、變更或刪除用戶端,則會執行此觸發程式。

任務觸發程序

如果在 timeghost 中創建、更改或刪除任務,則會運行此觸發器。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

Webhook 的名稱
name True string

Webhook 的名稱,以便可以在 timeghost 的設定中找到它。

運行
events array of string

選取要收聽的事件

傳回

專案觸發器

如果在 timeghost 中創建、更改或刪除項目,則運行此觸發器。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

Webhook 的名稱
name True string

Webhook 的名稱,以便可以在 timeghost 的設定中找到它。

運行
events array of string

選取要收聽的事件

傳回

時間觸發器

如果在 timeghost 中建立、變更或刪除時間,則會執行此觸發器。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

Webhook 的名稱
name True string

Webhook 的名稱,以便可以在 timeghost 的設定中找到它。

運行
events array of string

選取要收聽的事件

傳回

身體
TimesResponse

標籤觸發器

如果在 timeghost 中建立、變更或刪除標籤,則會執行此觸發器。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

Webhook 的名稱
name True string

Webhook 的名稱,以便可以在 timeghost 的設定中找到它。

運行
events array of string

選取要收聽的事件

傳回

身體
TagsResponse

用戶端觸發器

如果在 timeghost 中建立、變更或刪除用戶端,則會執行此觸發程式。

參數

名稱 機碼 必要 類型 Description
工作空間
workspace-id True string

輸入儲存資料的工作區 (工作區識別碼)

Webhook 的名稱
name True string

Webhook 的名稱,以便可以在 timeghost 的設定中找到它。

運行
events array of string

選取要收聽的事件

傳回

定義

專案回應

名稱 路徑 類型 Description
ID
id string

專案的唯一ID

名稱
name string

專案名稱

Description
description string

項目說明

可計費
billable boolean

指出專案是否標示為可計費

基於任務的估計
taskBasedEstimation boolean

指出預算是否與任務相依

判斷
estimation double

項目的預算預估

完成
completed boolean

指出專案是否標示為已完成

用作預設值
useAsDefault boolean

指出是否將此專案用作預設專案

計費時間
timesRecorded.billable number

本專案的計費時間摘要

非計費時間
timesRecorded.notBillable number

本專案中不可計費時間摘要

收益
earnings double

項目收益

已啟用小時費率
hourly_rate_enabled boolean

指出是否已啟用小時費率

時薪
hourly_rate double

本項目的小時費率

顏色
color string

專案的顏色。 例如,'#0000FF'

私人
private boolean

指出專案是否標示為私人

地位
status string

指出資料記錄是剛建立、更新還是刪除

用戶端識別碼
client.id string

用戶端的唯一 ID

客戶名稱
client.name string

客戶名稱

tags
tags array of object
標籤 ID
tags.id string

標籤的唯一ID

標記名稱
tags.name string

標籤名稱

users
users array of object
使用者識別碼
users.id string

使用者的唯一 ID

Role
users.role number

使用者在專案中的角色

計費費率
users.billable_rate double

此專案中使用者的計費費率

Removed
users.removed boolean

指出使用者是否已從專案中移除

groups
groups array of object
群組識別碼
groups.id string

群組的唯一ID

Role
groups.role number

群組在專案中的角色

Removed
groups.removed boolean

指出群組是否已從專案中移除

工作區識別碼
workspace.id string

工作區的唯一識別碼

分割區索引鍵
partitionKey string

CosmosDB 的分割區索引鍵

Cosmos 實體名稱
cosmosEntityName string

此專案的 Cosmos 實體名稱

可以編輯
currentUserCanEdit boolean

指出目前使用者是否可以編輯專案

客戶回應

名稱 路徑 類型 Description
ID
id string

用戶端的唯一 ID

名稱
name string

客戶姓名

Description
description string

客戶描述

顏色
color string

與用戶端相關聯的色彩

已刪除
deleted boolean

指出用戶端是否標示為已刪除

用作預設值
useAsDefault boolean

指出此用戶端是否用作預設用戶端

地位
status string

指出資料記錄是剛建立、更新還是刪除

已建立
created date-time

建立用戶端的時間戳記

修改
modified date-time

上次修改用戶端的時間戳記

Cosmos 實體名稱
cosmosEntityName string

此用戶端的 Cosmos 實體名稱

分割區索引鍵
partitionKey string

CosmosDB 的分割區索引鍵

工作區識別碼
workspace.id string

工作區的唯一識別碼

電話
meta.phone string

客戶的電話號碼

地點
meta.location string

客戶所在地

Email
meta.email string

客戶的電子郵件地址

主要聯絡人
meta.primaryContact string

客戶的主要聯絡人

次要聯絡人
meta.secondaryContact string

客戶的次要聯絡人

登機日期
meta.onboardDate date

客戶的入職日期

稅率
meta.taxRate string

適用於客戶的稅率

外部 ID
meta.externalId string

用於與另一個系統對映的外部 ID

可以編輯
currentUserCanEdit boolean

指出目前使用者是否可以編輯用戶端

時代回應

名稱 路徑 類型 Description
ID
id string

當時的唯一ID

時間名稱
name string

時間名稱

已刪除
deleted boolean

指出時間是否標示為已刪除

可計費
billable boolean

指出時間是否標示為可計費

開始
start date-time

時間項目的開始日期和開始時間

結束
end date-time

時間項目的結束日期和結束時間

持續時間
timeDiff number

時間項目的持續時間

Timezone
timeZone string

指出建立時間的時區

賺錢
amount double

時間條目的收益

費用
cost double

時間輸入的人工成本

專案識別碼
project.id string

本次項目的唯一ID

專案名稱
project.name string

專案名稱

完成
project.completed boolean

指出專案是否標示為已完成

用作預設值
project.useAsDefault boolean

指出是否將此專案用作預設專案

tags
project.tags array of object
標籤 ID
project.tags.id string

標籤的唯一ID

標記名稱
project.tags.name string

標籤名稱

工作識別碼
task.id string

這次任務的唯一ID

任務名稱
task.name string

任務名稱

完成
task.completed boolean

指出工作是否標示為已完成

用戶端識別碼
client.id string

這次客戶端的唯一ID

客戶名稱
client.name string

客戶名稱

使用者識別碼
user.id string

本次用戶的唯一ID

使用者名稱
user.name string

使用者名稱

tags
tags array of object
標籤 ID
tags.id string

這次標籤的唯一ID

標記名稱
tags.name string

標籤名稱

Outlook 行事曆參考
outlookCalenderReference string

Outlook 行事曆事件的參考

工作區識別碼
workspace.id string

工作區的唯一識別碼

時間重疊
hasTimeOverlap boolean

指出是否有時間重疊

輸入模式
inputMode string

輸入模式,例如“範圍”

已建立
created date-time

指出時間的建立時間

修改
modified date-time

指示時間變更的時間

地位
status string

指出資料記錄是剛建立、更新還是刪除

Cosmos 實體名稱
cosmosEntityName string

這次的 Cosmos 實體名稱

分割區索引鍵
partitionKey string

CosmosDB 的分割區索引鍵

可以編輯
currentUserCanEdit boolean

指出目前使用者是否可以編輯時間項目

TasksUpdate回應

名稱 路徑 類型 Description
ID
id string

工作的唯一ID

名稱
name string

任務名稱

已刪除
deleted boolean

指出工作是否標示為已刪除

已建立
created date-time

指出工作建立時間

修改
modified date-time

指出任務變更的時間

完成
completed boolean

指出工作是否標示為已完成

計費時間
timesRecorded.billable number

此工作中的計費時間摘要

不計費時間
timesRecorded.notBillable number

此工作中不可計費時間的摘要

地位
status string

指出資料記錄是剛建立、更新還是刪除

用戶端識別碼
client.id string

此工作用戶端的唯一 ID

客戶名稱
client.name string

客戶名稱

專案識別碼
project.id string

此任務專案的唯一 ID

專案名稱
project.name string

專案名稱

項目已完成
project.completed boolean

指出專案是否標示為已完成

判斷
estimation double

任務的預估預算

assignedToUsers
assignedToUsers array of object
使用者識別碼
assignedToUsers.id string

指派使用者的唯一ID

使用者名
assignedToUsers.name string

已指派使用者的名稱

assignedToGroups
assignedToGroups array of object
群組識別碼
assignedToGroups.id string

指派群組的唯一ID

群組名稱
assignedToGroups.name string

指派群組的名稱

工作區識別碼
workspace.id string

工作區的唯一識別碼

Cosmos 實體名稱
cosmosEntityName string

此工作的 Cosmos 實體名稱

分割區索引鍵
partitionKey string

CosmosDB 的分割區索引鍵

可以編輯
currentUserCanEdit boolean

指出目前使用者是否可以編輯任務

群組回應

名稱 路徑 類型 Description
ID
id string

群組的唯一ID

名稱
name string

群組名稱

已同步處理
synchronizedGroup boolean

指出群組是否已同步處理

同步群組類型
synchronizedGroupType string

同步群組的類型(例如「團隊」)

users
users array of object
使用者識別碼
users.id string

使用者的唯一 ID

名稱
users.name string

使用者名稱

工作區識別碼
workspace.id string

工作區的唯一識別碼

Cosmos 實體名稱
cosmosEntityName string

此群組的 Cosmos 實體名稱

分割區索引鍵
partitionKey string

CosmosDB 的分割區索引鍵

已建立
created date-time

指出群組的建立時間

修改
modified date-time

指出群組變更的時間

地位
status string

指出資料記錄是剛建立、更新還是刪除

可以編輯
currentUserCanEdit boolean

指出目前使用者是否可以編輯群組

標籤回應

名稱 路徑 類型 Description
ID
id string

標籤的唯一ID

名稱
name string

標籤名稱

已刪除
deleted boolean

指出標籤是否標示為已刪除

已建立
created date-time

指出標籤的建立時間

修改
modified date-time

指出標籤何時變更

地位
status string

指出資料記錄是剛建立、更新還是刪除

外部 ID
externalId string

此值可用來儲存來自另一個系統的 ID。 有一個簡單的映射。

標籤類型
tagType integer

標籤的類型(例如類別識別碼)

工作區識別碼
workspace.id string

工作區的唯一識別碼

Cosmos 實體名稱
cosmosEntityName string

此標籤的 Cosmos 實體名稱

分割區索引鍵
partitionKey string

CosmosDB 的分割區索引鍵

可以編輯
currentUserCanEdit boolean

指出目前使用者是否可以編輯標籤

CustomFeedEvent回應

名稱 路徑 類型 Description
ID
id string

自訂摘要事件的唯一ID

已刪除
deleted boolean

指出自訂摘要事件是否標示為已刪除

已建立
created date-time

指出自訂摘要事件的建立時間

修改
modified date-time

指出自訂摘要事件變更的時間

地位
status string

指出資料記錄是剛建立、更新還是刪除

名稱
name string

自訂摘要事件名稱

Description
description string

參賽作品說明

開始
start date-time

摘要項目的開始日期和開始時間

結束
end date-time

摘要項目的結束日期和結束時間

圖示 URL
imageUrl string

圖示 Url,顯示在摘要項目中。 最好使用 96px96px 和 https。

網址
url string

外部位址的 URL。 例如,詳細資料頁面。 摘要中的此連結可透過內容功能表開啟。

類別
category string

此值可用來篩選介面中的摘要。

外部 ID
externalId string

此值可用來儲存來自另一個系統的 ID。 有一個簡單的映射。

使用者回應

名稱 路徑 類型 Description
ID
id string

使用者的唯一 ID

已刪除
deleted boolean

指出使用者是否標示為已刪除

電子郵件
email string

使用者的電子郵件地址

預設工作區識別碼
defaultWorkspace string

使用者預設工作區的工作區識別碼

workspaces
workspaces array of object
工作區識別碼
workspaces.id string

工作區的唯一識別碼

工作區名稱
workspaces.name string

工作區的名稱

擷取手動模式
settings.captureManualMode boolean

指示是否啟用手動擷取模式

Feed Show 已預訂
settings.feedShowBooked boolean

指出摘要是否顯示已預約時間

語言設定
settings.languageSetting string

使用者的語言設定(例如「en-US」)

時區
settings.timeZone string

使用者的時區(例如「歐洲/阿姆斯特丹」)

24小時時間格式
settings.timeFormat24h boolean

指出使用者是否偏好 24 小時時間格式

日期格式
settings.dateFormat string

使用者偏好的日期格式

Theme
settings.theme string

使用者的 UI 佈景主題設定

已啟用四捨五入
settings.rounding.enabled boolean

指出是否已啟用時間四捨五入

四捨五入分鐘
settings.rounding.minutes integer

四捨五入的分鐘數

四捨五入類型
settings.rounding.type integer

捨入類型(例如,0 表示最接近)

組織名稱
organization.displayName string

組織名稱

enabledGraphScopes
enabledGraphScopes array of string
api權杖
apiTokens array of object
權杖名稱
apiTokens.name string

API 權杖的名稱

代幣
apiTokens.token string

API 權杖值

釘選專案
pinnedProjects array of object
專案識別碼
pinnedProjects.id string

釘選專案的唯一識別碼

專案名稱
pinnedProjects.name string

釘選專案的名稱

顯示名稱
officeProfile.displayName string

使用者在辦公室設定檔中的顯示名稱

Email
officeProfile.mail string

辦公室設定檔中的電子郵件地址

使用者主體名稱
officeProfile.userPrincipalName string

Office 設定檔中的使用者主體名稱

工作區回應

名稱 路徑 類型 Description
ID
id string

工作區的唯一識別碼

名稱
name string

工作區名稱

Description
description string

工作區說明

已刪除
deleted boolean

指出工作區是否標示為已刪除

新專案預設為計費
settings.isNewProjectBillable boolean

指出新專案是否預設計費

時薪
settings.hourly_rate double

此工作區的預設小時費率

貨幣
settings.currency string

此工作區的預設貨幣

允許未來時間追蹤嗎?
settings.allowFutureTimeTracking boolean

指出是否允許未來時間追蹤

允許時間重疊
settings.allowTimeOverlap boolean

指出是否允許重疊的時間項目

啟用 Comego
settings.comego boolean

指出工作區是否已啟用 Comego

僅限 Comego
settings.comegoOnly boolean

指出是否只啟用 Comego 追蹤

時間模式
settings.timesMode string

時間追蹤模式(例如,'範圍')

訂閱狀態
subscription.status string

工作區訂用帳戶的狀態 (例如,「作用中」、「試用」)

訂閱結束
subscription.end date-time

訂閱的結束時間

數量
subscription.quantity double

此工作區中的授權數目

Provider
subscription.provider string

訂閱的提供者 (例如,「paddle」)

週期間隔
subscription.recurringInterval string

訂閱的週期性間隔

貨幣
subscription.currency string

訂閱中使用的貨幣

users
users array of object
使用者識別碼
users.id string

使用者的唯一 ID

名稱
users.name string

使用者名稱

Email
users.email string

使用者的電子郵件地址

是管理員
users.admin boolean

指出使用者是否具有管理員權限

計費費率
users.billable_rate double

此工作區中使用者的小時費率

人工成本
users.labor_cost double

此工作區中使用者的人工成本

有許可證
users.has_license boolean

指出使用者在工作區中是否具有授權

Removed
users.removed boolean

指出使用者是否已從工作區中移除

groups
groups array of object
群組識別碼
groups.id string

群組的唯一ID

群組名稱
groups.name string

群組名稱

同步群組
groups.synchronizedGroup boolean

指出群組是否已同步處理

同步群組類型
groups.synchronizedGroupType string

同步群組的類型(例如「團隊」)

users
groups.users array of object
使用者識別碼
groups.users.id string

使用者的唯一 ID

使用者名
groups.users.name string

群組中的使用者名稱

群組可以管理專案
permissionSettings.groupsCanManageProjects array of object
群組識別碼
permissionSettings.groupsCanManageProjects.id string

群組的唯一ID

群組CanSeeTeamActivity
permissionSettings.groupsCanSeeTeamActivity array of object
群組識別碼
permissionSettings.groupsCanSeeTeamActivity.id string

群組的唯一ID

專案權限
projectPermissions array of object
專案識別碼
projectPermissions.projectId string

專案的唯一ID

私人
projectPermissions.private boolean

指出專案是否為私人

users
projectPermissions.users array of object
使用者識別碼
projectPermissions.users.id string

使用者的唯一 ID

Role
projectPermissions.users.role number

使用者在專案中的角色

groups
projectPermissions.groups array of object
群組識別碼
projectPermissions.groups.id string

群組的唯一ID

Role
projectPermissions.groups.role number

群組在專案中的角色

webhooks
webhooks array of object
Webhook 名稱
webhooks.name string

Webhook 的名稱

實體
webhooks.entity string

Webhook 附加的實體

Active
webhooks.active boolean

指出 Webhook 是否處於作用中狀態

可以編輯
currentUserCanEdit boolean

指出目前使用者是否可以編輯工作區

ComeGo回應

名稱 路徑 類型 Description
識別碼
id string

ComeGo 條目的唯一 ID

cosmosEntityName
cosmosEntityName string

資料庫中的實體名稱

已刪除
deleted boolean

指出項目是否標示為已刪除

編輯器
editor string

上次修改項目的編輯者 ID

modified
modified date-time

上次修改項目的時間戳記

作者
author string

建立專案的作者 ID

創建
created date-time

建立項目的時間戳記

狀態
status string

條目的狀態(例如,“新”)

partitionKey
partitionKey string

資料庫中項目的分割區索引鍵

名稱
name string

項目的選擇性名稱

start
start date-time

參賽開始時間

結束
end date-time

參賽作品的結束時間(如適用)

型別
type string

項目類型(例如,“工作”、“休息”)

識別碼
user.id string

使用者的唯一 ID

名稱
user.name string

用戶的名稱

tags
tags array of string

與項目相關聯的標籤

timeZone
timeZone string

參賽項目的時區

識別碼
workspace.id string

工作區的唯一識別碼

currentUser可以編輯
currentUserCanEdit boolean

指出目前使用者是否有權編輯項目

物件

這是類型 'object'。