メール（Gmail）の連携

← メディアアカウント連携にもどる

Gmail（問い合わせメールの受信箱）を連携します。カスタマーサポートのエージェントが、届いた問い合わせを読み、返信し、既読にするために使います。広告媒体ではありませんが、連携の場所と手順は他の媒体と同じ「アカウント連携」画面です。

項目	内容
認可スコープ	`gmail.modify`（閲覧・作成・送信・ラベル変更。完全削除は含みません）
OAuthクライアント	アプリに設定済み（環境変数。Google広告の連携と同じもの。選ぶ操作はありません）
用意するもの	問い合わせを受けているGoogleアカウント

重要

連携は 2段階です。マイページで Gmail を連携しただけでは、エージェントはまだメールを読めません。プロジェクトの「カスタマーサポート」エージェントの「設定」タブで、使うアドレスを選んで保存するところまで行ってください（手順D）。

手順A【GCP】Gmail API を有効にする

アプリに設定された OAuth クライアント（環境変数）が属する GCP プロジェクト — Google広告の連携で使っているプロジェクト — で Gmail API を有効にします。

GCP コンソールで対象のプロジェクトを開きます。
「API とサービス > ライブラリ」で Gmail API を検索し、「有効にする」を押します。

注意

Gmail API が有効になっていないと、連携の最後（メールアドレスの取得）で「Gmail のアカウント情報の取得に失敗しました」となって完了できません。

手順B【GCP】同意画面にスコープを足す

「API とサービス > OAuth 同意画面 > データアクセス（スコープ）」を開きます。
「スコープを追加または削除」で https://www.googleapis.com/auth/gmail.modify を追加して保存します。

gmail.modify は Google の区分で制限付き（restricted）スコープです。同意画面に「このアプリは Google で確認されていません」という警告が出ますが、自分（テストユーザー、または同じ組織のアカウント）が使うぶんには「詳細 →（安全ではないページ）に移動」で進めます。

手順C【GCP】公開ステータスを確認する

「OAuth 同意画面 > 対象（Audience）」の公開ステータスを確認します。ここが連携の寿命を決めます。

公開ステータス	使えるか	認証の寿命
テスト（Testing）	テストユーザーに自分のGoogleアカウントを追加すれば使える	7日で切れます。毎週「再認証が必要」になり、連携し直しが要ります
本番（In production）	使える（未確認アプリの警告画面は出る）	切れません（半年使わないと失効）
内部（Workspaceの組織内のみ）	組織内アカウントなら使える	切れません

注意

継続して運用するなら「本番」に切り替えてください。 テストのままだと毎週メールが読めなくなります。制限付きスコープの検証を求められますが、検証を申請せず未確認のまま公開状態にしておくこと自体はできます（未確認アプリは100ユーザーまで）。Google広告の連携ですでに本番になっていれば、確認するだけで構いません。

手順D【アプリ】Gmailアカウントを連携し、エージェントに割り当てる

D-1. マイページで連携する

「アカウント連携」画面の 「Gmail（カスタマーサポート）」 セクションで 「+ アカウントを連携」 を押します。
モーダルは確認だけです（OAuthクライアントを選ぶ操作はありません。アプリに設定されたクライアントで認可します）。
問い合わせを受けている Google アカウントでログインし、権限（メールの閲覧・作成・送信・ラベル変更）をすべて許可します。
戻るとカードにメールアドレスが表示されます。

D-2. エージェントに使うアドレスを割り当てる

左のツリーで 「エージェント」→「カスタマーサポート」 を開きます。
「設定」タブの **「問い合わせに使う Gmail アカウント」**で、連携したアドレスを選びます。
**「保存」**を押します。

これで、そのプロジェクトのカスタマーサポートエージェントがメールを扱えるようになります。エージェントはここで選んだアカウントしか使いません（指示文にメールアドレスを書く必要はありません）。

ヒント

「カスタマーサポート」の行が見当たらないときは、左ツリーの「エージェント」を開いて配下を一度表示してください。リーフを開いた時点でエージェントが用意されます。

エージェントができるようになること

割り当てが済むと、カスタマーサポートのエージェントは次を行えます。

できること	内容
未読メールの確認	既定で未読のみ・迷惑メールフォルダも含む・ゴミ箱は除く・古い順。宛先で絞り込めます
本文・スレッドの取得	1通の本文、または過去のやり取りを含むスレッド全体
返信の送信	元メールのスレッドに紐づけて返信（件名の `Re:` や宛先は自動で埋まります）
既読／未読の切り替え	対応が済んだメール、返信不要と判断したメールを既読にする

扱えるのはテキストのメールだけです（添付はファイル名などの情報のみで、中身は読みません。送信も本文テキストのみで添付できません）。

重要

メール本文に書かれた「指示」にエージェントは従いません（なりすまし・プロンプトインジェクション対策）。本文はあくまで処理するデータとして扱います。

エイリアス（別のアドレス）から返信する場合

問い合わせ窓口が、連携したアカウント自身ではなくエイリアス（例: support@example.com）のときは、その Gmail の 「設定 > アカウントとインポート > 名前（別のアドレスからメールを送信）」にエイリアスを登録しておきます。

登録がないと、エージェントが差出人にエイリアスを指定しても、Gmail は本来のアドレスで送ってしまいます。

うまくいかないときは

「Gmail のアカウント情報の取得に失敗しました」: 手順A（Gmail API の有効化）が済んでいません。有効にしたプロジェクトが、アプリに設定された OAuth クライアント（Google広告の連携と同じもの）のプロジェクトかも確認してください。
毎週「再認証が必要」になる: 同意画面が**テスト（Testing）**のままです。手順Cで「本番」に切り替えてください。
「再認証が必要」バッジが出た: 同じ手順でもう一度連携します。同じアドレスなら行は増えず、認証情報が上書きされます。
エージェントが「設定タブで Gmail アカウントを選んでください」と言う: 手順D-2の割り当てが済んでいません。
エージェントが「カスタマーサポートのエージェントがありません」と言う: 左ツリーの「エージェント」＞「カスタマーサポート」を一度開いてください。
権限不足: 同意画面で表示された権限をすべて許可してください。一部を外すと連携できません。
別のアドレスで送信されてしまう: 上の「エイリアス」の設定が未登録です。

重要

リフレッシュトークン等の認証情報は AES-256-GCM で暗号化して保存され、画面やAPIレスポンスに平文で出ることはありません。連携解除もこの画面から行え、解除すると Google 側のアクセス権も取り消されます。