Harvest

Harvest は、チームが各プロジェクトとタスクに費やした時間を追跡するのに役立つシンプルなツールです。

このコネクタは、次の製品および地域で利用可能です。

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
コネクタのメタデータ
公開元 Microsoft
Web サイト https://www.getharvest.com/
プライバシー ポリシー https://www.getharvest.com/privacy-policy

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒
トリガー ポーリングの頻度 1 60 秒

アクション

ID で時間入力を取得

ID で既存の時間エントリを取得します。

すべてのクライアントを一覧表示

認証されたアカウントのすべてのクライアントのリストを取得します。

すべての取引先担当者を一覧表示する

認証されたユーザーのすべての取引先担当者のリストを取得します。

タスクの一覧表示

すべてのタスクのリストを取得します。

プロジェクトを一覧表示する

現在のユーザーのすべてのプロジェクトを一覧表示します。

ユーザーをプロジェクトに追加します

既存ユーザーをグループに追加します。

ユーザー情報を取得

ユーザー ID またはメールでユーザーの詳細を取得します。

新しいクライアントの追加

新しいクライアントの作成。

新しいユーザーの追加

新しいユーザーを作成します。

新しい取引先担当者の追加

新しい取引先担当者を作成する。

時間エントリの削除

既存の時間エントリを削除します。

時間エントリを更新する

既存の時間エントリを更新します。

時間入力の作成

新しい時間エントリを作成します。

ID で時間入力を取得

ID で既存の時間エントリを取得します。

パラメーター

名前 キー 必須 説明
時間入力 ID
DAY_ENTRY_ID True string

時間入力の ID

戻り値

すべてのクライアントを一覧表示

認証されたアカウントのすべてのクライアントのリストを取得します。

戻り値

すべての取引先担当者を一覧表示する

認証されたユーザーのすべての取引先担当者のリストを取得します。

戻り値

タスクの一覧表示

すべてのタスクのリストを取得します。

戻り値

プロジェクトを一覧表示する

現在のユーザーのすべてのプロジェクトを一覧表示します。

戻り値

ユーザーをプロジェクトに追加します

既存ユーザーをグループに追加します。

パラメーター

名前 キー 必須 説明
プロジェクト ID
project_id True string

プロジェクト ID

ユーザー ID
id True integer

ユーザー

ユーザー情報を取得

ユーザー ID またはメールでユーザーの詳細を取得します。

パラメーター

名前 キー 必須 説明
ユーザー ID またはメール
USERID True string

ユーザー ID またはメール

戻り値

本文​​
GetUserByID_Response

新しいクライアントの追加

新しいクライアントの作成。

パラメーター

名前 キー 必須 説明
件名
name True string

クライアント名

通貨
currency string

クライアントに使用したい通貨。

通貨記号
currency_symbol string

選択した通貨に関連する記号。

詳細情報
details string

追加の詳細。通常、住所情報に使用されます。

新しいユーザーの追加

新しいユーザーを作成します。

パラメーター

名前 キー 必須 説明
電子メール
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

新しい取引先担当者の追加

新しい取引先担当者を作成する。

パラメーター

名前 キー 必須 説明
クライアント ID
client_id True integer

クライアントを表す一意識別子。

first_name True string

取引先担当者の名。

last_name True string

取引先担当者の姓。

電子メール
email string

取引先担当者のメール。

オフィスの電話
phone_office string

取引先担当者のオフィスの電話。

携帯電話
phone_mobile string

取引先担当者の携帯電話。

FAX
fax string

取引先担当者の FAX。

敬称
title string

取引先担当者の役職。

時間エントリの削除

既存の時間エントリを削除します。

パラメーター

名前 キー 必須 説明
時間入力 ID
DAY_ENTRY_ID True string

時間入力の ID

時間エントリを更新する

既存の時間エントリを更新します。

パラメーター

名前 キー 必須 説明
時間入力 ID
DAY_ENTRY_ID True string

時間入力の ID

プロジェクト ID
project_id True string

Project

タスク ID
task_id True string

タスク​

メモ
notes string
開始日時
started_at string

YYYY-MM-DDThh:mm:ssZ (UTC形式)。

終了日時
ended_at string

YYYY-MM-DDThh:mm:ssZ (UTC形式)。

spent_at string

YYYY-MM-DDThh:mm:ssZ (UTC形式)。

戻り値

時間入力の作成

新しい時間エントリを作成します。

パラメーター

名前 キー 必須 説明
注意
notes string
時間
hours integer
プロジェクト ID
project_id True string

Project

タスク ID
task_id True string

タスク​

spent_at string

費やした

戻り値

トリガー

クライアントが追加されたとき

新しいクライアントが追加されたときにトリガーします。

プロジェクトが作成されたとき

新しいプロジェクトが作成されたときにトリガーされます。

ユーザーの追加時

新しいユーザーが追加されたときにトリガーします。

取引先担当者が追加されたとき

新しい取引先担当者が追加されたときにトリガーします。

日付の時間エントリが作成されたとき

特定の日付に新しい時間エントリが作成されたときにトリガーされます。

現在の日に時間エントリを作成する場合

