时间幽灵
timeghost 是一种专用Microsoft 365 /Office 365 解决方案，可与工作环境完美集成。 使用 timeghost 连接器生成时间报告、发票和其他文档。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | timeghost 支持 |
| URL | https://support.timeghost.io |
| support@timeghost.io |
| 连接器元数据 | |
|---|---|
| 发布者 | timeghost.io |
| Website | https://timeghost.io |
| 隐私策略 | https://timeghost.io/privacy-policy/ |
| 类别 | 生产力;商业智能 |
时间幽灵
timeghost 是一种专用Microsoft 365 /Office 365 解决方案，可与工作环境完美集成。 使用 timeghost Flow 连接器生成时间报告、发票和其他文档。
先决条件
若要使用此连接器，需要有工作、学校或Microsoft个人帐户。 还需要通过执行以下两个步骤之一来接受 timeghost 的权限和同意：
现在，你已准备好开始使用此连接器。
支持的作
连接器支持以下作：
-
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 秒 |
操作
| 创建时间 Excel 报表 |
返回包含指定时间的报表的 Excel 文件。 |
| 删除项目 |
从工作区中删除项。 |
| 按 ID 获取工作区 |
返回工作区 |
| 更新任何标记 |
更新工作区中的时间标记。 |
| 更新任务 |
更新工作区中的任务。 |
| 更新客户端 |
更新工作区中的客户端。 |
| 更新工作时间 |
更新工作区中的工作时间。 |
| 更新时间 |
更新工作区中的时间。 |
| 更新时间标记 |
更新工作区中的时间标记。 |
| 更新组 |
更新工作区中的组。 |
| 更新自定义源事件 |
更新工作区中的自定义源条目。 |
| 更新项目 |
更新工作区中的项目。 |
| 更新项目的标记 |
更新工作区中的项目标记。 |
| 更新项目的用户 |
更新工作区中的项目用户。 |
| 更新项目的组 |
更新工作区中的项目组。 |
| 添加任何标记 |
将时间标记添加到工作区。 |
| 添加任务 |
将任务添加到工作区。 |
| 添加客户端 |
将客户端添加到工作区。 |
| 添加工作时间 |
将工作时间添加到工作区。 |
| 添加时间 |
将时间添加到工作区中的项目。 |
| 添加组 |
将组添加到工作区。 |
| 添加自定义源事件 |
将事件添加到用户源。 条目在 180 天后自动删除。 |
| 添加项目 |
将项目添加到工作区。 |
| 获取客户端 |
从工作区获取所有客户端。 |
| 获取客户端时间 |
获取一个工作区中一个客户端的所有时间。 |
| 获取客户端项目 |
获取一个工作区中一个客户端的所有项目。 |
| 获取工作区组 |
从工作区获取所有组。 |
| 获取工作时间 |
从工作区获取所有工作时间。 |
| 获取当前用户 |
返回具有工作区的当前用户对象 |
| 获取时间 |
从工作区获取所有时间。 |
| 获取标签 |
从工作区获取所有标记。 |
| 获取项目 |
从工作区获取所有项目。 |
| 获取项目任务 |
获取一个工作区中一个项目的所有任务。 |
| 获取项目时间 |
获取一个工作区中一个项目的所有时间。 |
创建时间 Excel 报表
返回包含指定时间的报表的 Excel 文件。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
startDate
|
startDate | True | date-time | |
|
结束日期
|
endDate | True | date-time | |
|
计费
|
billable | string | ||
|
客户端
|
client | boolean | ||
|
项目
|
project | boolean | ||
|
projectDescription
|
projectDescription | boolean | ||
|
任务
|
task | boolean | ||
|
描述
|
description | boolean | ||
|
作者
|
author | boolean | ||
|
groupedByProject
|
groupedByProject | True | boolean | |
|
项目状态
|
projectStatus | string | ||
|
enabled
|
enabled | boolean | ||
|
分钟数
|
minutes | integer | ||
|
类型
|
type | string | ||
|
timeZone
|
timeZone | string | ||
|
users
|
users | array of uuid |
返回
Excel 文件
- Excel 文件
- object
删除项目
从工作区中删除项。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
项目类型
|
ItemType | True | string |
要删除的项的类型 |
|
物料 ID
|
ItemId | True | string |
将删除的项的 ID |
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
按 ID 获取工作区
返回工作区
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | string |
输入在其中存储数据的工作区（工作区 ID） |
|
|
工作空间
|
workspace_id | True | string |
工作区 ID |
返回
- Body
- WorkspaceResponse
更新任何标记
更新工作区中的时间标记。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
标记
|
TagId | True | string |
标记（或标记 ID） |
|
Name
|
name | True | string |
标记的名称 |
|
标记类型
|
tagType | True | integer |
标记的类型 |
|
外部 ID
|
externalId | string |
此值可用于存储另一个系统中的 ID 进行映射。 |
|
|
Cosmos 实体名称
|
cosmosEntityName | string |
Cosmos DB 中使用的实体名称 |
|
|
已删除
|
deleted | boolean |
指示是否已删除标记 |
|
|
作者
|
author | string |
标记的作者 |
|
|
Editor
|
editor | string |
标记的最后一个编辑器 |
|
|
工作区 ID
|
id | string |
工作区 ID |
|
|
分区键
|
partitionKey | string |
Cosmos DB 中的分区键 |
|
|
状态
|
status | string |
标记的状态 |
|
|
已创建
|
created | date-time |
标记的创建时间戳 |
|
|
已修改
|
modified | date-time |
标记的上次修改时间戳 |
返回
- Body
- TagsResponse
更新任务
更新工作区中的任务。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
任务
|
TaskId | True | string |
任务（或任务 ID） |
|
Name
|
name | string |
任务的名称 |
|
|
估计（秒）
|
estimation | double |
任务的估计工期（以秒为单位） |
|
|
完成
|
completed | boolean |
指示任务是否已标记为已完成 |
|
|
客户
|
id | True | string |
客户端（或客户端 ID） |
|
Name
|
name | string |
客户端名称 |
|
|
项目
|
id | True | string |
项目（或项目 ID） |
|
Name
|
name | string |
项目名称 |
|
|
完成
|
completed | boolean |
指示项目是否已标记为已完成 |
|
|
ID
|
id | True | string |
群组标识符 |
|
Name
|
name | True | string |
组名称 |
|
已分配的用户
|
assignedToUsers | array of string | ||
|
状态
|
status | string |
任务的状态 |
|
|
计费时间
|
billable | double |
为此任务记录的计费时间 |
|
|
非计费时间
|
notBillable | double |
为此任务记录的非计费时间 |
|
|
工作区 ID
|
id | string |
工作区 ID |
|
|
Cosmos 实体名称
|
cosmosEntityName | string |
Cosmos DB 中使用的实体名称 |
|
|
分区键
|
partitionKey | string |
Cosmos DB 中的分区键 |
|
|
已创建
|
created | date-time |
任务的创建时间戳 |
|
|
已修改
|
modified | date-time |
任务的上次修改时间戳 |
|
|
作者
|
author | string |
任务作者 |
|
|
Editor
|
editor | string |
任务的最后一个编辑器 |
|
|
可以创建时间
|
canCreateTime | boolean |
指示是否可以为此任务创建时间条目 |
|
|
可以编辑
|
canEdit | boolean |
指示当前用户可以编辑此任务 |
返回
- Body
- TasksUpdateResponse
更新客户端
更新工作区中的客户端。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
客户
|
ClientId | True | string |
客户端（或客户端 ID） |
|
Name
|
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
|
id | string |
工作区 ID |
|
|
分区键
|
partitionKey | string |
Cosmos DB 中的分区键 |
|
|
状态
|
status | string |
客户端的状态 |
|
|
已创建
|
created | date-time |
客户端的创建时间戳 |
|
|
已修改
|
modified | date-time |
客户端的上次修改时间戳 |
|
|
电话
|
phone | string |
电话号码 |
|
|
位置
|
location | string |
客户端的位置 |
|
|
Email
|
string |
客户端的电子邮件 |
||
|
主要联系人
|
primaryContact | string |
主要联系人姓名 |
|
|
辅助联系人
|
secondaryContact | string |
辅助联系人姓名 |
|
|
载入日期
|
onboardDate | date |
载入客户端的日期 |
|
|
行业
|
industry | string |
客户端行业 |
返回
- Body
- ClientsResponse
更新工作时间
更新工作区中的工作时间。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
实体名称
|
cosmosEntityName | string |
实体类型，始终为“comego” |
|
|
已删除
|
deleted | boolean |
指示是否将条目标记为已删除 |
|
|
编辑器 ID
|
editor | string |
上次编辑条目的用户的 ID |
|
|
作者 ID
|
author | string |
创建条目的用户的 ID |
|
|
创建的时间戳
|
created | date-time |
创建条目时的时间戳 |
|
|
修改后的时间戳
|
modified | date-time |
上次修改条目时的时间戳 |
|
|
条目 ID
|
id | string |
ComeGo 条目的唯一 ID |
|
|
状态
|
status | string |
条目的状态（例如“new”） |
|
|
开始时间
|
start | date-time |
ISO 8601 格式的工作条目的开始时间 |
|
|
结束时间
|
end | date-time |
工作条目的结束时间（采用 ISO 8601 格式） |
|
|
Name
|
name | string |
条目的名称可以为 null |
|
|
分区键
|
partitionKey | string |
CosmosDB 中条目的分区键 |
|
|
时区
|
timeZone | string |
记录条目的时区（例如“欧洲/柏林”） |
|
|
类型
|
type | string |
条目的类型（例如，“work”） |
|
|
用户 ID
|
id | string |
与此条目关联的用户的唯一 ID |
|
|
用户名
|
name | string |
与此条目关联的用户的名称 |
|
|
工作区 ID
|
id | string |
工作区的唯一 ID |
|
|
标记
|
tags | array of string |
与条目关联的标记数组 |
|
|
用户可以编辑
|
currentUserCanEdit | boolean |
指示当前用户是否可以编辑条目 |
返回
- Body
- ComeGoResponse
更新时间
更新工作区中的时间。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
时间 ID
|
TimeId | True | string |
要更新的时间的唯一 ID |
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
客户
|
id | True | string |
客户端（或客户端 ID） |
|
Name
|
name | string |
客户端名称 |
|
|
项目
|
id | True | string |
项目（或项目 ID） |
|
Name
|
name | string |
项目名称 |
|
|
完成
|
completed | boolean |
指示项目是否已完成 |
|
|
任务
|
id | True | string |
任务（或任务 ID） |
|
Name
|
name | string |
任务名称 |
|
|
完成
|
completed | boolean |
指示任务是否已完成 |
|
|
Name
|
name | string |
此时间条目的名称（任务名称） |
|
|
Start
|
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
|
name | string |
标记名称 |
|
|
时区
|
timeZone | string |
时间条目的时区 |
|
|
输入模式
|
inputMode | string |
时间输入的输入模式（例如范围） |
|
|
时差
|
timeDiff | integer |
时间差（以秒为单位） |
|
|
Outlook 日历参考
|
outlookCalenderReference | string |
引用 Outlook 日历事件（如果适用） |
|
|
Cosmos 实体名称
|
cosmosEntityName | string |
Cosmos DB 中使用的实体名称 |
|
|
分区键
|
partitionKey | string |
Cosmos DB 中的分区键 |
|
|
状态
|
status | string |
时间条目的状态 |
|
|
用户
|
id | True | string |
用户（或用户 ID） - 如果为空，则设置当前用户 |
|
Name
|
name | string |
用户名 |
|
|
工作区 ID
|
id | string |
工作区 ID |
|
|
已创建
|
created | date-time |
时间条目的创建时间戳 |
|
|
已修改
|
modified | date-time |
时间条目的上次修改时间戳 |
返回
- Body
- TimesResponse
更新时间标记
更新工作区中的时间标记。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
时间 ID
|
TimeId | True | string |
要更新的时间的唯一 ID |
|
标记
|
id | True | string |
标记（或标记 ID） |
返回
- Body
- TimesResponse
更新组
更新工作区中的组。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
组
|
GroupId | True | string |
组（或组 ID） |
|
ID
|
id | True | string |
群组标识符 |
|
Name
|
name | True | string |
组名称 |
|
同步组
|
synchronizedGroup | boolean |
指示组是否已同步 |
|
|
同步组类型
|
synchronizedGroupType | string |
同步组的类型（如果适用） |
|
|
用户 ID
|
id | True | string |
用户 ID |
|
Email
|
True | string |
用户电子邮件 |
|
|
Name
|
name | string |
用户名 |
返回
- Body
- GroupsResponse
更新自定义源事件
更新工作区中的自定义源条目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
ID
|
EventId | True | string |
自定义源事件 ID |
|
Name
|
name | string |
条目的名称 |
|
|
Description
|
description | string |
条目说明 |
|
|
用户
|
id | True | string |
用户（或用户 ID） |
|
Start
|
start | date-time |
源条目的开始日期和开始时间 |
|
|
结束
|
end | date-time |
源条目的结束日期和时间 |
|
|
图标 URL
|
imageUrl | string |
显示在源条目中的图标 URL。 最好使用 96px96px 和 https。 |
|
|
网址
|
url | string |
外部地址的 URL。 例如详细信息页。 可以通过上下文菜单打开源中的此链接。 |
|
|
类别
|
category | string |
使用稍后可以在接口中筛选的值。 例如“Planner”。 |
|
|
外部 ID
|
externalId | string |
此值可用于存储另一个系统中的 ID。 具有简单的映射。 |
返回
更新项目
更新工作区中的项目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
项目
|
ProjectId | True | string |
项目（或项目 ID） |
|
Name
|
name | True | string |
项目的名称 |
|
Description
|
description | string |
项目说明 |
|
|
客户
|
id | True | string |
客户端（或客户端 ID） |
|
Name
|
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 |
指示是否为项目启用每小时费率 |
|
|
用户
|
id | True | string |
用户（或用户 ID） |
|
角色
|
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
|
id | string |
工作区 ID |
|
|
Cosmos 实体名称
|
cosmosEntityName | string |
Cosmos DB 中使用的实体名称 |
|
|
作者
|
author | string |
项目的作者 |
|
|
Editor
|
editor | string |
项目的编辑器 |
|
|
分区键
|
partitionKey | string |
Cosmos DB 中的分区键 |
返回
- Body
- ProjectsResponse
更新项目的标记
更新工作区中的项目标记。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
项目
|
ProjectId | True | string |
项目（或项目 ID） |
|
标记
|
id | True | string |
标记（或标记 ID） |
返回
- Body
- ProjectsResponse
更新项目的用户
更新工作区中的项目用户。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
项目
|
ProjectId | True | string |
项目（或项目 ID） |
|
用户
|
id | True | string |
用户（或用户 ID） |
|
角色
|
role | True | number |
项目中的角色 |
|
计费费率
|
billable_rate | double |
此项目中此用户的计费费率 |
返回
- Body
- ProjectsResponse
更新项目的组
更新工作区中的项目组。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
项目
|
ProjectId | True | string |
项目（或项目 ID） |
|
组
|
id | True | string |
组（或组 ID） |
|
角色
|
role | True | number |
项目中的角色 |
返回
- Body
- ProjectsResponse
添加任何标记
将时间标记添加到工作区。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
Name
|
name | True | string |
标记的名称 |
|
tagType
|
tagType | True | integer |
为项目标记选择 0 或时间标记 1 |
返回
- Body
- TagsResponse
添加任务
将任务添加到工作区。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
Name
|
name | True | string |
任务的名称 |
|
估计（秒）
|
estimation | True | double |
任务的估计工期（以秒为单位） |
|
项目
|
id | True | string |
项目（或项目 ID） |
|
Name
|
name | string |
项目名称 |
|
|
Cosmos 实体名称
|
cosmosEntityName | string |
Cosmos DB 中的实体名称 |
|
|
已删除
|
deleted | boolean |
指示项目是否已删除 |
|
|
Editor
|
editor | string |
项目的最后一个编辑器 |
|
|
ID
|
id | True | string |
群组标识符 |
|
Name
|
name | True | string |
组名称 |
|
用户
|
users | array of string |
分配给此组的用户 |
|
|
同步组
|
synchronizedGroup | boolean |
指示组是否已同步 |
|
|
已分配的用户
|
assignedToUsers | array of string | ||
|
外部 ID
|
externalId | string |
此值可用于存储另一个系统中的 ID。 具有简单的映射。 |
返回
- Body
- TasksUpdateResponse
添加客户端
将客户端添加到工作区。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
Name
|
name | True | string |
客户端名称 |
|
Description
|
description | string |
客户端的说明 |
返回
- Body
- ClientsResponse
添加工作时间
将工作时间添加到工作区。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
Name
|
name | string |
条目的名称可以为 null |
|
|
开始时间
|
start | date-time |
ISO 8601 格式的工作条目的开始时间 |
|
|
结束时间
|
end | date-time |
ISO 8601 格式的工作条目的结束时间（如果持续）可以为 null |
|
|
类型
|
type | string |
条目的类型（例如，“work”） |
|
|
时区
|
timeZone | string |
记录条目的时区（例如“欧洲/柏林”） |
|
|
用户 ID
|
id | string |
与此条目关联的用户的唯一 ID |
返回
- Body
- ComeGoResponse
添加时间
将时间添加到工作区中的项目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
客户
|
id | True | string |
客户端（或客户端 ID） |
|
项目
|
id | True | string |
项目（或项目 ID） |
|
任务
|
id | True | string |
任务（或任务 ID） |
|
Cosmos 实体名称
|
cosmosEntityName | string |
Cosmos DB 中用于任务的实体名称 |
|
|
已删除
|
deleted | boolean |
指示是否已删除任务 |
|
|
Name
|
name | True | string |
此时间条目的名称（任务名称） |
|
Start
|
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 日历事件（如果适用） |
返回
- Body
- TimesResponse
添加组
将组添加到工作区。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
Name
|
name | True | string |
组名称 |
|
用户 ID
|
id | True | string |
用户 ID |
|
同步组
|
synchronizedGroup | boolean |
指示组是否已同步 |
|
|
同步组类型
|
synchronizedGroupType | string |
同步组的类型（如果适用） |
返回
- Body
- GroupsResponse
添加自定义源事件
将事件添加到用户源。 条目在 180 天后自动删除。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
Name
|
name | True | string |
条目的名称 |
|
Description
|
description | string |
条目说明 |
|
|
用户
|
id | True | string |
用户（或用户 ID） |
|
Start
|
start | True | date-time |
源条目的开始日期和开始时间 |
|
结束
|
end | True | date-time |
源条目的结束日期和时间 |
|
图标 URL
|
imageUrl | string |
显示在源条目中的图标 URL。 最好使用 96px96px 和 https。 |
|
|
网址
|
url | string |
外部地址的 URL。 例如详细信息页。 可以通过上下文菜单打开源中的此链接。 |
|
|
类别
|
category | string |
使用稍后可以在接口中筛选的值。 例如“Planner”。 |
|
|
外部 ID
|
externalId | string |
此值可用于存储另一个系统中的 ID。 具有简单的映射。 |
返回
添加项目
将项目添加到工作区。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
Name
|
name | True | string |
项目的名称 |
|
Description
|
description | string |
项目说明 |
|
|
客户
|
id | True | string |
客户端（或客户端 ID） |
|
Name
|
name | string |
客户端名称 |
|
|
颜色
|
color | string |
项目的颜色，例如 “#0000FF” |
|
|
可计费
|
billable | True | boolean |
指示项目是否标记为可计费 |
|
完成
|
completed | boolean |
指示项目是否已标记为已完成 |
|
|
基于任务的估计
|
taskBasedEstimation | True | boolean |
预算依赖于任务。 |
|
估计
|
estimation | double |
项目的估计预算 |
|
|
专用
|
private | True | boolean |
将项目设置为公共项目或专用项目。 |
|
项目类型
|
projectType | string |
设置项目类型 |
|
|
用户
|
id | True | string |
用户（或用户 ID） |
|
角色
|
role | True | number |
项目中的角色 |
|
计费费率
|
billable_rate | double |
此项目中此用户的计费费率 |
|
|
Removed
|
removed | boolean |
指示用户是否已从项目中删除 |
|
|
标记
|
tags | array of string |
与项目关联的标记 |
|
|
Groups
|
groups | array of string |
与项目关联的组 |
|
|
谁可以添加任务
|
whoCanAddTasks | integer |
谁可以向此项目添加任务（例如，1 = 仅经理，2 = 每个人） |
|
|
模板编号
|
templateId | string |
项目模板的 ID |
|
|
模板复制速率
|
templateCopyRate | boolean |
指示是否从模板复制速率 |
|
|
模板复制任务
|
templateCopyTasks | boolean |
指示是否从模板复制任务 |
|
|
模板复制任务分配
|
templateCopyTaskAssign | boolean |
指示是否从模板复制任务分配 |
返回
- Body
- ProjectsResponse
获取客户端
从工作区获取所有客户端。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
筛选查询
|
$filter | string |
用于限制返回的客户端的 ODATA 筛选器查询 |
|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
返回
- response
- array of ClientsResponse
获取客户端时间
获取一个工作区中一个客户端的所有时间。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
客户
|
clientid | True | string |
客户端（或客户端 ID） |
|
日期范围
|
$filter-date-range | True | string |
按范围筛选时间 |
|
按用户筛选
|
$filter-user | string |
按用户筛选时间 |
|
|
筛选查询
|
$filter | string |
用于限制返回时间的 ODATA 筛选器查询 |
返回
- response
- array of TimesResponse
获取客户端项目
获取一个工作区中一个客户端的所有项目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
客户
|
clientid | True | string |
客户端（或客户端 ID） |
|
筛选查询
|
$filter | string |
用于限制返回项目的 ODATA 筛选器查询 |
返回
- response
- array of ProjectsResponse
获取工作区组
从工作区获取所有组。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
返回
- response
- array of GroupsResponse
获取工作时间
从工作区获取所有工作时间。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
按用户筛选
|
$filter-user | string |
按用户筛选时间 |
|
|
筛选查询
|
$filter | string |
用于限制返回时间的 ODATA 筛选器查询 |
返回
- response
- array of ComeGoResponse
获取当前用户
获取时间
从工作区获取所有时间。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
日期范围
|
$filter-date-range | True | string |
按范围筛选时间 |
|
按用户筛选
|
$filter-user | string |
按用户筛选时间 |
|
|
筛选查询
|
$filter | string |
用于限制返回时间的 ODATA 筛选器查询 |
返回
- response
- array of TimesResponse
获取标签
从工作区获取所有标记。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
筛选查询
|
$filter | string |
用于限制返回项目的 ODATA 筛选器查询 |
返回
- response
- array of TagsResponse
获取项目
从工作区获取所有项目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
筛选查询
|
$filter | string |
用于限制返回项目的 ODATA 筛选器查询 |
|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
返回
- response
- array of ProjectsResponse
获取项目任务
获取一个工作区中一个项目的所有任务。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
客户
|
clientid | string |
客户端（或客户端 ID） |
|
|
项目
|
projectid | True | string |
项目（或项目 ID） |
|
筛选查询
|
$filter | string |
用于限制返回任务的 ODATA 筛选器查询 |
返回
- response
- array of TasksUpdateResponse
获取项目时间
获取一个工作区中一个项目的所有时间。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
客户
|
clientid | string |
客户端（或客户端 ID） |
|
|
项目
|
projectid | True | string |
项目（或项目 ID） |
|
日期范围
|
$filter-date-range | True | string |
按范围筛选时间 |
|
按用户筛选
|
$filter-user | string |
按用户筛选时间 |
|
|
筛选查询
|
$filter | string |
用于限制返回时间的 ODATA 筛选器查询 |
返回
- response
- array of TimesResponse
触发器
| 任务触发器 |
如果任务是在 timeghost 中创建、更改或删除的，则此触发器将运行。 |
| 客户端触发器 |
如果客户端是在 timeghost 中创建、更改或删除的，则此触发器将运行。 |
| 时间触发器 |
如果在 timeghost 中创建、更改或删除时间，则此触发器将运行。 |
| 标记触发器 |
如果在 timeghost 中创建、更改或删除标记，则此触发器将运行。 |
| 项目触发器 |
如果项目是在 timeghost 中创建、更改或删除的，则此触发器将运行。 |
任务触发器
如果任务是在 timeghost 中创建、更改或删除的，则此触发器将运行。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
Webhook 的名称
|
name | True | string |
Webhook 的名称，以便可以在 timeghost 的设置中找到它。 |
|
运行方式
|
events | array of string |
选择要侦听的事件 |
返回
- Body
- TasksUpdateResponse
客户端触发器
如果客户端是在 timeghost 中创建、更改或删除的，则此触发器将运行。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
Webhook 的名称
|
name | True | string |
Webhook 的名称，以便可以在 timeghost 的设置中找到它。 |
|
运行方式
|
events | array of string |
选择要侦听的事件 |
返回
- Body
- ClientsResponse
时间触发器
如果在 timeghost 中创建、更改或删除时间，则此触发器将运行。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
Webhook 的名称
|
name | True | string |
Webhook 的名称，以便可以在 timeghost 的设置中找到它。 |
|
运行方式
|
events | array of string |
选择要侦听的事件 |
返回
- Body
- TimesResponse
标记触发器
如果在 timeghost 中创建、更改或删除标记，则此触发器将运行。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
Webhook 的名称
|
name | True | string |
Webhook 的名称，以便可以在 timeghost 的设置中找到它。 |
|
运行方式
|
events | array of string |
选择要侦听的事件 |
返回
- Body
- TagsResponse
项目触发器
如果项目是在 timeghost 中创建、更改或删除的，则此触发器将运行。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作空间
|
workspace-id | True | string |
输入在其中存储数据的工作区（工作区 ID） |
|
Webhook 的名称
|
name | True | string |
Webhook 的名称，以便可以在 timeghost 的设置中找到它。 |
|
运行方式
|
events | array of string |
选择要侦听的事件 |
返回
- Body
- ProjectsResponse
定义
ProjectsResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | string |
项目的唯一 ID |
|
Name
|
name | string |
项目名称 |
|
Description
|
description | string |
项目说明 |
|
可计费
|
billable | boolean |
指示项目是否标记为可计费 |
|
基于任务的估计
|
taskBasedEstimation | boolean |
指示预算是否依赖于任务 |
|
估计
|
estimation | double |
项目的估计预算 |
|
完成
|
completed | boolean |
指示项目是否已标记为已完成 |
|
用作默认值
|
useAsDefault | boolean |
指示此项目是否用作默认值 |
|
计费时间
|
timesRecorded.billable | number |
此项目中计费时间的摘要 |
|
不可计费时间
|
timesRecorded.notBillable | number |
此项目中不可计费时间的摘要 |
|
Earnings
|
earnings | double |
项目收益 |
|
已启用每小时费率
|
hourly_rate_enabled | boolean |
指示是否启用了每小时费率 |
|
小时费率
|
hourly_rate | double |
此项目的每小时费率 |
|
颜色
|
color | string |
项目的颜色。 例如“#0000FF” |
|
专用
|
private | boolean |
指示项目是否标记为私有 |
|
状态
|
status | string |
指示是否已创建、更新或删除数据记录 |
|
客户 ID
|
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 | |
|
用户 ID
|
users.id | string |
用户的唯一 ID |
|
角色
|
users.role | number |
项目中用户的角色 |
|
计费费率
|
users.billable_rate | double |
此项目中用户的计费费率 |
|
Removed
|
users.removed | boolean |
指示用户是否已从项目中删除 |
|
groups
|
groups | array of object | |
|
群组标识符
|
groups.id | string |
组的唯一 ID |
|
角色
|
groups.role | number |
项目中组的角色 |
|
Removed
|
groups.removed | boolean |
指示组是否已从项目中删除 |
|
工作区 ID
|
workspace.id | string |
工作区的唯一 ID |
|
分区键
|
partitionKey | string |
CosmosDB 的分区键 |
|
Cosmos 实体名称
|
cosmosEntityName | string |
此项目的 Cosmos 实体名称 |
|
可以编辑
|
currentUserCanEdit | boolean |
指示当前用户是否可以编辑项目 |
ClientsResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | string |
客户端的唯一 ID |
|
Name
|
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 的分区键 |
|
工作区 ID
|
workspace.id | string |
工作区的唯一 ID |
|
电话
|
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 |
指示当前用户可以编辑客户端 |
TimesResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | string |
时间的唯一 ID |
|
时间名称
|
name | string |
时间名称 |
|
已删除
|
deleted | boolean |
指示时间是否标记为已删除 |
|
可计费
|
billable | boolean |
指示时间是否标记为可计费 |
|
Start
|
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 |
标记的名称 |
|
任务 ID
|
task.id | string |
此时间任务的唯一 ID |
|
任务名称
|
task.name | string |
任务名称 |
|
完成
|
task.completed | boolean |
指示任务是否已标记为已完成 |
|
客户 ID
|
client.id | string |
此时间客户端的唯一 ID |
|
客户端名称
|
client.name | string |
客户端名称 |
|
用户 ID
|
user.id | string |
此时间用户的唯一 ID |
|
用户名称
|
user.name | string |
用户名称 |
|
tags
|
tags | array of object | |
|
标记 ID
|
tags.id | string |
此时间标记的唯一 ID |
|
标记名称
|
tags.name | string |
标记的名称 |
|
Outlook 日历参考
|
outlookCalenderReference | string |
对 Outlook 日历事件的引用 |
|
工作区 ID
|
workspace.id | string |
工作区的唯一 ID |
|
时间重叠
|
hasTimeOverlap | boolean |
指示是否存在时间重叠 |
|
输入模式
|
inputMode | string |
输入模式，例如“range” |
|
已创建
|
created | date-time |
指示创建时间的时间 |
|
已修改
|
modified | date-time |
指示何时更改时间 |
|
状态
|
status | string |
指示是否已创建、更新或删除数据记录 |
|
Cosmos 实体名称
|
cosmosEntityName | string |
这一次 Cosmos 实体名称 |
|
分区键
|
partitionKey | string |
CosmosDB 的分区键 |
|
可以编辑
|
currentUserCanEdit | boolean |
指示当前用户可以编辑时间条目 |
TasksUpdateResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | string |
任务的唯一 ID |
|
Name
|
name | string |
任务的名称 |
|
已删除
|
deleted | boolean |
指示任务是否标记为已删除 |
|
已创建
|
created | date-time |
指示何时创建任务 |
|
已修改
|
modified | date-time |
指示任务何时更改 |
|
完成
|
completed | boolean |
指示任务是否已标记为已完成 |
|
记帐时间
|
timesRecorded.billable | number |
此任务的计费时间摘要 |
|
不可计费的时间
|
timesRecorded.notBillable | number |
此任务中不可计费时间的摘要 |
|
状态
|
status | string |
指示是否已创建、更新或删除数据记录 |
|
客户 ID
|
client.id | string |
此任务客户端的唯一 ID |
|
客户端名称
|
client.name | string |
客户端名称 |
|
项目标识
|
project.id | string |
此任务项目的唯一 ID |
|
项目的名称
|
project.name | string |
项目的名称 |
|
项目已完成
|
project.completed | boolean |
指示项目是否已标记为已完成 |
|
估计
|
estimation | double |
任务的估计预算 |
|
assignedToUsers
|
assignedToUsers | array of object | |
|
用户 ID
|
assignedToUsers.id | string |
已分配用户的唯一 ID |
|
用户名
|
assignedToUsers.name | string |
分配的用户的名称 |
|
assignedToGroups
|
assignedToGroups | array of object | |
|
群组标识符
|
assignedToGroups.id | string |
分配组的唯一 ID |
|
组名称
|
assignedToGroups.name | string |
已分配组的名称 |
|
工作区 ID
|
workspace.id | string |
工作区的唯一 ID |
|
Cosmos 实体名称
|
cosmosEntityName | string |
此任务的 Cosmos 实体名称 |
|
分区键
|
partitionKey | string |
CosmosDB 的分区键 |
|
可以编辑
|
currentUserCanEdit | boolean |
指示当前用户是否可以编辑任务 |
GroupsResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | string |
组的唯一 ID |
|
Name
|
name | string |
组的名称 |
|
Synchronized
|
synchronizedGroup | boolean |
指示组是否已同步 |
|
同步组类型
|
synchronizedGroupType | string |
同步组的类型（例如“teams”） |
|
users
|
users | array of object | |
|
用户 ID
|
users.id | string |
用户的唯一 ID |
|
Name
|
users.name | string |
用户名 |
|
工作区 ID
|
workspace.id | string |
工作区的唯一 ID |
|
Cosmos 实体名称
|
cosmosEntityName | string |
此组的 Cosmos 实体名称 |
|
分区键
|
partitionKey | string |
CosmosDB 的分区键 |
|
已创建
|
created | date-time |
指示何时创建组 |
|
已修改
|
modified | date-time |
指示组何时更改 |
|
状态
|
status | string |
指示是否已创建、更新或删除数据记录 |
|
可以编辑
|
currentUserCanEdit | boolean |
指示当前用户是否可以编辑组 |
TagsResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | string |
标记的唯一 ID |
|
Name
|
name | string |
标记的名称 |
|
已删除
|
deleted | boolean |
指示标记是否标记为已删除 |
|
已创建
|
created | date-time |
指示何时创建标记 |
|
已修改
|
modified | date-time |
指示标记何时更改 |
|
状态
|
status | string |
指示是否已创建、更新或删除数据记录 |
|
外部 ID
|
externalId | string |
此值可用于存储另一个系统中的 ID。 具有简单的映射。 |
|
标记类型
|
tagType | integer |
标记的类型（例如类别标识符） |
|
工作区 ID
|
workspace.id | string |
工作区的唯一 ID |
|
Cosmos 实体名称
|
cosmosEntityName | string |
此标记的 Cosmos 实体名称 |
|
分区键
|
partitionKey | string |
CosmosDB 的分区键 |
|
可以编辑
|
currentUserCanEdit | boolean |
指示当前用户可以编辑标记 |
CustomFeedEventResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | string |
自定义源事件的唯一 ID |
|
已删除
|
deleted | boolean |
指示自定义源事件是否标记为已删除 |
|
已创建
|
created | date-time |
指示何时创建了自定义源事件 |
|
已修改
|
modified | date-time |
指示自定义源事件何时更改 |
|
状态
|
status | string |
指示是否已创建、更新或删除数据记录 |
|
Name
|
name | string |
自定义源事件的名称 |
|
Description
|
description | string |
条目说明 |
|
Start
|
start | date-time |
源条目的开始日期和开始时间 |
|
结束
|
end | date-time |
源条目的结束日期和时间 |
|
图标 URL
|
imageUrl | string |
显示在源条目中的图标 URL。 最好使用 96px96px 和 https。 |
|
网址
|
url | string |
外部地址的 URL。 例如详细信息页。 可以通过上下文菜单打开源中的此链接。 |
|
类别
|
category | string |
此值可用于筛选接口中的源。 |
|
外部 ID
|
externalId | string |
此值可用于存储另一个系统中的 ID。 具有简单的映射。 |
UserResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | string |
用户的唯一 ID |
|
已删除
|
deleted | boolean |
指示用户是否标记为已删除 |
|
电子邮件
|
string |
用户的电子邮件地址 |
|
|
默认工作区 ID
|
defaultWorkspace | string |
用户的默认工作区的工作区 ID |
|
workspaces
|
workspaces | array of object | |
|
工作区 ID
|
workspaces.id | string |
工作区的唯一 ID |
|
工作区名称
|
workspaces.name | string |
工作区的名称 |
|
捕获手动模式
|
settings.captureManualMode | boolean |
指示是否启用了手动捕获模式 |
|
订阅源显示已预订
|
settings.feedShowBooked | boolean |
指示源是否显示已预订时间 |
|
语言设置
|
settings.languageSetting | string |
用户的语言设置（例如，'en-US'） |
|
时区
|
settings.timeZone | string |
用户的时区（例如“欧洲/阿姆斯特丹”） |
|
24 小时时间格式
|
settings.timeFormat24h | boolean |
指示用户是否首选 24 小时时间格式 |
|
日期格式
|
settings.dateFormat | string |
用户的首选日期格式 |
|
主题
|
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 | |
|
apiTokens
|
apiTokens | array of object | |
|
令牌名称
|
apiTokens.name | string |
API 令牌的名称 |
|
标记
|
apiTokens.token | string |
API 令牌值 |
|
pinnedProjects
|
pinnedProjects | array of object | |
|
项目标识
|
pinnedProjects.id | string |
固定项目的唯一 ID |
|
项目名称
|
pinnedProjects.name | string |
固定项目的名称 |
|
显示名称
|
officeProfile.displayName | string |
Office 配置文件中的用户显示名称 |
|
Email
|
officeProfile.mail | string |
Office 配置文件中的电子邮件地址 |
|
用户主体名称
|
officeProfile.userPrincipalName | string |
Office 配置文件中的用户主体名称 |
WorkspaceResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | string |
工作区的唯一 ID |
|
Name
|
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 |
时间跟踪模式（例如“range”） |
|
订阅状态
|
subscription.status | string |
工作区订阅的状态（例如“active”、“trial”） |
|
订阅结束
|
subscription.end | date-time |
订阅的结束时间 |
|
数量
|
subscription.quantity | double |
此工作区中的许可证数 |
|
Provider
|
subscription.provider | string |
订阅的提供商（例如“划桨”） |
|
定期间隔
|
subscription.recurringInterval | string |
订阅的定期间隔 |
|
货币
|
subscription.currency | string |
订阅中使用的货币 |
|
users
|
users | array of object | |
|
用户 ID
|
users.id | string |
用户的唯一 ID |
|
Name
|
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 |
同步组的类型（例如“teams”） |
|
users
|
groups.users | array of object | |
|
用户 ID
|
groups.users.id | string |
用户的唯一 ID |
|
用户名
|
groups.users.name | string |
组中用户的名称 |
|
groupsCanManageProjects
|
permissionSettings.groupsCanManageProjects | array of object | |
|
群组标识符
|
permissionSettings.groupsCanManageProjects.id | string |
组的唯一 ID |
|
groupsCanSeeTeamActivity
|
permissionSettings.groupsCanSeeTeamActivity | array of object | |
|
群组标识符
|
permissionSettings.groupsCanSeeTeamActivity.id | string |
组的唯一 ID |
|
projectPermissions
|
projectPermissions | array of object | |
|
项目标识
|
projectPermissions.projectId | string |
项目的唯一 ID |
|
专用
|
projectPermissions.private | boolean |
指示项目是否为专用项目 |
|
users
|
projectPermissions.users | array of object | |
|
用户 ID
|
projectPermissions.users.id | string |
用户的唯一 ID |
|
角色
|
projectPermissions.users.role | number |
项目中用户的角色 |
|
groups
|
projectPermissions.groups | array of object | |
|
群组标识符
|
projectPermissions.groups.id | string |
组的唯一 ID |
|
角色
|
projectPermissions.groups.role | number |
项目中组的角色 |
|
webhooks
|
webhooks | array of object | |
|
Webhook 名称
|
webhooks.name | string |
Webhook 的名称 |
|
实体
|
webhooks.entity | string |
Webhook 附加到的实体 |
|
活跃
|
webhooks.active | boolean |
指示 Webhook 是否处于活动状态 |
|
可以编辑
|
currentUserCanEdit | boolean |
指示当前用户可以编辑工作区 |
ComeGoResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
id
|
id | string |
ComeGo 条目的唯一 ID |
|
cosmosEntityName
|
cosmosEntityName | string |
数据库中的实体名称 |
|
已删除
|
deleted | boolean |
指示是否将条目标记为已删除 |
|
编辑器
|
editor | string |
上次修改条目的编辑器的 ID |
|
modified
|
modified | date-time |
上次修改条目时的时间戳 |
|
作者
|
author | string |
创建条目的作者的 ID |
|
已创建
|
created | date-time |
创建条目时的时间戳 |
|
状态
|
status | string |
条目的状态（例如“new”） |
|
partitionKey
|
partitionKey | string |
数据库中条目的分区键 |
|
姓名
|
name | string |
条目的可选名称 |
|
开始
|
start | date-time |
条目的开始时间 |
|
end
|
end | date-time |
条目的结束时间（如果适用） |
|
类型
|
type | string |
条目类型（例如“work”、“break”） |
|
id
|
user.id | string |
用户的唯一 ID |
|
姓名
|
user.name | string |
用户名 |
|
tags
|
tags | array of string |
与条目关联的标记 |
|
timeZone
|
timeZone | string |
条目的时区 |
|
id
|
workspace.id | string |
工作区的唯一 ID |
|
currentUserCanEdit
|
currentUserCanEdit | boolean |
指示当前用户是否有权编辑条目 |
对象
这是类型“object”。