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 |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
| コネクタのメタデータ | |
|---|---|
| 公開元 | 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 |
追加の詳細。通常、住所情報に使用されます。 |
新しいユーザーの追加
新しいユーザーを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
電子メール
|
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 |
取引先担当者の姓。 |
|
電子メール
|
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 |
追跡された経費を含めるための総プロジェクト料金プロジェクトの予算のオプション。 |
ユーザーの追加時
取引先担当者が追加されたとき
新しい取引先担当者が追加されたときにトリガーします。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
取引先担当者 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 進時間) 時間数。 |