データ取得元 シップステーション の中へ グーグル シート
ShipStationアカウントから最新のデータをGoogleスプレッドシートに取り込み、いつでも更新できます。CSVファイルのアップロードも、Apps Scriptも、コピー&ペーストも不要です。初回は約10分で完了し、無料プランで利用できます。
最終的に手に入るもの
ShipStationアカウントに対する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 |
ShipStationはAPIを通じてお客様のデータを保持します。通常、データをGoogleスプレッドシートに取り込むには、新しい数値が必要になるたびにShipStationダッシュボードからCSVファイルをエクスポートする必要があります。Query Streamsを使えば、この手間は不要です。エージェントと呼ばれる小さなヘルパープログラムがデータのある場所でクエリを実行し、Googleスプレッドシートのアドオンが必要な行を取得します。暗号化されたリンクを介して送信されるのは結果のみで、Googleスプレッドシートはあらゆる場所、あらゆるデバイスのあらゆるブラウザで使用できます。
必要なもの
常時稼働しているコンピュータ上のエージェント
Google Sheetsから要求があった際にShipStationを呼び出す、バックグラウンドで動作する小さなプログラムです。必要なのはインターネット接続だけです。
ShipStationへのログイン
ShipStationに一度ログインして、読み取りアクセスを許可してください。クエリ ストリームにパスワードを入力する必要はありません。
どのコンピュータにエージェントがインストールされますか? ShipStationアカウントにアクセスできる、常時稼働しているマシンであればどれでも構いません。 Google スプレッドシートはどこにでも配置できますブラウザ上で動作します。
接続方法は5つのステップです
-
アカウントを作成する
行く my.querystreams.com そしてサインアップします。 無料 これは計画です。試作ではなく、正式な計画であり、ShipStationアカウントの接続方法やGoogleスプレッドシートからのクエリ実行方法などを網羅しています。
常時稼働している任意のコンピューターにエージェントをインストールしてください。



