StripeとGoogle Sheetsの接続方法 - SQLで支払いデータを照会する

StripeとGoogleスプレッドシートを連携させる

データ取得元 ストライプ の中へ グーグル シート

Stripeアカウントから最新のデータをGoogleスプレッドシートに取り込み、いつでも更新できます。CSVファイルのアップロードも、Apps Scriptも、コピー＆ペーストも不要です。初回は約10分で完了し、無料プランで利用できます。

約10分 コーディングは不要です 認証情報はあなたと共にあります どのブラウザでも、どのデバイスでも

最終的に手に入るもの

Stripeアカウントに対するSQLクエリのリアルタイム結果を表示するGoogleスプレッドシート。データが変更されるたびに最新の行を取得するボタンも付いています。例：

売上高 ドライブに保存

ファイル編集ビュー挿入形式データツール拡張機能ヘルプ

	A	B	C	D	E
1	顧客ID	ファーストネーム	苗字	国	合計
2	1042	マリア	アルバレス	アメリカ合衆国	1,284.50
3	1043	ダニエル	オカフォー	アメリカ合衆国	612.00
4	1047	プリヤ	ナイア	アメリカ合衆国	2,090.75
5	1051	トーマス	ベルク	アメリカ合衆国	338.20
6	1056	ルシア	フェレイラ	アメリカ合衆国	1,455.00
7	1060	ケンジ	佐藤	アメリカ合衆国	874.10
8

+ お客様 シート1 Stripeから生中継

StripeはAPIを通じてお客様のデータを管理しています。通常、Googleスプレッドシートにデータを取り込むには、StripeダッシュボードからCSVファイルをエクスポートする必要があり、毎回新しいデータが必要になります。Query Streamsを使えば、この手間は不要です。エージェントと呼ばれる小さなヘルパープログラムがデータのある場所でクエリを実行し、Googleスプレッドシートのアドオンが必要な行を取得します。暗号化されたリンクを介して送信されるのは結果のみで、Googleスプレッドシートはあらゆる場所、あらゆるデバイスのあらゆるブラウザで使用できます。

必要なもの

クエリストリームアカウント

このガイドは無料プランで十分です。登録はこちらから my.querystreams.com.

常時稼働しているコンピュータ上のエージェント

GoogleスプレッドシートからStripeへのリクエストがあった際に、バックグラウンドで自動的にStripeを呼び出す小さなプログラムです。必要なのはインターネット接続だけです。

Stripeのログイン情報

Stripeに一度ログインして、読み取りアクセスを許可してください。クエリ ストリームにパスワードを入力する必要はありません。

接続方法は5つのステップです

1. アカウントを作成する

   行く my.querystreams.com そしてサインアップします。 無料 これは計画です。試用版ではなく、正式な計画であり、Stripeアカウントの接続方法やGoogleスプレッドシートからのクエリ実行方法などを網羅しています。

2. 常時稼働している任意のコンピューターにエージェントをインストールしてください。

   サインインして開く ダウンロードインターネットに接続された常時稼働のコンピュータまたはサーバーにエージェントをインストールしてください。インストールには1分ほどかかり、その後は自動的に起動します。

   ドライバではなく、なぜ小さなプログラムを使うのか？ エージェントは、Windows、Mac、Linux 用の単一のインストール（Windows では約 85 MB、Mac と Linux では 100 MB 強）で、バックグラウンドで静かに動作します。ブラウザと同様に、Query Streams への暗号化されたアウトバウンド接続を 1 回確立するため、ファイアウォールのポートを開放したり、VPN を設定したりする必要はありません。キーはマシン上に保持され、行データは必要に応じてインターネット経由でユーザーのいる場所まで送信されます。ユーザー側で必要なのは、このアドオンだけです。

   ダウンロードページには アクセスキーエージェントに求められたら貼り付け、バッジが読み取るまで待ちます。 クエリ ストリームに接続しましたエージェント本体で行う操作はそれだけです。

   ご希望であれば、完全攻略ガイドもご用意しています。 Windows, マック, Linux.

