収穫
Harvest は、チームが各プロジェクトとタスクに費やした時間を追跡するのに役立つ簡単なツールです。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft |
| URL |
Microsoft LogicApps のサポート Microsoft Power Automate のサポート Microsoft Power Apps のサポート |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Website | 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 |
User |
プロジェクトを一覧表示する
ユーザー情報を取得する
ユーザー ID または電子メールでユーザーの詳細を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
ユーザー ID または電子メール
|
USERID | True | string |
ユーザー ID または電子メール |
戻り値
- Body
- 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 | string |
連絡先の FAX。 |
|
|
Title
|
title | string |
連絡先のタイトル。 |
時刻エントリを作成する
新しい時刻エントリを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
注釈
|
notes | string | ||
|
時間
|
hours | integer | ||
|
プロジェクト ID
|
project_id | True | string |
プロジェクト |
|
タスク ID
|
task_id | True | string |
Task |
|
日付
|
spent_at | string |
支出日 |
戻り値
時刻エントリを更新する
既存の時刻エントリを更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タイム エントリ ID
|
DAY_ENTRY_ID | True | string |
時刻エントリの ID |
|
プロジェクト ID
|
project_id | True | string |
プロジェクト |
|
タスク ID
|
task_id | True | string |
Task |
|
注記
|
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 形式)。 |
戻り値
時間エントリを削除する
既存の時刻エントリを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
タイム エントリ ID
|
DAY_ENTRY_ID | True | string |
時刻エントリの ID |
トリガー
| クライアントが追加されたとき |
新しいクライアントが追加されたときにトリガーされます。 |
| プロジェクトの作成時 |
新しいプロジェクトが作成されたときにトリガーされます。 |
| ユーザーが追加されたとき |
新しいユーザーが追加されたときにトリガーされます。 |
| 日付の時刻エントリが作成されたとき |
特定の日付に対して新しい時刻エントリが作成されたときにトリガーされます。 |
| 現在の日の時刻エントリが作成されたとき |
現在の日付に対して新しい時刻エントリが作成されたときにトリガーされます。 |
| 連絡先が追加されたとき |
新しい連絡先が追加されたときにトリガーされます。 |
クライアントが追加されたとき
新しいクライアントが追加されたときにトリガーされます。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
クライアント 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 |
プロジェクト名。 |
|
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 |
プロジェクト料金合計プロジェクトの予算に、追跡対象の経費を含めるオプション。 |
ユーザーが追加されたとき
日付の時刻エントリが作成されたとき
特定の日付に対して新しい時刻エントリが作成されたときにトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
日付
|
date | True | string |
YYYY-MM-DD または ISO 形式の datetime |
|
その他のユーザー ID
|
of_user | string |
時刻エントリを確認するユーザーの ID。 |
戻り値
現在の日の時刻エントリが作成されたとき
現在の日付に対して新しい時刻エントリが作成されたときにトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
その他のユーザー ID
|
of_user | string |
時刻エントリを確認するユーザーの ID。 既定値は ID です。 |
戻り値
連絡先が追加されたとき
新しい連絡先が追加されたときにトリガーされます。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
連絡先 ID
|
contact.id | integer |
連絡先の一意識別子。 |
|
クライアント ID
|
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 |
連絡先の FAX。 |
|
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 形式)。 |
定義
ListAllContacts_Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
連絡先 ID
|
contact.id | integer |
連絡先の一意識別子。 |
|
クライアント ID
|
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 |
連絡先の FAX。 |
|
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
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
クライアント 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 | string |
タイム エントリが関連付けられているプロジェクトの名前。 |
|
Task
|
task | string |
時刻エントリが関連付けられているタスクの名前。 |
|
Client
|
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 |
プロジェクト名。 |
|
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
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
タスク 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 |
ユーザーの一意識別子。 |
|
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 |
ユーザーの 1 時間あたりのレート |
|
部署
|
user.department | string |
ユーザーが作業している部門名。 |
|
ニュースレターのサブスクリプション
|
user.wants_newsletter | boolean |
True の 場合は、ユーザーがニュースレターを購読します。 |
|
原価率
|
user.cost_rate | float |
ユーザーのコストレート。 |
|
週単位の容量
|
user.weekly_capacity | integer |
ユーザーの週単位の容量。 |
GetTimeEntriesForDay_Response
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
day_entries
|
day_entries | array of object |
day_entries |
|
プロジェクト ID
|
day_entries.project_id | string |
porject の一意識別子。 |
|
プロジェクト名
|
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。 |
|
Task
|
day_entries.task | string |
時刻エントリが関連付けられているタスクの名前。 |
|
Client
|
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 進数の時間) 時間数。 |