收穫

Harvest 是一個簡單的工具，可幫助跟踪您的團隊在每個項目和任務上花費的時間。

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

服務	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）

連絡人
名稱	Microsoft
URL	Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援

連接器中繼資料
Publisher	Microsoft
網站	https://www.getharvest.com/
隱私策略	https://www.getharvest.com/privacy-policy

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒
觸發輪詢的頻率	1	60 秒

動作

列出專案	列出目前使用者的所有專案。
列出工作	擷取所有工作的清單。
列出所有客戶端	擷取已驗證帳戶之所有用戶端清單。
列出所有聯絡人	擷取已驗證使用者的所有連絡人清單。
刪除時間項目	刪除現有的時間項目。
取得使用者資訊	透過使用者 ID 或電子郵件擷取使用者的詳細資料。
將使用者新增至專案	將現有使用者新增至專案。
建立時間項目	建立新的時間項目。
新增使用者	建立新使用者。
新增客戶端	建立新用戶端。
新增聯絡人	建立新聯絡人。
更新時間項目	更新現有的時間項目。
通過 ID 獲取時間條目	依 ID 取得現有時間項目。

列出專案

作業識別碼：: ListProjects

列出目前使用者的所有專案。

傳回

物品: ListProjects_Response

列出工作

作業識別碼：: ListTasks

擷取所有工作的清單。

傳回

物品: ListTasks_Response

列出所有客戶端

作業識別碼：: ListAllClients

擷取已驗證帳戶之所有用戶端清單。

傳回

物品: ListAllClients_Response

列出所有聯絡人

作業識別碼：: ListAllContacts

擷取已驗證使用者的所有連絡人清單。

傳回

物品: ListAllContacts_Response

刪除時間項目

作業識別碼：: DeleteTimeEntry

刪除現有的時間項目。

參數

名稱	機碼	必要	類型	Description
時間項目標識符	DAY_ENTRY_ID	True	string	時間項目的 ID

取得使用者資訊

作業識別碼：: GetUser

透過使用者 ID 或電子郵件擷取使用者的詳細資料。

參數

名稱	機碼	必要	類型	Description
使用者 ID 或電子郵件	USERID	True	string	使用者 ID 或電子郵件

傳回

身體: GetUserByID_Response

將使用者新增至專案

作業識別碼：: AddUserToProject

將現有使用者新增至專案。

參數

名稱	機碼	必要	類型	Description
專案編號	project_id	True	string	專案編號
使用者 ID	id	True	integer	User

建立時間項目

作業識別碼：: CreateTimeEntry

建立新的時間項目。

參數

名稱	機碼	必要	類型	Description
附註	notes		string
小時	hours		integer
專案編號	project_id	True	string	專案
任務標識符	task_id	True	string	任務
Date	spent_at		string	花費於

傳回

身體: UpdateTimeEntry_Response

新增使用者

作業識別碼：: CreateUser

建立新使用者。

參數

名稱	機碼	必要	類型	Description
Email	email	True	string
是管理員	is_admin		boolean
名字	first_name	True	string
姓氏	last_name	True	string
是承包商	is_contractor		boolean
電話	telephone		string
小時費率	default_hourly_rate		float	預設小時費率。
部門	department		string
成本費率	cost_rate		float

新增客戶端

作業識別碼：: AddNewClient

建立新用戶端。

參數

名稱	機碼	必要	類型	Description
名稱	name	True	string	客戶姓名
貨幣	currency		string	您要為用戶端使用的貨幣。
貨幣符號	currency_symbol		string	與所選貨幣相關的符號。
詳細資訊	details		string	其他詳細資料，通常用於地址資訊。

新增聯絡人

作業識別碼：: AddNewContact

建立新聯絡人。

參數

名稱	機碼	必要	類型	Description
用戶端識別碼	client_id	True	integer	用戶端的唯一識別碼。
名字	first_name	True	string	連絡人的名字。
姓氏	last_name	True	string	連絡人的姓氏。
Email	email		string	連絡人的電子郵件。
辦公室電話	phone_office		string	連絡人辦公室電話。
行動電話	phone_mobile		string	聯絡人的手機。
傳真	fax		string	聯絡人的傳真。
Title	title		string	連絡人的標題。

更新時間項目

作業識別碼：: UpdateTimeEntry

更新現有的時間項目。

參數

名稱	機碼	必要	類型	Description
時間項目標識符	DAY_ENTRY_ID	True	string	時間項目的 ID
專案編號	project_id	True	string	專案
任務標識符	task_id	True	string	任務
註釋	notes		string
開始日期時間	started_at		string	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
結束日期時間	ended_at		string	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
Date	spent_at		string	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。

傳回

身體: UpdateTimeEntry_Response

通過 ID 獲取時間條目

作業識別碼：: GetTimeEntry

依 ID 取得現有時間項目。

參數

名稱	機碼	必要	類型	Description
時間項目標識符	DAY_ENTRY_ID	True	string	時間項目的 ID

傳回

身體: UpdateTimeEntry_Response

觸發程序