3. Stripeアカウントを指定してください。

   ブラウザに戻って、 データエージェント （下 データ 上部メニューにあります。エージェントがそこに表示されています。クリックしてください。 コネクタを追加する そして選択する ストライプStripeの認証情報が必要ですか？チュートリアルを開いて、以下の情報を入力してください。

   Stripeの認証情報を作成してください （約8分）

   別のタブでStripeを開いた状態で、この手順を実行してください。Query Streamsはここで作成したデータを保持し、エージェントがそれを利用できるようにします。また、Stripeからのデータのみを読み取ります。

   誰がこれをできるのか

   アカウント所有者、スーパー管理者、管理者、または開発者（StripeでAPIキーを作成できる役割）

   推奨

   読み取り専用権限を持つ制限付きAPIキー（ライブデータ用：rk_live_…、サンドボックス用：rk_test_…）

   始める前に

   • Stripeアカウントにアカウント所有者、スーパー管理者、管理者、または開発者の権限でログインする必要があります。その他の権限（アナリスト、閲覧のみ、サポートなど）ではAPIキーを作成できません。
   • Stripeが認証コードを送信するメール受信トレイまたは電話へのアクセス権が必要です。Stripeはキーを作成する前にコードを要求します。
   • クエリ ストリーム ウィザードは、エージェントがオンラインの状態で別のタブ (データ エージェント → コネクタの追加 → Stripe) で開くので、Stripe に表示されたキーをすぐに貼り付けることができます。

   手順

   1. サインインして、ライブデータまたはサンドボックスを選択してください。

      Stripeダッシュボードにサインインしてください。Stripeはライブデータとサンドボックス（テスト）データを分けて管理しており、それぞれに固有のキーが割り当てられています。実際の支払いには、サンドボックスではなくビジネスアカウントを使用してください。テストデータを使用するには、ダッシュボードのアカウント選択画面を開き、「サンドボックス」をクリックして、目的のサンドボックスを開いてください。

      ライブキーはサンドボックスデータを読み取ることができず、サンドボックスキーはライブデータを読み取ることができません。両方が必要な場合は、それぞれにキーを作成し、クエリ ストリームでそれぞれを Stripe コネクタとして追加してください。

   2. APIキーページを開く

      APIキーのページを開きます。ダッシュボード内から、左下の「開発者」をクリックして「APIキー」を選択することもできます。このページには、「標準キー（公開可能なキーと秘密キー）」と「制限付きキー」の2つのリストがあります。

      サンドボックスを使用する場合は、まずサンドボックスを開いてください（ステップ1）。各サンドボックスには、独自のAPIキーページとキーがあります。

   3. 制限付きキーを開始する

      制限付きキーの一覧で、「制限付きキーの作成」をクリックします。アカウントによっては、「+ 制限付きキーの作成」と表示される場合があります。

      公開可能なキー（pk_…）は使用しないでください。アカウントデータを読み取ることができません。秘密キー（sk_…）もクエリ ストリームで使用できますが、返金や支払いなど、アカウント内のあらゆる操作を実行できてしまいます。Stripe は制限付きキーの使用を推奨しており、クエリ ストリームでは読み取りのみが必要です。

   4. 鍵がどのように使用されるかを説明してください。

      Stripeは、キーをどのように使用するかを尋ねます。「独自の統合を構築する」を選択し、「続行」をクリックしてください。

      「エージェントによるアカウントへのアクセスを承認する」は選択しないでください。このオプションを選択すると、キーがAIエージェント用にタグ付けされ、Stripeの承認ルールが追加されます。誤って「このキーを別のウェブサイトに提供する」を選択してしまった場合は、次の画面で「このキーの権限をカスタマイズする」にチェックを入れてください。チェックを入れないままにしておくと、Stripeは手順7の読み取り専用リストではなく、キーにデフォルトの権限を付与します。

   5. 権限なしから開始

      Stripeでは、既製の権限テンプレートを使用するか、権限をゼロから設定するかを選択できます。権限をゼロから設定する（独自の権限を選択する）と、すべての権限が「なし」から始まります。

      Stripeはこの画面の文言を頻繁に変更します。「最初から始める」や「テンプレートではなく、自分で選択する」といった文言のオプションを探してください。もしこの画面が表示されない場合は、手順6に進んでください。

   6. キーの名前を挙げてください

      「キー名」には、後で識別しやすい名前を入力してください。たとえば、「クエリ ストリーム (読み取り専用)」などです。

   7. 13個のリソースに対して読み取り設定を行う クエリ ストリーム同期

      各リソース行には、「なし」、「読み取り」、「書き込み」の 3 つの選択肢があります。これらの 13 行で「読み取り」をクリックし、それ以外の行はすべて「なし」のままにします。コアの下には、残高、残高トランザクションソース、請求と払い戻し、顧客、紛争、イベント、支払い意図、支払い、製品があります。請求の下には、クーポン、請求書、価格、サブスクリプションがあります。行をすばやく見つけるには、Ctrl+F (Mac の場合は Cmd+F) を押して、その名前の最初の単語を入力します。

      「書き込み」は絶対に選択しないでください。Query Streams は読み取り専用なので、読み取り専用のキーでは、たとえ情報が漏洩しても、請求、払い戻し、支払いは作成できません。イベント テーブルを同期しない場合でも、イベントが必要です。Query Streams は Stripe のイベント リストを読み取り、同期間の変更を取得するためです。Connect を使用する場合は、接続済みアカウントの権限を「なし」のままにしてください。行名が表示されている内容と一致しない場合は、「すべてのコア リソース」と「すべての請求リソース」のヘッダー行で「読み取り」をクリックしてください。キーは読み取り専用のままですが、Query Streams が使用する範囲を超えて読み取ることができます。

   8. キーを作成する

      「キーの作成」をクリックします。

   9. 確認コードを入力してください

      Stripeから確認コードがメールまたはSMSで送信されます。そのコードをダイアログに入力してください。ダイアログが自動的に進まない場合は、「続行」をクリックしてください。

      コードが見つからない場合は、迷惑メールフォルダを確認するか、Stripeのプロフィールに登録されている電話番号を確認してください。

   10. キーをコピーする

       Stripeに新しいキーが表示されます。キーはrk_live_（サンドボックス環境ではrk_test_）で始まります。キーの値をクリックしてコピーし、クエリストリームウィザードのStripeシークレットキーに直接貼り付けてください。

       ライブモードでは、Stripeは作成したキーを一度だけ表示し、再度表示することはできません。サンドボックスキーはいつでも表示できます。キーをメールやチャットで送信しないでください。Query Streamsはエージェント用にキーを保存し、そのキーを使用してのみ読み取りを行います。

   11. キーが使用されている箇所に注目してください

       「メモを追加」に、キーが使用されている場所（例：オフィスコンピュータのQuery Streams Agent）を入力します。次に「完了」をクリックします。これで、キーが「制限付きキー」リストに表示されます。

       このメモは、あなたや同僚が後でキーを確認するたびに表示されるので、誰も誤ってこのキーを期限切れにしてしまうことはありません。

   許可を与える

   リソース	アクセス	用途
   お客様	読む	顧客テーブル。接続テストでも最初に読み込まれます。
   料金と払い戻し	読む	料金と払い戻しに関するテーブル。1行で両方をカバーしており、払い戻し専用の行はありません。
   支払い意図	読む	payment_intentsテーブル
   請求書	読む	invoicesテーブルとinvoice_itemsテーブル。請求明細には独自の行はありません。
   購読	読む	subscriptionsテーブルとsubscription_itemsテーブル
   バランス	読む	balance_transactionsテーブル（Stripeの残高取引一覧。以前は残高履歴と呼ばれていました）
   残高取引元	読む	balance_transactionsテーブル：各トランザクションを、その背後にある請求、返金、または支払いにリンクさせることができます。Stripeによると、これにより残高と支払いの読み取りも可能になります。
   支払い	読む	配当表
   紛争	読む	紛争テーブル
   製品	読む	製品一覧表
   価格	読む	価格表
   クーポン	読む	クーポン一覧
   イベント	読む	イベントテーブル、および顧客、サブスクリプション、請求書、請求項目、料金、支払い意図、払い戻し、紛争、支払い、製品、価格、クーポンを同期間で最新の状態に保つ変更フィード

   クエリ ストリームに貼り付ける

   Stripeの秘密鍵

   ステップ10でコピーした制限付きキー（rk_live_またはrk_test_で始まるキー）を使用してください。秘密キー（sk_live_またはsk_test_）でも動作しますが、読み取り以外の操作も可能です。

   よくある問題

   接続テストが「無効なAPIキー」というエラーで失敗しました。

   なぜ： コピー時にキーの一部が欠落したか、スペースが追加されたか、公開キー（pk_…）が貼り付けられたか、Stripeでキーの有効期限が切れたか、キーが変更された可能性があります。

   修理： キーはrk_またはsk_で始まる必要があります。前後に何も追加せずに、再度貼り付けてください。キーがもう手元にない場合（Stripeでは有効なキーは一度しか表示されません）、新しい制限付きキーを作成し（手順3～11）、それを貼り付けてください。

   接続テストでは「接続済み」と表示されますが、一部のテーブルは空のままで、同期時にStripeの権限エラー（403）が発生します。新しいエージェントでは、接続テストの下に、キーが読み取れないテーブル名を示す警告も表示されます。

   なぜ： 問題の鍵は、そのテーブルの行に読み取り権限がないことです。Stripeのエラーメッセージには、不足している権限が明記されています。例えば、rak_event_readはイベントの読み取り権限を意味します。

   修理： Stripe APIキーのページで、キーの横にある⋯メニューをクリックし、「キーの編集」を選択して、不足している行を「読み取り」に設定し、保存します。キー自体は変更されないため、再度貼り付ける必要はありません。クエリストリームで「接続テスト」を再度クリックします。

   接続はされているが、テストデータしか表示されない、あるいは実際の支払いを受け付けているにもかかわらずテーブルが空になっている。

   なぜ： 鍵は、ライブデータが必要な場合にサンドボックス（rk_test_）から、またはその逆の場合に得られます。

   修理： キーの開始位置を確認してください。本番データの場合は、アカウントピッカーを使用してサンドボックスを終了し、キーを再度作成します（手順2～11）。次に、データエージェントでコネクタを開き、「編集」をクリックして、Stripeシークレットキーに貼り付けます。テスト用と本番用のコネクタは別々に作成してください。

   以前は正常に動作していたコネクタが、「無効なAPIキー」というエラーメッセージとともに同期を停止します。

   なぜ： Stripeで誰かがキーをローテーションまたは期限切れにしました。ローテーションされたキーは、ローテーション時に選択された有効期限（最長7日間）までのみ有効です。

   修理： 新しい制限付きキーを作成するか、ローテーションから代替キーをコピーします。クエリ ストリームでコネクタを開き、[編集] をクリックして、キーを Stripe シークレット キーに貼り付け、[接続テスト] をクリックして、[保存] をクリックします。

   「制限付きキーの作成」が表示されない場合、またはAPIキーのページが開かない場合は、この限りではありません。

   なぜ： StripeのロールではAPIキーを管理できません。アナリスト、閲覧専用、サポートのロールでは管理できません。

   修理： Stripeアカウントの所有者、管理者、または開発者に、キーの作成を依頼するか、役割を変更してもらうよう依頼してください。

   Stripeからリクエストがブロックされたというメールが届き、キーが正しいにもかかわらず同期が失敗する。

   なぜ： キー（IPアドレスまたは詳細設定）のアクセス ポリシーにより、エージェント コンピュータのインターネット アドレスが許可されていないか、コンピュータが使用する VPN またはプロキシがブロックされています。

   修理： APIキーのページで、キーの横にある⋯をクリックし、「アクセス ポリシーの管理」を選択します。エージェント コンピューターのパブリック IP アドレスを許可するポリシーを選択するか、「なし」を選択します。次に、「保存」をクリックします。

   鍵が漏洩した（メールやチャットで送信された、または共有ファイルに保存された）か、鍵を持っていた人がチームを離れた。

   なぜ： キーを持っている人は誰でも、そのキーの権限で許可されているすべての情報を読み取ることができます。

   修理： APIキーのページで、キーの横にある⋯をクリックし、「キーをローテーション」を選択します。「有効期限」で「今すぐ」を選択して古いキーを即座に削除し、「APIキーをローテーション」をクリックします。新しいキーをコピーし、コネクタに貼り付けます（編集 → Stripeシークレットキー → 接続テスト → 保存）。

   Query StreamsがこのStripeアカウントを読み取るのを停止させたい。

   なぜ： コネクタを削除してもキーは無効になりません。有効期限が切れるまで、Stripe上で有効なままです。

   修理： APIキーのページで、キーの横にある⋯をクリックし、「キーの有効期限切れ」を選択して、もう一度「キーの有効期限切れ」をクリックして確定します。その後、データエージェントでコネクタを削除します。

   知るべき限界

   • イベントは過去30日間に遡ります。Stripeのイベントリストは過去30日間までしか遡れないため、イベントテーブルには過去30日間を超えるイベントは保存されません。Query Streamsは同期間の変更を反映するためにイベントも読み取るため、コネクタが約4週間以上オフになっている場合、次回の同期時にテーブル全体が再度読み取られます。
   • リクエスト速度：Stripeでは、ライブモードでは1秒あたり100件、サンドボックスモードでは25件のAPIリクエストが許可されており、ほとんどの個別エンドポイントでは25件までとなっています。各リクエストは最大100件のレコードを返すため、100万件の請求を初めて同期するには約1万件のリクエストが必要となり、1秒あたり25件の速度で約7分かかります。サンドボックスでの同期はさらに遅くなります。
   • 月間読み取り許容数：Stripeでは、アカウントの読み取りリクエスト数が、過去30日間の平均でトランザクションあたり500件以下、かつ月間最低10,000件となることを想定しています。有効化されたテーブルは、同期のたびに少なくとも1回のリクエストを行うため、新規アカウントやデータ量の少ないアカウントでは、分単位で同期する必要のないテーブルの同期間隔を長く設定してください。
   • キーごとにモードは1つ：キーは、作成されたモード（ライブ環境、または特定のサンドボックス環境）でのみ読み取ります。
   • 接続：このキーは、ご自身のアカウントのオブジェクトのみを読み取ります。接続されたアカウントの支払いは同期されません。
   • キーの再表示：Stripeでは、作成した有効なキーは一度だけ表示されますが、サンドボックスキーはいつでも表示できます。キーをローテーションすると、古いキーは最長7日間有効です。

   手順は2026年10月8日に確認済み。出典： docs.stripe.com/keys, docs.stripe.com/keys/restricted-api-keys, docs.stripe.com/keys-best-practices, docs.stripe.com/stripe-apps/reference/permissions, docs.stripe.com/sandboxes, docs.stripe.com/testing-use-cases, docs.stripe.com/rate-limits, docs.stripe.com/api/events/list, docs.stripe.com/api/balance_transactions/list, docs.stripe.com/api/errors, docs.stripe.com/get-started/account/teams/roles, docs.stripe.com/workbench, support.stripe.com/questions/plugin-user-migration-guide, stripe.com/sessions/2026/building-security-first-stripe, posthog.com/docs/cdp/sources/stripe, help.chaserhq.com/use-chaser-with-stripe, homerunner.io/docs/creating-stripe-restrict-key-for-homer…, chargebee.com/docs/reveal/transactions/get-started/stripe…, nango.dev/docs/api-integrations/stripe-api-key/connect, fivetran.com/docs/connectors/applications/stripe/troubles….

   接続名

   後で必ず思い出すような名前、例えば「販売データベース」など。

   Stripeの秘密鍵

   Stripeダッシュボードの「開発者」→「APIキー」から入手できるStripeシークレットキーです。キーはsk_live_またはsk_test_で始まります。

   クリック 接続テスト読むと 接続済み、 クリック セーブ接続は数秒以内に担当エージェントに到達します。

   オープンデータエージェント

   テストは失敗しましたか？ 通常は権限が不足しているか、間違った Stripe アカウントの認証情報です。上記の手順では、 よくある問題 そして、それらの解決策。

