スプレッドシート連携
友だち追加・フォーム回答・成果・予約を Google スプレッドシートに自動で追記します
この画面を開くどんな機能か
友だちが追加されたとき、フォームに回答があったとき、成果(購入など)が発生したとき、予約が入ったときに、Google スプレッドシートの末尾へ自動で1行追記します。名簿の共有や、他のツールへの受け渡しに使えます。
- 1つの連携 = 1枚のシート × 1つのきっかけ
- 列の並び(見出しと、そこに入れる値)はこの画面で決めます
- シートの1行目が空なら、最初の追記のときに見出しの行を先に書きます
スタンダードプラン以上で使えます。
準備(Google 側の作業・最初の1回だけ)
このツールは「サービスアカウント」という Google の仕組みでシートに書き込みます。Google アカウントでログインする方式ではないので、審査や承認画面は要りません。代わりに、鍵のファイルを1つ作って、シートをそのアカウントに共有します。
1. Google Cloud でプロジェクトを作る
- Google Cloud コンソール を開き、Google アカウントでログインします
- 画面上部のプロジェクト名 →「新しいプロジェクト」→ 名前を付けて「作成」
2. Google Sheets API を有効にする
- 左のメニュー「API とサービス」→「ライブラリ」
- 「Google Sheets API」を検索して開き、「有効にする」
3. サービスアカウントと鍵を作る
- 「API とサービス」→「認証情報」→「認証情報を作成」→「サービス アカウント」
- 名前(例:
linsta-sheets)を入れて「作成して続行」→ 役割は空のまま「完了」 - 一覧に出たサービスアカウントを開き、「キー」タブ →「鍵を追加」→「新しい鍵を作成」→ 種類は JSON →「作成」
- JSON ファイルがダウンロードされます。このファイルが鍵です。他の人に渡さないでください
4. シートを共有する
- 書き込み先のスプレッドシートを開き、右上の「共有」
- サービスアカウントのメールアドレス(
xxx@xxx.iam.gserviceaccount.com。JSON のclient_email、この画面にも表示されます)を入れ、権限を 「編集者」 にして送信
この画面での設定
- 「+ 連携を追加」を押します
- 名前(管理用)を入れます
- きっかけを選びます。「フォームに回答があったとき」ならフォームも選びます(選ぶと回答の項目が列に並びます)
- スプレッドシートの URL をアドレス欄からそのまま貼り付けます
- シート名は、シート下部のタブの名前です(既定は「シート1」)
- JSON 鍵はファイルを選ぶか、中身を貼り付けます
- 列を整えます。見出しはシートの1行目に書く名前、値は差し込みです。差し込みのボタンを押すと、選択中の列に入ります
- 「保存」を押すと、共有先のメールアドレスが表示されます。手順4がまだなら、ここで共有してください
保存した鍵は暗号化されて保管され、以後は表示されません。鍵を作り直したときは「編集」から新しい鍵を入れてください。
差し込みの一覧
| 差し込み | 入る値 |
| --- | --- |
| {{timestamp}} | 追記した日時(日本時間) |
| {{display_name}} / {{name}} | 友だちの表示名 |
| {{line_user_id}} | LINE のユーザーID |
| {{ref}} | 流入経路コード |
| {{tags}} | 付いているタグ(カンマ区切り) |
| {{friend_added_at}} | 友だち追加日時 |
| {{metadata.KEY}} | 友だち情報の項目(KEY を項目名に置き換え) |
| {{form.name}} | フォーム名 |
| {{answer.項目名}} | フォームの回答(項目名または見出しで指定) |
| {{conversion.name}} / {{conversion.value}} | 成果の名前 / 金額 |
| {{booking.menu}} / {{booking.staff}} / {{booking.starts_at}} / {{booking.ends_at}} / {{booking.note}} / {{booking.price}} / {{booking.status}} | 予約のメニュー / 担当者 / 開始 / 終了 / お客様メモ / 料金 / 状態 |
動作を確かめる
「テスト追記」を押すと、見本の値(「テスト 太郎」など)で1行書きます。シートを開いて確認してください。うまくいかないときはエラーの内容が一覧に出ます。
「記録」を押すと、追記の履歴(成功・失敗・再送待ち)を見られます。
つまずきやすいところ
- 「編集者で共有されているか確認」と出る — シートの共有先がサービスアカウントのメールアドレスになっているか、権限が「編集者」かを確認してください。「閲覧者」では書けません
- 「シート名が違います」と出る — シート下部のタブの名前と一致させてください(全角・半角、スペースも同じに)
- 「スプレッドシートの ID が違う」と出る — URL の
/d/と/editの間が ID です。URL をそのまま貼れば自動で取り出します - 鍵が読めないと言われる — サービスアカウントの JSON 鍵(
"type": "service_account"で始まるもの)を選んでください。OAuth クライアントの JSON とは別物です - Google 側が一時的に応答しない — 5分おきに最大3回まで自動で送り直します。それでも失敗した行は「記録」に残ります
- 列を増やした — 既にあるシートの見出しは書き換えません。1行目を手で直すか、新しいシートに切り替えてください