建立專案時	建立新專案時觸發。
建立日期的時間項目時	當為特定日期建立新的時間項目時觸發。
新增使用者時	新增使用者時觸發。
新增用戶端時	新增用戶端時觸發。
新增連絡人時	新增聯絡人時觸發。
為當天建立時間項目時	當為當天建立新的時間項目時觸發。

建立專案時

作業識別碼：: TrigNewProject

建立新專案時觸發。

傳回

名稱	路徑	類型	Description
專案編號	project.id	integer	專案的唯一識別碼。
用戶端識別碼	project.client_id	integer	專案的用戶端識別碼。
名稱	project.name	string	專案名稱。
Code	project.code	string	專案程式碼。
處於活動狀態	project.active	boolean	如果專案目前處於作用中狀態，則為 True。
可計費	project.billable	boolean	如果專案可計費，則為 true。
帳單依附者	project.bill_by	string	專案開立發票的方法。
小時費率	project.hourly_rate	float	按小時計費。
預算	project.budget	float	專案的預算值。
預算依據	project.budget_by	string	專案的預算方法。
建立日期-時間	project.created_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
更新日期時間	project.updated_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
開始日期	project.starts_on	string	YYYY-MM-DD
結束日期	project.ends_on	string	YYYY-MM-DD
估計值	project.estimate	float	項目估算。
估計為	project.estimate_by	string	項目的估算方法。
最早記錄日期	project.hint_earliest_record_at	string	YYYY-MM-DD
最遲記錄日期	project.hint_latest_record_at	string	YYYY-MM-DD
註釋	project.notes	string	項目筆記。
成本預算	project.cost_budget	float	專案費用總計專案的預算值。
成本預算包括費用	project.cost_budget_include_expenses	boolean	專案總費用專案預算的選項，以包含追蹤的費用。

建立日期的時間項目時

作業識別碼：: TrigNewTimeEntry

當為特定日期建立新的時間項目時觸發。

參數

名稱	機碼	必要	類型	Description
Date	date	True	string	YYYY-MM-DD 或 ISO 格式日期時間
其他使用者 ID	of_user		string	要檢查時間項目的使用者 ID。

傳回

身體: GetTimeEntriesForDay_Response

新增使用者時

作業識別碼：: TrigNewUser

新增使用者時觸發。

傳回

身體: GetUserByID_Response

新增用戶端時

作業識別碼：: TrigNewClient

新增用戶端時觸發。

傳回

名稱	路徑	類型	Description
用戶端識別碼	client.id	integer	用戶端的唯一識別碼。
名稱	client.name	string	客戶名稱。
貨幣	client.currency	string	用於客戶計費的貨幣。
更新日期時間	client.updated_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
建立日期-時間	client.created_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
Address	client.address	string	客戶地址。
貨幣符號	client.currency_symbol	string	與所選貨幣相關的符號。
詳細資訊	client.details	string	其他詳細資料，通常用於地址資訊。

新增連絡人時

作業識別碼：: TrigNewContact

新增聯絡人時觸發。

傳回

名稱	路徑	類型	Description
聯絡人 ID	contact.id	integer	聯絡人的唯一識別碼。
用戶端識別碼	contact.client_id	integer	用戶端的唯一識別碼。
名字	contact.first_name	string	連絡人的名字。
姓氏	contact.last_name	string	連絡人的姓氏。
Email	contact.email	string	連絡人的電子郵件。
辦公室電話	contact.phone_office	string	連絡人辦公室電話。
行動電話	contact.phone_mobile	string	聯絡人的手機。
傳真	contact.fax	string	聯絡人的傳真。
Title	contact.title	string	連絡人的標題。
建立日期-時間	contact.created_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
更新日期時間	contact.updated_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。

為當天建立時間項目時

作業識別碼：: TrigNewTimeEntryToday

當為當天建立新的時間項目時觸發。

參數

名稱	機碼	必要	類型	Description
其他使用者 ID	of_user		string	要檢查時間項目的使用者 ID。預設為您的 ID。

傳回

身體: GetTimeEntriesForDay_Response

定義

ListAllContacts_Response

名稱	路徑	類型	Description
聯絡人 ID	contact.id	integer	聯絡人的唯一識別碼。
用戶端識別碼	contact.client_id	integer	用戶端的唯一識別碼。
名字	contact.first_name	string	連絡人的名字。
姓氏	contact.last_name	string	連絡人的姓氏。
Email	contact.email	string	連絡人的電子郵件。
辦公室電話	contact.phone_office	string	連絡人辦公室電話。
行動電話	contact.phone_mobile	string	聯絡人的手機。
傳真	contact.fax	string	聯絡人的傳真。
Title	contact.title	string	連絡人的標題。
建立日期-時間	contact.created_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
更新日期時間	contact.updated_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。

ListAllClients_Response

名稱	路徑	類型	Description
用戶端識別碼	client.id	integer	用戶端的唯一識別碼。
名稱	client.name	string	客戶名稱。
貨幣	client.currency	string	用於客戶計費的貨幣。
更新日期時間	client.updated_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
建立日期-時間	client.created_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
Address	client.address	string	客戶地址。
貨幣符號	client.currency_symbol	string	與所選貨幣相關的符號。
詳細資訊	client.details	string	其他詳細資料，通常用於地址資訊。