当日の新しい時間エントリが作成されたときにトリガーされます。

クライアントが追加されたとき

新しいクライアントが追加されたときにトリガーします。

戻り値

名前 パス 説明
クライアント ID
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形式)。

住所
client.address string

クライアントの住所。

通貨記号
client.currency_symbol string

選択した通貨に関連する記号。

詳細情報
client.details string

追加の詳細。通常、住所情報に使用されます。

プロジェクトが作成されたとき

新しいプロジェクトが作成されたときにトリガーされます。

戻り値

名前 パス 説明
プロジェクト ID
project.id integer

プロジェクトを表す一意識別子。

クライアント ID
project.client_id integer

プロジェクトのクライアントの ID。

件名
project.name string

プロジェクト名。

コード
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

追跡された経費を含めるための総プロジェクト料金プロジェクトの予算のオプション。

ユーザーの追加時

新しいユーザーが追加されたときにトリガーします。

戻り値

本文​​
GetUserByID_Response

取引先担当者が追加されたとき

新しい取引先担当者が追加されたときにトリガーします。

戻り値

名前 パス 説明
取引先担当者 ID
contact.id integer

取引先担当者を表す一意の識別子です。

クライアント ID
contact.client_id integer

クライアントを表す一意識別子。

contact.first_name string

取引先担当者の名。

contact.last_name string

取引先担当者の姓。

電子メール
contact.email string

取引先担当者のメール。

オフィスの電話
contact.phone_office string

取引先担当者のオフィスの電話。

携帯電話
contact.phone_mobile string

取引先担当者の携帯電話。

FAX
contact.fax string

取引先担当者の FAX。

敬称
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形式)。

日付の時間エントリが作成されたとき

特定の日付に新しい時間エントリが作成されたときにトリガーされます。

パラメーター

名前 キー 必須 説明
date True string

YYYY-MM-DD または ISO 形式の日時

その他のユーザー ID
of_user string

時間エントリを確認するユーザーの ID。

戻り値

現在の日に時間エントリを作成する場合

当日の新しい時間エントリが作成されたときにトリガーされます。

パラメーター

名前 キー 必須 説明
その他のユーザー ID
of_user string

時間エントリを確認するユーザーの ID。 既定は ID です。

戻り値

定義

ListAllContacts_Response

名前 パス 説明
取引先担当者 ID
contact.id integer

取引先担当者を表す一意の識別子です。

クライアント ID
contact.client_id integer

クライアントを表す一意識別子。

contact.first_name string

取引先担当者の名。

contact.last_name string

取引先担当者の姓。

電子メール
contact.email string

取引先担当者のメール。

オフィスの電話
contact.phone_office string

取引先担当者のオフィスの電話。

携帯電話
contact.phone_mobile string

取引先担当者の携帯電話。

FAX
contact.fax string

取引先担当者の FAX。

敬称
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

名前 パス 説明
クライアント ID
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形式)。

住所
client.address string

クライアントの住所。

通貨記号
client.currency_symbol string

選択した通貨に関連する記号。

詳細情報
client.details string

追加の詳細。通常、住所情報に使用されます。

UpdateTimeEntry_Response

名前 パス 説明
時間入力 ID
id integer

エンティティを表す一意識別子。

ユーザー ID
user_id integer

時間入力を作成したユーザーの一意識別子。

spent_at string

時間エントリの日付。

作成日時
created_at date-time

YYYY-MM-DDThh:mm:ssZ (UTC形式)。

更新日時
updated_at date-time

YYYY-MM-DDThh:mm:ssZ (UTC形式)。

プロジェクト ID
project_id string

プロジェクト時間エントリの ID が関連付けられています。

タスク ID
task_id string

タスク時間エントリの ID が関連付けられています。

Project
project string

時間エントリが関連付けられているプロジェクトの名前。

タスク​
task string

時間エントリが関連付けられているタスクの名前。

クライアント
client string

時間エントリが関連付けられているクライアントの名前。

メモ
notes string

時間エントリ メモ。

タイマーなしの時間
hours_without_timer float

タイマーが実行されていない場合に追跡される現在の時間。

時間
hours float

この時間エントリで追跡された (10 進時間) 時間数。

ListProjects_Response

名前 パス 説明
プロジェクト ID
project.id integer

プロジェクトを表す一意識別子。

クライアント ID
project.client_id integer

プロジェクトのクライアントの ID。

件名
project.name string

プロジェクト名。

コード
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

名前 パス 説明
タスク ID
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

名前 パス 説明
ユーザー ID
user.id integer

ユーザーの一意識別子。

電子メール
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

ユーザーの 1 週間の容量。

GetTimeEntriesForDay_Response

名前 パス 説明
day_entries
day_entries array of object

day_entries

プロジェクト ID
day_entries.project_id string

プロジェクトを表す一意識別子。

プロジェクト名
day_entries.project string

プロジェクトの名前です。

ユーザー ID
day_entries.user_id integer

ユーザーの一意識別子。

day_entries.spent_at string

YYYY-MM-DD

タスク ID
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

この時間エントリで追跡された (10 進時間) 時間数。