マイストアパスポート連携ガイド
このドキュメントは、マイストアパスポートの訪問情報 (初訪問日・最終訪問日・訪問回数) を STB Tracker の stores シートに取り込みたい方向けの手順です。
これは通常の店舗一覧取得・自動巡回とは独立したオプション機能です。先に 初期設定ガイド の初回取得を済ませてから実施してください。
☕️ これはなに?
STB Tracker で取り込んだ店舗一覧に、マイストアパスポートの情報 (初訪問日・最終訪問日・訪問回数など) を追加する機能です。
マイページにある情報という性格上、認証済みのブラウザー画面から読み取る必要があります。このアプリはあなたのスターバックス会員 ID やパスワードを保存・送信しません。取り込み時は、ログイン済みのブラウザーで操作します。
取得した情報は、利用者自身の Apps Script ウェブアプリ経由で、利用者自身のスプレッドシートへ反映されます。本サービス提供者が管理する外部データベースへ送信する仕組みはありません。
☕️ お断り事項
この連携機能は、マイストアパスポートの訪問情報を自身で参照しやすくするためのものです。
取り込んだ情報を、第三者に提供・公開・再配布しないでください。この連携を使うことによる問題や損失について、法令上認められる範囲で当方では責任を負いません。
☕️ 前提
- スターバックス コーヒー ジャパンの会員アカウントを登録済みで、マイストアパスポートが有効であること
- Windows / Mac のブラウザーでマイストアパスポートのスタンプの並ぶページを表示できること
- Chrome / Edge / Firefox / Safari いずれも可
- スマートフォンには対応していません
- お断り事項を正しく理解いただくこと
☕️ 先に知っておきたいこと
この連携は、ブラウザーのブックマークに「マイストア取込」という小さな処理を登録して使います。
初回だけ、スプレッドシート側に訪問情報を受け取るための受付 URL を作り、その URL を使ってブックマークを作ります。
☕️ セットアップ手順
ステップ 1: セットアップ ダイアログを開く
- スプレッドシートのメニュー「STB Tracker」→「マイストア取込のセットアップ」をクリック
- 初回はダイアログ内に URL の入力欄が表示されます
- 入力欄の上の「Apps Script エディタを開く (別タブ)」ボタンをクリック
ステップ 2: 受付 URL を作る (初回のみ)
別タブで開いた Apps Script エディタで以下を実施します。
- 右上「デプロイ」→「新しいデプロイ」
- 「種類の選択」→「ウェブアプリ」
- 設定:
- 次のユーザーとして実行: 自分
- アクセスできるユーザー: Google アカウントを持つ全員
- 「デプロイ」をクリック
- 表示された URL (
https://script.google.com/macros/s/.../exec) をコピー
ステップ 3: URL を貼り付けてブックマークを作る
- ステップ 1 のセットアップ ダイアログのタブに戻ります
- URL 欄にコピーした URL を貼り付けて、登録ボタンをクリック
- 表示されたブックマーク情報をコピーします
- ブラウザーのブックマーク機能で、コピーした内容を URL として登録します。名前は「マイストア取込」など、後で分かるものにします
ブックマークの登録方法はブラウザーごとに違います。分からない場合は、利用中のブラウザー名と「ブックマークレット 登録方法」で調べてください。
ステップ 4: 動作確認
- https://www.starbucks.co.jp/mystore/ を開き、ログインしてスタンプ帳を表示
- 登録した「マイストア取込」ブックマークを実行
- 確認ダイアログで件数を確認して OK
- 「N 件の送信が完了しました」のダイアログが出れば送信操作は完了
これで完了です。訪問済み店舗の行の first_visit_date などの列に値が入っていることを確認してください。
☕️ 普段の使い方
セットアップ後は、訪問情報を取り込みたいタイミングで以下を実行します。
- https://www.starbucks.co.jp/mystore/ を開き、ログインして、マイストアパスポートのスタンプ帳を表示
- 登録した「マイストア取込」ブックマークを実行
- 確認ダイアログで件数を確認して OK
- 「N 件の送信が完了しました」が出たら、スプレッドシート側の反映を確認
☕️ 再設定が必要なとき
次の場合は、スプレッドシートのメニュー「STB Tracker」→「マイストア取込のセットアップ」から、もう一度ブックマークを作り直してください。
- STB Tracker をバージョンアップした
- ブックマークを押しても反映されない
- セットアップ画面で再登録を求められた
☕️ 困ったとき
💡 マイストア取込のブックマークを押しても反応がない / 結果が増えない
まず、登録済みの「マイストア取込」ブックマークを削除し、スプレッドシートのメニュー「STB Tracker」→「マイストア取込のセットアップ」からブックマークを作り直してください。
最近 STB Tracker をバージョンアップした場合は、古いブックマークでは動きません。新しいスプレッドシートで作ったブックマークに置き換えてください。
「N 件の送信が完了しました」と出るのにスプレッドシートに何も反映されない:
古いブックマークを使っている可能性があります。スプレッドシートのメニュー「STB Tracker」→「マイストア取込のセットアップ」からブックマークを作り直してください。
それでも反映されない場合は、マイストアパスポートのスタンプ帳ページを再読み込みし、もう一度「マイストア取込」ブックマークを実行してください。