UpdateTimeEntry_Response

名稱	路徑	類型	Description
時間項目ID	id	integer	時間項目的唯一識別碼。
使用者識別碼	user_id	integer	建立時間項目之使用者的唯一識別碼。
Date	spent_at	string	時間輸入日期。
建立日期-時間	created_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
更新日期時間	updated_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
專案編號	project_id	string	專案時間項目的 ID 與相關聯。
工作標識碼	task_id	string	任務時間項目的 ID 與相關聯。
專案	project	string	與時間項目相關聯的專案名稱。
任務	task	string	與時間項目相關聯的任務名稱。
客戶	client	string	與時間項目相關聯的用戶端名稱。
註釋	notes	string	時間輸入註釋。
無計時器小時數	hours_without_timer	float	如果計時器未執行，則追蹤的目前時間量。
小時	hours	float	在此時間項目中追蹤的（十進制時間）小時數。

ListProjects_Response

名稱	路徑	類型	Description
專案編號	project.id	integer	專案的唯一識別碼。
用戶端識別碼	project.client_id	integer	專案的用戶端識別碼。
名稱	project.name	string	專案名稱。
Code	project.code	string	專案程式碼。
處於活動狀態	project.active	boolean	如果專案目前處於作用中狀態，則為 True。
可計費	project.billable	boolean	如果專案可計費，則為 true。
帳單依附者	project.bill_by	string	專案開立發票的方法。
小時費率	project.hourly_rate	float	按小時計費。
預算	project.budget	float	專案的預算值。
預算依據	project.budget_by	string	專案的預算方法。
建立日期-時間	project.created_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
更新日期時間	project.updated_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
開始日期	project.starts_on	string	YYYY-MM-DD
結束日期	project.ends_on	string	YYYY-MM-DD
估計值	project.estimate	float	項目估算。
估計為	project.estimate_by	string	項目的估算方法。
最早記錄日期	project.hint_earliest_record_at	string	YYYY-MM-DD
最遲記錄日期	project.hint_latest_record_at	string	YYYY-MM-DD
註釋	project.notes	string	項目筆記。
成本預算	project.cost_budget	float	專案費用總計專案的預算值。
成本預算包括費用	project.cost_budget_include_expenses	boolean	專案總費用專案預算的選項，以包含追蹤的費用。

ListTasks_Response

名稱	路徑	類型	Description
工作標識碼	task.id	integer	工作的唯一識別碼。
名稱	task.name	string	任務名稱。
內部	task.billable_by_default	boolean
建立日期-時間	task.created_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC）。
更新日期時間	task.updated_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC）。
預設小時費率	task.default_hourly_rate	float	任務的預設率。

GetUserByID_Response

名稱	路徑	類型	Description
使用者識別碼	user.id	integer	使用者的唯一識別碼。
Email	user.email	string	使用者的電子郵件。
建立日期-時間	user.created_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
是管理員	user.is_admin	boolean	如果使用者是系統管理員，則為 True。
名字	user.first_name	string	使用者的名字。
姓氏	user.last_name	string	使用者的姓氏。
是承包商	user.is_contractor	boolean	如果使用者是承包商，則為 True。
電話	user.telephone	string	使用者的電話。
處於活動狀態	user.is_active	boolean	如果使用者目前處於作用中狀態，則為 True。
小時費率	user.default_hourly_rate	float	用戶的小時費率
部門	user.department	string	使用者工作的部門名稱。
訂閱電子報	user.wants_newsletter	boolean	如果使用者想要訂閱電子報，則為 True。
成本費率	user.cost_rate	float	使用者的成本率。
每週產能	user.weekly_capacity	integer	使用者的每週容量。

GetTimeEntriesForDay_Response

名稱	路徑	類型	Description
day_entries	day_entries	array of object	day_entries
專案編號	day_entries.project_id	string	產品的唯一識別碼。
專案名稱	day_entries.project	string	項目的名稱。
使用者識別碼	day_entries.user_id	integer	使用者的唯一識別碼。
Date	day_entries.spent_at	string	YYYY-MM-DD
工作標識碼	day_entries.task_id	string	與時間項目相關聯的任務 ID。
任務	day_entries.task	string	與時間項目相關聯的任務名稱。
客戶	day_entries.client	string	與時間項目相關聯的用戶端名稱。
時間項目ID	day_entries.id	integer	時間項目的唯一識別碼。
註釋	day_entries.notes	string	時間輸入註釋。
開始日期時間	day_entries.started_at	string	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
結束日期時間	day_entries.ended_at	string	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
建立日期-時間	day_entries.created_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
更新日期時間	day_entries.updated_at	date-time	YYYY-MM-DDThh：mm：ssZ （UTC 格式）。
無計時器小時數	day_entries.hours_without_timer	float	如果計時器未執行，則追蹤的目前時間量。
小時	day_entries.hours	float	在此時間項目中追蹤的（十進制時間）小時數。

共用方式為

收穫