Appearance
外部サービス連携の準備
freee 会計や Google スプレッドシートと連携するには、お使いのサービス側で「アプリ情報」を用意し、ASET（api set）で登録します。この準備は最初の一度だけ必要です（クラウドプランでご利用いただけます）。
認証情報はお使いのパソコン内に暗号化して保存され、他のパソコンには引き継がれません。
freee 会計を連携する
freee の開発者ページで「アプリ」を 1 つ作成し、その Client ID / Client Secret を ASET に登録します。
1. アプリを作成する
- freee アプリストアのアプリ管理画面を開きます
- 「新しいアプリを作成する」から、アプリ種別に プライベートアプリ を選びます
- プライベートアプリは審査不要で、ご自身の事業所（5 件まで）で利用できます
- ⚠ アプリ種別は後から変更できません
- アプリ名は任意（例: 「MT 連携」）で作成します
2. コールバック URL を設定する
作成したアプリの設定画面で、コールバック URL に次の値を 1 文字も違わず 入力して保存します。
http://127.0.0.1:38141/callbacklocalhostではなく127.0.0.1を使ってください- 末尾の
/callbackまで、ポート番号（38141）も含めて完全に一致させてください
3. 権限（スコープ）を設定する
「会計」の 参照 権限を有効にします（取り込みのみのため、更新権限は不要です）。
4. MT に登録する
- アプリ設定画面に表示される Client ID と Client Secret を控えます
- MT で
asetを実行し、「接続を追加」→「freee 会計」を選びます - Client ID / Client Secret を入力して「ブラウザで認可を開始」します
- ブラウザで freee にログインして許可すると、事業所の選択に進みます
- 事業所を選び、接続に名前を付けて保存します
Google スプレッドシートを連携する
Google Cloud で「OAuth クライアント」を作成し、その Client ID / Client Secret を ASET に登録します。
1. プロジェクトと API を用意する
- Google Cloud Console でプロジェクトを作成（または選択）します
- 「API とサービス」→「ライブラリ」で Google Sheets API を有効にします
2. OAuth 同意画面を設定する
- 「API とサービス」→「OAuth 同意画面」を開きます
- User Type は「外部」を選びます
- 必要事項を入力し、公開ステータスを「本番環境（In production）」にします
- ⚠ 「テスト（Testing）」のままだと、連携が 7 日で切れて再認可が必要になります。必ず「本番環境」に公開してください
3. OAuth クライアントを作成する
- 「API とサービス」→「認証情報」→「認証情報を作成」→「OAuth クライアント ID」を選びます
- アプリケーションの種類に デスクトップアプリ を選びます
- 作成後に表示される クライアント ID と クライアント シークレット を控えます
4. MT に登録する
- MT で
asetを実行し、「接続を追加」→「Google スプレッドシート」を選びます - クライアント ID / クライアント シークレットを入力して「ブラウザで認可を開始」します
- ブラウザで Google にログインして許可すると、接続名を付けて保存できます
使い方
- 取り込み:
aget（api get）で、登録した接続からデータを表として取り込みます - 書き出し:
aput（api put）で、表示中の表を Google スプレッドシートへ書き出します
うまくいかないときは
- 「接続の再認可が必要です」と出る: 認証の有効期限が切れると再認可が必要になります（freee のリフレッシュトークンは有効期限 90 日、Google は同意画面が「テスト」のままだと 7 日で失効します）。いったん接続を削除し、登録し直してください
- freee で「コールバック URL が一致しません」: 手順 2 の URL が 1 文字でも違うと失敗します。
http://127.0.0.1:38141/callbackを確認してください - 「事業所が見つかりません」: freee アプリの参照権限と、事業所へのアクセス権を確認してください
- 「オフラインです」と出る: ネットワークに接続されていません。接続を確認してから、もう一度お試しください