Google Workspaceを接続する
Workspace管理者が一度承認するだけで、すべてのメールボックスとエイリアスが一覧に表示されます。送信に使うものを選びます。パスワードも、メールボックスごとのログインも不要です。
委任の値を取得する
Shell
curl -X POST "https://app.argorant.com/api/v1/inboxes/google-workspace" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"admin_email":"admin@yourdomain.com"}'管理者が承認するまで、応答にはok: false、mailboxes: null、そして管理者が必要とする値であるclient_id、scopes_csv、delegation_urlを含むsetupブロックが入ります。
Google管理コンソールで許可する
Google管理コンソールでSecurityを開き、Access and data control、API controls、Domain-wide delegation、Add newの順に進みます。返されたクライアントIDとスコープを、そのまま貼り付けます。管理者がこの作業を行うのは、Workspaceごとに一度だけです。
一覧を取得して接続する
同じエンドポイントをもう一度呼び出します。今度はすべてのメールボックスとエイリアスが返ります。続けて、接続するアドレスを送ります。すべてを接続する場合は空のリストを送ります。
Shell
curl -X POST "https://app.argorant.com/api/v1/inboxes/google-workspace" \
-H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
-d '{"admin_email":"admin@yourdomain.com","emails":["elena@yourdomain.com","marina@yourdomain.com"]}'
# {"connected": [{"email": "elena@yourdomain.com", "health": "healthy"}]}接続したメールボックスは、状態、1日の上限、今日の送信数とともにGET /api/v1/inboxesに表示され、どのキャンペーンでも送信に使えます。ターミナルでは、npx argorant inboxes connect-google --admin admin@yourdomain.com --allで同じことができます。