サインインして開く ダウンロードインターネットに接続された常時稼働のコンピュータまたはサーバーにエージェントをインストールしてください。インストールには1分ほどかかり、その後は自動的に起動します。
ドライバではなく、なぜ小さなプログラムを使うのか? エージェントは、Windows、Mac、Linux 用の単一のインストール(Windows では約 85 MB、Mac と Linux では 100 MB 強)で、バックグラウンドで静かに動作します。ブラウザと同様に、Query Streams への暗号化されたアウトバウンド接続を 1 回確立するため、ファイアウォールのポートを開放したり、VPN を設定したりする必要はありません。キーはマシン上に保持され、行データは必要に応じてインターネット経由でユーザーのいる場所まで送信されます。ユーザー側で必要なのは、このアドオンだけです。
ダウンロードページには アクセスキーエージェントに求められたら貼り付け、バッジが読み取るまで待ちます。 クエリ ストリームに接続しましたエージェント本体で行う操作はそれだけです。
-
ShipStationアカウントを指定してください。
ブラウザに戻って、 データエージェント (下 データ 上部メニューにあります。エージェントがそこに表示されています。クリックしてください。 コネクタを追加する そして選択する シップステーションShipStationの認証情報が必要ですか?チュートリアルを開いて、以下の情報を入力してください。
ShipStationの認証情報を作成してください。 (約5分)
ShipStationを別のタブで開いた状態で、この手順を実行してください。Query Streamsはここで作成したデータを保持し、エージェントがそれを利用できるようにします。また、データの読み取りはShipStationからのみ行います。
- 誰がこれをできるのか
- アカウント所有者(ShipStationでは、アカウント所有者のみがAPIキーを生成できます)
- 推奨
- ShipStation V2 APIキー(本番環境用キー)
始める前に
- ShipStationのAPIアクセス付きプラン:Standard、Accelerate、Premium以上。無料プランとStarterプランにはAPIアクセスは含まれません。
- アカウント所有者のShipStationログイン情報、および所有者のメール受信トレイへのアクセス権(初回は、ShipStationからキーを作成する前に確認リンクがメールで送信されます)。
- 貴社が ShipStation Web アプリではなく ShipStation API (旧称 ShipEngine の開発者向け製品) を使用している場合は、キーは ShipStation API ダッシュボード (https://api-portal.shipstation.com/) にあります。本番環境に切り替えて本番キーをコピーし、ウィザードに直接進んでください。TEST_ で始まるキーはサンドボックスキーです。
- クエリ ストリーム ウィザードが別のタブで開きます: データ エージェント → コネクタの追加 → ShipStation。
手順
- ShipStationにアカウント所有者としてサインインしてください
ShipStationを新しいタブで開き、アカウント所有者のログイン情報でサインインしてください。APIキーを生成できるのはアカウント所有者のみであり、ShipStationは新しいキーを生成した本人にのみ一度だけ表示します。
所有者ではない場合:所有者に手順1~11を実行してもらい、キーをクエリストリームウィザードに貼り付けてもらうか、パスワードマネージャー経由で送ってもらうように依頼してください。所有者が不明な場合は、ShipStationサポート([email protected])にお問い合わせください。
- 設定を開く
画面右上の、プリンターアイコンと疑問符アイコンの間にある暗いツールバーの歯車アイコン(設定)をクリックします。
一部のアカウントでは、人物アイコン→マイプロフィールからも同じ設定画面にアクセスできます。
- API設定を開く
左側のサイドバーで、「アカウント」を展開し(折りたたまれている場合)、[API設定]をクリックします。ページタイトルは「API設定」で、その下に「APIキー」ボックスが表示されます。ログイン済みの場合、このリンクをクリックすると直接このページが開きます。
ページに「ご利用のプランはAPIアクセスをサポートしていません」と表示される場合は、アカウントが無料プランまたはスタータープランになっています。まずは「アカウント」→「支払いとサブスクリプション」からスタンダードプラン以上にアップグレードしてください。
- V2 APIを選択してください
「APIバージョンの選択」ドロップダウンメニューで、「V2 API」を選択してください。
ドロップダウンはV1 APIで開くことができます。Query StreamsはShipStationのV2 APIを使用します。V1キーはAPIキーとシークレットキーで構成されており、無効なAPIキーで接続テストを行うと失敗します。
- V2キーが既に存在するかどうかを確認します。
ボックスに「APIキーを生成」ボタンが表示されている場合は、手順6に進んでください。代わりに、非表示のキー、コピーアイコン、ゴミ箱アイコンが表示された「プロダクションキー」の行が表示されている場合は、アカウントに既に許可されているV2キーが1つ存在します。
既存のキーが安全な場所(パスワードマネージャーや、コピーできる他のツールの設定など)に保存されている場合は、それを使用してウィザードに直接進んでください。そうでない場合は、ゴミ箱アイコンをクリックし、「APIキーの削除」ポップアップで「キーの削除」を選択してください。削除は元に戻せません。古いキーを使用している他のツールは、新しいキーを入力するまで動作しなくなります。
- 「APIキーを生成」をクリックしてください。
ボックスの右側にある「APIキーを生成」をクリックします。「APIキーを生成」というタイトルのポップアップが表示された場合は、手順9に進みます。代わりに青色の通知(「メールアドレスの確認が必要です。ユーザーのメールアドレスに送信された確認リンクをクリックしてから、もう一度お試しください。」)が表示された場合は、手順7と8を実行します。
ShipStationでは、アカウントの最初のキー生成前にこのメールアドレスの確認を求めます。新規アカウントは、キーを生成する前にメールアドレスを認証する必要があります。
- メールに記載されている確認リンクをクリックしてください。
ShipStationからアカウント所有者のメールアドレスに送信されたメールを開き、メール内の確認リンクをクリックしてください。
数分経ってもメールが届かない場合は、迷惑メールフォルダとプロモーションフォルダを確認してください。
- 「APIキーを生成」をもう一度クリックしてください。
API設定タブに戻り、「APIバージョンの選択」にV2 APIが表示されていることを確認し、もう一度「APIキーの生成」をクリックします。
メールアドレスの認証が完了すると、ボタンはリセットされます。青い通知がまだ表示されている場合は、ページを再読み込みして、再度V2 APIを選択してください。
- 有効期限を選択して「生成」をクリックしてください。
「APIキー生成」ポップアップで、「キーの有効期限を設定」から12ヶ月、6ヶ月、または3ヶ月を選択し、「生成」をクリックします。
その日付になるとキーは無効になり、ShipStationとの同期も同時に停止します。12か月を選択してカレンダーにリマインダーを設定してください。ShipStationからもキーの有効期限が切れる前にリマインダーメールが送信されます。
- APIキーをコピーする
「APIキーが作成されました」というタイトルのポップアップが表示され、キーが表示されるのはこの時だけであるという警告が表示されます。「APIキー」の右側にあるコピーアイコン(重なった2つの四角)をクリックしてください。
メールやチャットではなく、クエリ ストリーム ウィザード(またはパスワード マネージャー)に直接貼り付けてください。ポップアップにシークレット キーの行も表示される場合は、V1 キーが作成されています。[完了] をクリックし、手順 4 に戻って V2 API を選択してください。
- 「完了」をクリック
「完了」をクリックします。API設定画面に戻ると、キーが非表示になっています。ShipStationはこれを再度表示しません。紛失した場合は、削除して新しいキーを生成してください。
許可を与える
リソース アクセス 用途 V2 APIキー(APIバージョンを選択 → V2 API) アカウントへのフルアクセスが可能です。ShipStationには読み取り専用キーや制限付きキーはありません。 すべての shipstation.* テーブルには、出荷、ラベル、フルフィルメント(デフォルトで有効)、運送業者、運送サービス、倉庫、製品、バッチ、マニフェスト、集荷、タグ、ユーザー、および Webhook が含まれます。クエリ ストリームは読み取りリクエストのみを送信します。 プラン:スタンダード、アクセラレート、プレミアム以上 必須 これがないと、ShipStationは402エラーを返し、テーブルの同期は行われません。無料プランとスタータープランではAPIへのアクセスはできません。 在庫管理API(設定 → アドオン) スタンダードプラン以上は標準装備。下位プランはオプション。 inventory テーブルと inventory_locations テーブル。アドオン (Standard より下のプラン) のみを持つキーは、テストが出荷を読み取るため、接続テストに失敗します。 アカウント所有者 キーを生成するために必要 テーブルはありません。ShipStationでは、アカウント所有者のみがAPIキーを作成できます。 クエリ ストリームに貼り付ける
- ShipStation APIキー
- ステップ10でコピーしたAPIキーは、1つの値のみで、秘密情報はありません。TEST_で始まるキーはサンドボックスキーであり、サンドボックスデータのみを表示します。Query Streamsはエージェント用にキーを保存し、そのキーを使用してのみ読み取りを行います。
よくある問題
接続テストの結果、赤色のエラーメッセージ「無効なAPIキー」が表示されました。
なぜ: V1キーまたはその秘密鍵が貼り付けられたか、値に余分なスペースが含まれているか、キーが削除されたか、有効期限が切れています。
修理: V2キーを生成し(手順4~11)、APIキーの値のみを貼り付けます。「接続テスト」をクリックし、「接続済み」と表示されるまで待ちます。
接続テストでAPIエラー「PaymentRequired」が表示されます。
なぜ: ShipStation は 402 エラーを返しました。アカウントが Standard 未満のプラン (無料または Starter) であるか、Inventory API アドオンのみが有効になっています。
修理: アカウント → 支払いとサブスクリプションでスタンダードプラン以上にアップグレードし、同じキーを使用して再度テストをクリックしてください。
キーを生成できません。「APIキーの生成」で「メール認証が必要です」と表示されるか、設定担当者にキーを作成する権限がありません。
なぜ: アカウント所有者のみがキーを生成でき、しかもメールアドレスの認証後にのみ生成可能です。
修理: アカウント所有者としてサインインし、ShipStationからの確認メールに記載されているリンクをクリックしてから、もう一度「APIキーを生成」をクリックしてください。
接続は数ヶ月間正常に機能していましたが、その後ShipStationの同期が停止し、接続テストで「無効なAPIキー」と表示されるようになりました。
なぜ: キーの有効期限が3ヶ月、6ヶ月、または12ヶ月に達したか、誰かが別のツール用の新しいキーを作成するためにキーを削除しました(アカウントにはV2キーを1つしか保持できません)。
修理: 新しいV2キーを生成し、データエージェントでShipStation接続を編集し、新しいキーをShipStation APIキーに貼り付けて「接続テスト」をクリックします。古いキーを使用していた他のツールにも、同じ新しいキーを割り当ててください。
テーブルが空だったり、テスト出荷のみが表示されたり、同期が遅い。
なぜ: ShipStation APIダッシュボードから取得したサンドボックスキー(TEST_で始まるキー)を使用しました。サンドボックスデータは実際の出荷データとは別個のものであり、サンドボックスキーは1分あたり20リクエストに制限されています。
修理: 本番環境用のキー(TEST_ の接頭辞は不要)を貼り付けて、「接続テスト」をクリックしてください。
ShipStationの一部のテーブルが遅延しており、エージェントログにTooManyRequestsが表示されています。
なぜ: ShipStationは、アカウントごとに1分あたり200件のリクエストを許可しており、これは接続されているすべてのアプリで共有されます。別の連携機能が、その予算の大部分を使用しています。
修理: クエリ ストリームで変更する必要はありません。テーブルは次回のスケジュールされた同期時に再度試行します。これが毎日発生する場合は、[email protected] まで ShipStation に問い合わせて、上限値の引き上げを依頼してください。
知るべき限界
- ShipStationアカウント1つあたりのデフォルトのリクエスト数は1分あたり200件で、これはアカウントを使用するすべてのアプリとインテグレーションで共有されます。これを超えると、ShipStationは「429 Too Many Requests」エラーを返します。エージェントは、このうちのごく一部を処理するように動作します。より高い制限を設定するには、[email protected]までメールでお問い合わせください。
- サンドボックスキー(TEST_ プレフィックス、ShipStation API のお客様のみ):1 分あたり 20 リクエスト、サンドボックスデータのみ。ShipStation ウェブアプリ(プラットフォーム)アカウントにはサンドボックスがないため、すべてのキーでライブデータが読み取られます。
- APIキーは、生成時に選択した3ヶ月、6ヶ月、または12ヶ月後に有効期限が切れます。ShipStationは有効期限前にリマインダーメールを送信します。
- 1つのアカウントにつき1つのV2キーのみ使用可能です。同じキーを複数のアプリで使用できます。
- 無料プランとスタータープランではAPIへのアクセスはできません。スタンダードプラン未満の場合、V2キーはインベントリAPIアドオンのインベントリエンドポイントを除き、402エラーを返します。
- V1 API(旧バージョン、非推奨)は、別のアドレスにあるAPIキーとシークレットキーのペアを使用し、1ペアあたり1分あたり40リクエストに制限されています。クエリストリームはV1を使用しません。
手順は2026年10月8日に確認済み。出典: help.shipstation.com/hc/en-us/articles/360025856212-ShipS…, docs.shipstation.com/authentication, docs.shipstation.com/getting-started, docs.shipstation.com/rate-limits, docs.shipstation.com/sandbox, docs.shipstation.com/products-and-plans, docs.shipstation.com/plans/shipstation-free-starter, docs.shipstation.com/plans/shipstation-standard-premium, docs.shipstation.com/apis/shipengine/docs/guides/auth, docs.shipstation.com/apis/shipengine/docs/guides/rate-limits, docs.shipstation.com/apis/shipstation-v1/docs/start-here/…, nango.dev/docs/integrations/all/shipstation-v2/connect.
- 接続名
- 後で必ず思い出すような名前、例えば「販売データベース」など。
- ShipStation APIキー
- ShipStationのAPIキーは、ShipStationの「設定」→「アカウント」→「API設定」で確認できます。
クリック 接続テスト読むと 接続済み、 クリック セーブ接続は数秒以内に担当エージェントに到達します。
テストは失敗しましたか? 通常は権限が不足しているか、間違った ShipStation アカウントの認証情報が原因です。上記の手順では、 よくある問題 そして、それらの解決策。
-
Googleスプレッドシートにクエリストリームを追加する
Google スプレッドシートを開き、 拡張機能 → アドオン → アドオンを入手、 検索する クエリストリーム、そしてクリック インストールまたは、直接インストールしてください。 Google Workspace Marketplace のクエリ ストリームGoogleはアドオンの許可を求めますが、これは正常な動作です。
その後は、開くすべての Google スプレッドシートに表示されます。右側のサイド パネルにクエリ ストリーム アイコンが表示され、 拡張機能別途ログインする必要はありません。既にお使いのGoogleアカウントを認識するため、そのメールアドレスはQuery Streamsアカウントに登録されているものと同じである必要があります。
-
最初のテーブルを運び入れる
シートの右側のサイドパネルにあるクエリ ストリーム アイコンをクリックします (または、以下で見つけます) 拡張機能)。 選ぶ クエリストリーマー そして、先ほど繋がった接続を選択してください。
実行したいクエリを入力してください。これは、いくつかの列を抽出します。 シップステーションの出荷 テーブル:
例:SQLSELECT shipment_id, shipment_status, ship_date, carrier_id FROM shipstation.shipments ORDER BY created_at DESC LIMIT 100;
下 目的地一覧表 行を配置するタブを選択し、次にクリックします。 クエリーの実行データは1~2秒でそのタブに表示されます。データが変更された場合はいつでも「クエリの実行」を再度クリックすると、タブが即座に更新されます。
SQLを知らない? クエリは、クエリストリームポータルで作成してください。 クエリビルダー テーブルと列が表示されるので、ポイント&クリックで操作できます。ビジネスプランでは、Novaに「米国の顧客を表示して」といった簡単な英語で質問すると、SQLクエリが自動的に生成されます。クエリを保存すれば、ポータル内はもちろん、アドオンの「保存済みクエリ」リスト(パーソナルコア以降)からもワンクリックでアクセスできます。
それでおしまい。 データはシート内に保存され、ワンクリックで常に最新の状態に保たれます。お客様が要求した行以外は、ネットワークから外部に送信されることはありません。
良い次の動き
- クエリを保存します ポータルにインストールすれば、Google スプレッドシートや Excel からワンクリックで再度実行できます。
- フィルターを追加する 例えば日付範囲などを指定することで、同じクエリで編集せずに「今月」という回答を得ることができます。
- 結果を共有する 同僚と共有する場合、同僚には行数が表示され、あなたの認証情報は表示されません。
人々が尋ねる質問
ShipStationのアカウントは、私がSheetsを使用するコンピューターに登録されている必要がありますか?
いいえ。エージェントがShipStationアカウントと同じ場所にいれば十分です。Googleスプレッドシートはどのデバイスのブラウザでも動作します。同じGoogleアカウントでアドオンを開けば、接続情報が表示されます。
私のデータはクエリストリームにコピーされますか?
いいえ。エージェントはデータが存在する場所でクエリを実行し、返された行のみを送信します。その間に同期や保存は一切行われません。
無料プランで本当にこれがカバーされるのですか?
はい。無料プランは継続して利用できるプランで、期限切れのトライアルではありません。プランに含まれる内容については、 価格ページ.
シートは自動的に更新されますか?
最新の行を取得したい場合は、いつでも「クエリの実行」を再度クリックしてください。ユーザーが何も操作しなくてもスケジュールに基づいてシートが更新されるようにするには、クエリ ストリーム ポータル(ストリーム → 自動化)で自動化を設定します。これはすべてのプランに含まれています。
関連ガイド
すべてのガイド ShipStation
Setup trouble?
- Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?