4. Googleスプレッドシートにクエリストリームを追加する

   Google スプレッドシートを開き、 拡張機能 → アドオン → アドオンを入手、 検索する クエリストリーム、そしてクリック インストールまたは、直接インストールしてください。 Google Workspace Marketplace のクエリ ストリームGoogleはアドオンの許可を求めますが、これは正常な動作です。

   その後は、開くすべての Google スプレッドシートに表示されます。右側のサイド パネルにクエリ ストリーム アイコンが表示され、 拡張機能別途ログインする必要はありません。既にお使いのGoogleアカウントを認識するため、そのメールアドレスはQuery Streamsアカウントに登録されているものと同じである必要があります。

5. 最初のテーブルを運び入れる

   シートの右側のサイドパネルにあるクエリ ストリーム アイコンをクリックします (または、以下で見つけます) 拡張機能）。 選ぶ クエリストリーマー そして、先ほど繋がった接続を選択してください。

   実行したいクエリを入力してください。これは、いくつかの列を抽出します。 stripe.invoices テーブル：

   例：SQL

   SELECT number, status, amount_due / 100.0 AS amount_due, currency FROM stripe.invoices ORDER BY created DESC LIMIT 100;

   下 目的地一覧表 行を配置するタブを選択し、次にクリックします。 クエリーの実行データは1～2秒でそのタブに表示されます。データが変更された場合はいつでも「クエリの実行」を再度クリックすると、タブが即座に更新されます。

   SQLを知らない？ クエリは、クエリストリームポータルで作成してください。 クエリビルダー テーブルと列が表示されるので、ポイント＆クリックで操作できます。ビジネスプランでは、Novaに「米国の顧客を表示して」といった簡単な英語で質問すると、SQLクエリが自動的に生成されます。クエリを保存すれば、ポータル内はもちろん、アドオンの「保存済みクエリ」リスト（パーソナルコア以降）からもワンクリックでアクセスできます。

良い次の動き

• クエリを保存します ポータルにインストールすれば、Google スプレッドシートや Excel からワンクリックで再度実行できます。
• フィルターを追加する 例えば日付範囲などを指定することで、同じクエリで編集せずに「今月」という回答を得ることができます。
• 結果を共有する 同僚と共有する場合、同僚には行数が表示され、あなたの認証情報は表示されません。

人々が尋ねる質問

関連ガイド

• StripeからMicrosoft Excelへの変換
• HubSpot から Google スプレッドシートへ
• ShopifyからGoogleスプレッドシートへ
• Google Analytics 4 から Google Sheets への移行
• パワー・クエリ・フォー・グーグル・シート
• すべてのガイド