如何将 ShipStation 连接到 Google Sheets - 使用 SQL 查询装运数据

连接 · ShipStation 到 Google Sheets

从以下来源获取数据 ShipStation 进入 谷歌工作表

将 ShipStation 帐户中的实时数据导入 Google Sheets，并随时刷新。无需上传 CSV 文件、使用 Apps Script 或复制粘贴。首次操作大约只需十分钟，而且免费套餐就包含了这项功能。

大约10分钟 无需编程 凭证将一直随您保留 任何浏览器，任何设备

你最终会得到什么

一个 Google 表格，实时显示针对您的 ShipStation 帐户执行 SQL 查询的结果，并带有一个按钮，可在数据更改时自动获取最新行。例如：

销售 已保存到硬盘

文件编辑看法插入格式数据工具扩展帮助

	A	B	C	D	E
1	customer_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 来自 ShipStation 的现场报道

ShipStation 将您的数据存储在其 API 之后。通常，每次需要新数据时，都需要从 ShipStation 控制面板导出 CSV 文件才能将其导入 Google Sheets。Query Streams 则简化了这一步骤：一个名为 Agent 的小型辅助程序会在您的数据所在位置运行查询，然后 Google Sheets 插件会向其请求所需的行。只有查询结果会通过加密链接传输，因此 Google Sheets 可以位于任何位置：任何设备上的任何浏览器。

你需要准备什么

查询流帐户

免费版足以满足本指南的需求。请注册： my.querystreams.com.

任何始终在线的计算机上的代理

这是一个在后台运行的小程序，当 Google Sheets 发出请求时，它会调用 ShipStation。它只需要网络连接即可。

您的 ShipStation 登录信息

您只需登录一次 ShipStation 并授予读取权限。查询流中无需输入任何密码。

分五步连接

1. 创建您的帐户

   前往 my.querystreams.com 并注册。选择 免费 计划。这是一个正式的计划，不是试用版，它涵盖了连接您的 ShipStation 帐户以及从 Google Sheets 运行查询的内容。

2. 在任何始终开机的计算机上安装代理程序。

   登录，打开 下载然后将代理程序安装到任何始终在线且可访问互联网的计算机或服务器上。安装只需一分钟，安装完成后即可自动启动。

   为什么使用小型程序而不是驱动程序？ 该代理程序只需在 Windows、Mac 或 Linux 系统上安装一次（Windows 系统下约 85 MB，Mac 和 Linux 系统下略超过 100 MB），即可在后台静默运行。它会像浏览器一样，与 Query Streams 建立一条加密的出站连接，因此您无需打开任何防火墙端口或设置 VPN。您的密钥保留在本地计算机上，查询数据会传输到您所在的任何位置，必要时甚至会通过互联网传输。您这边只需要安装该插件即可。

   下载页面显示 您的访问密钥当代理提示时，将其粘贴到代理中，然后等待徽章读取。 已连接到查询流这是你在代理程序本身上唯一需要做的事情。

   完整攻略（如果您需要）： Windows, 苹果, Linux.

3. 指向您的 ShipStation 帐户

   返回浏览器，打开 数据代理 （在下面 数据 （在顶部菜单中）。您的经纪人信息就在那里。点击 添加连接器 并选择 ShipStation需要先输入您的 ShipStation 凭据吗？打开此指南，然后填写：

   创建您的 ShipStation 凭证 （约5分钟）

   接下来，在另一个标签页中打开 ShipStation。查询流会将您在此处创建的内容保存下来，以便您的代理可以使用它，并且它只会从 ShipStation 读取数据。

   谁能做到这一点？

   账户所有者（ShipStation 只允许账户所有者生成 API 密钥）

   受到推崇的

   ShipStation V2 API 密钥（生产密钥）

   开始之前

   • ShipStation 的标准版、加速版、高级版或更高级别的套餐均需具备 API 访问权限。免费版和入门版套餐不提供 API 访问权限。
   • 账户所有者的 ShipStation 登录信息，以及对所有者电子邮件收件箱的访问权限（首次创建密钥之前，ShipStation 会通过电子邮件发送验证链接）。
   • 如果贵公司使用的是 ShipStation API（以前称为 ShipEngine 的开发者产品）而不是 ShipStation Web 应用，则您的密钥位于 ShipStation API 控制面板（https://api-portal.shipstation.com/）中：切换到生产环境并复制生产密钥，然后直接进入向导。以 TEST_ 开头的密钥是沙盒密钥。
   • 查询流向导将在另一个标签页中打开：数据代理 → 添加连接器 → ShipStation。

   步骤

   1. 以账户所有者身份登录 ShipStation

      在新标签页中打开 ShipStation，并使用账户所有者的登录信息登录。只有账户所有者才能生成 API 密钥，并且 ShipStation 只会向生成密钥的人显示一次新密钥。

      不是所有者？请所有者自行完成步骤 1 到 11，并将密钥粘贴到“查询流”向导中，或者通过密码管理器发送给您。如果您不确定所有者是谁，可以联系 ShipStation 支持团队 ([email protected]) 查询。

   2. 打开设置

      点击屏幕右上角深色工具栏中位于打印机图标和问号图标之间的齿轮图标（设置）。

      部分用户也可以通过人物图标 → 我的个人资料 进入相同的设置区域。

   3. 开放API设置

      在左侧边栏中，展开“帐户”（如果已折叠），然后点击“API 设置”。页面标题为“API 设置”，下方有一个“API 密钥”框。登录后，该链接将直接打开此页面。

      如果页面显示您的套餐不支持 API 访问，则说明您的账户目前处于免费或入门级状态。请先在“账户”→“付款与订阅”中升级到标准版或更高版本。

   4. 选择 V2 API

      在“选择 API 版本”下拉菜单中，选择 V2 API。

      下拉菜单可在 V1 API 上打开。查询流使用 ShipStation 的 V2 API。V1 密钥包含一个 API 密钥和一个私钥，因此测试连接时会因 API 密钥无效而失败。

   5. 检查 V2 密钥是否已存在

      如果框中显示“生成 API 密钥”按钮，请转到步骤 6。如果框中显示“生产密钥”行，其中包含隐藏密钥、复制图标和垃圾桶图标，则表示该帐户已拥有其唯一允许的 V2 密钥。

      如果现有密钥已安全保存（例如密码管理器或其他工具的设置，您可以从中复制），请使用该密钥并直接进入向导。否则，请单击垃圾桶图标，然后在“删除 API 密钥”弹出窗口中选择“删除密钥”。删除操作无法撤销，任何使用旧密钥的其他工具都将停止工作，直到您提供新密钥为止。

   6. 点击“生成 API 密钥”

      点击方框右侧的“生成 API 密钥”。如果弹出标题为“生成 API 密钥”的窗口，请跳至步骤 9。如果出现蓝色提示（“需要进行电子邮件验证。请点击我们发送到您用户邮箱的验证链接，然后重试。”），请执行步骤 7 和 8。

      ShipStation 会在生成账户首个密钥前要求进行邮箱验证。新账户必须先验证邮箱才能生成密钥。

   7. 点击您邮箱中的验证链接。

      打开 ShipStation 发送到账户所有者邮箱的电子邮件，然后点击其中的验证链接。

      几分钟后仍未收到邮件？请检查垃圾邮件和促销邮件文件夹。

   8. 再次点击“生成 API 密钥”

      返回 API 设置选项卡，检查“选择 API 版本”是否仍然显示 V2 API，然后再次单击“生成 API 密钥”。

      按钮会在邮箱验证成功后重置。如果蓝色提示仍然存在，请刷新页面并再次选择 V2 API。

   9. 选择到期日期，然后点击“生成”。

      在“生成 API 密钥”弹出窗口中，“设置密钥过期时间”下，选择 12 个月、6 个月或 3 个月，然后单击“生成”。

      密钥将于该日期失效，您的 ShipStation 同步也将随之停止。您可以选择 12 个月的有效期并在日历中设置提醒；ShipStation 也会在密钥过期前发送电子邮件提醒。

   10. 复制 API 密钥

       此时会弹出一个名为“API密钥已创建”的窗口，并警告说这是密钥唯一一次可见。点击“API密钥”右侧的复制图标（两个重叠的方块）。

       直接将其粘贴到“查询流”向导（或密码管理器）中，不要粘贴到电子邮件或聊天窗口中。如果弹出窗口还显示“密钥”行，则表示您创建的是 V1 密钥：单击“完成”，返回步骤 4 并选择 V2 API。

   11. 点击完成

       点击“完成”。返回 API 设置页面，密钥现在显示为隐藏状态。ShipStation 不会再次显示该密钥；如果密钥丢失，请将其删除并生成一个新密钥。

   授予权限

   资源	访问	用于
   V2 API 密钥（选择 API 版本 → V2 API）	拥有完整账户权限。ShipStation 没有只读或受限密钥。	每个 shipstation.* 表：包含发货、标签和履行（默认启用），以及承运商、承运商服务、仓库、产品、批次、清单、取货、标签、用户和 Webhook。查询流仅发送读取请求。
   方案：标准版、加速版、高级版或更高级别	必需的	如果没有它，ShipStation 会返回 402 错误，并且无法进行表同步。免费版和入门版套餐不提供 API 访问权限。
   库存 API（设置 → 附加组件）	标准版及以上套餐包含；低级别套餐需另行购买。	库存表和库存位置表。即使某个键只包含附加组件（低于标准版的套餐），测试连接仍然会失败，因为测试会读取发货信息。
   账户所有者	生成密钥所需	没有表格。ShipStation 只允许账户所有者创建 API 密钥。

   粘贴到查询流中

   ShipStation API密钥

   您在步骤 10 中复制的 API 密钥：只有一个值，没有秘密信息。以 TEST_ 开头的密钥是沙盒密钥，仅显示沙盒数据。Query Streams 会为您的代理存储此密钥，并且仅使用此密钥读取数据。

   常见问题

   测试连接显示红色结果：无效的 API 密钥。

   为什么： 粘贴的 V1 密钥或其私钥中出现了多余的空格，或者密钥已被删除或已过期。

   使固定： 生成 V2 密钥（步骤 4 至 11），并仅粘贴 API 密钥值。单击“测试连接”，直到显示“已连接”。

   测试连接显示 API 错误：需要付款。

   为什么： ShipStation 回复 402：该帐户的套餐低于标准版（免费版或入门版），或者仅包含库存 API 插件。

   使固定： 在“帐户”→“付款和订阅”下升级到标准版或更高版本，然后使用相同的密钥再次点击“测试”。

   您无法生成密钥：生成 API 密钥时一直显示“需要电子邮件验证”，或者设置人员无权创建密钥。

   为什么： 只有账户所有者才能生成密钥，并且只有在验证其电子邮件地址后才能生成密钥。

   使固定： 以账户所有者身份登录，点击 ShipStation 验证邮件中的链接，然后再次点击“生成 API 密钥”。

   连接运行了几个月后，ShipStation 同步停止，测试连接显示“无效的 API 密钥”。

   为什么： 密钥已达到 3、6 或 12 个月的有效期，或者有人将其删除以创建另一个工具的新密钥（一个帐户只能持有一个 V2 密钥）。

   使固定： 生成一个新的 V2 密钥，然后在数据代理中编辑 ShipStation 连接，将新密钥粘贴到 ShipStation API 密钥中，然后单击“测试连接”。将同一个新密钥提供给任何其他使用旧密钥的工具。

   表格为空或仅显示测试发货信息，同步速度很慢。

   为什么： 我们使用了 ShipStation API 控制面板中的沙盒密钥（以 TEST_ 开头）。沙盒数据与您的实际货运数据完全隔离，且沙盒密钥每分钟的请求次数限制为 20 次。

   使固定： 粘贴一个生产密钥（不带 TEST_ 前缀），然后单击“测试连接”。

   ShipStation 的某些表存在延迟，代理日志显示请求过多。

   为什么： ShipStation 允许每个账户每分钟发起 200 个请求，所有连接到该账户的应用共享这些请求。另一个集成占用了大部分资源。

   使固定： 查询流无需任何更改：该表将在下次计划同步时重试。如果每天都发生这种情况，请联系 ShipStation，请求提高同步次数限制，邮箱地址为 [email protected]。

   需要了解的界限

   • 默认情况下，每个 ShipStation 帐户每分钟最多可处理 200 个请求，所有使用该帐户的应用和集成共享此限制；超过此限制，ShipStation 将返回 429 请求过多错误。代理程序会根据限制进行调整，仅处理少量请求。如需更高的限制，请发送电子邮件至 [email protected]。
   • 沙盒密钥（TEST_ 前缀，仅限 ShipStation API 客户）：每分钟 20 次请求，仅读取沙盒数据。ShipStation Web 应用（平台）账户没有沙盒，因此每个密钥都会读取实时数据。
   • API密钥的有效期为3个月、6个月或12个月，具体有效期可在生成密钥时选择。ShipStation会在密钥到期前发送电子邮件提醒。
   • 每个账户一次只能使用一个 V2 密钥；同一个密钥可以被多个应用程序使用。
   • 免费版和入门版套餐不提供 API 访问权限。标准版以下的套餐，除库存 API 插件的库存端点外，V2 密钥均会返回 402 错误。
   • V1 API（旧版，已弃用）使用位于不同地址的 API 密钥和私钥对，每对密钥每分钟限制 40 次请求。查询流不使用 V1 API。

   步骤已于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 帐户凭据。上面的步骤详述了以下内容： 常见问题 以及他们的解决方案。

4. See your data in Query Builder 选修的

   You can look at your ShipStation account before Google Sheets is involved at all. Open 查询生成器 in the portal and pick the connection you just made. The 模式 tab lists your tables and columns, and clicking one puts its name in the editor, so you can write a query without remembering exact names. Click 运行 and the rows appear under 成果. Query Builder is on every plan, Free included.

   On Business plans you can also ask Nova in plain English (“show me customers in the USA”) and it writes the SQL for you. When the query looks right, save it: from Personal Core up it shows in the add-on’s Saved Queries list, and on any plan you can copy the SQL into the next step.

5. 将查询流添加到 Google 表格

   打开任意一个 Google 表格，然后转到 扩展程序 → 附加组件 → 获取附加组件搜索 查询流然后点击 安装或者直接从这里安装 Google Workspace Marketplace 上的查询流谷歌会要求你允许安装该插件；这是正常现象。

   之后，您打开的每个 Google 表格中都会出现“查询流”图标，位于右侧边栏，也列在“查询流”下方。 扩展无需单独登录。它会识别您已在使用的 Google 帐户，因此该电子邮件地址必须与您的 Query Streams 帐户所用的电子邮件地址一致。

6. 把你的第一张桌子拉过来

   单击工作表右侧侧面板中的“查询流”图标（或在下方找到它）。 扩展）。 选择 查询流 选择你刚刚建立的连接。

   输入要运行的查询语句。以下查询语句会从数据库中提取几列数据。 船舶站发货 桌子：

   示例 · SQL

   SELECT shipping_id, shipping_status, ship_date, carrier_id FROM shipstation.shipments ORDER BY created_at DESC LIMIT 100;

   在下面 目的地表 选择行应该落入的选项卡，然后单击 运行查询数据行会在一两秒内显示在该标签页中。如果数据发生更改，请随时再次单击“运行查询”，标签页将自动更新。

   不懂SQL？ Build it in 查询生成器 first and paste it here, or pick it from Saved Queries if you saved it.

下一步行动不错。

• 保存查询 在门户网站中，您可以一键再次运行它，也可以从 Google Sheets 或 Excel 中运行。
• 添加筛选器 例如日期范围，这样同一个查询就可以回答“本月”而无需编辑。
• 分享结果 与同事一起操作。他们看到的是行，而不是你的凭证。

人们提出的问题

相关指南

• ShipStation 到 Microsoft Excel
• Stripe 到 Google 表格
• HubSpot 到 Google 表格
• Shopify 到 Google 表格
• 用于 Google Sheets 的 Power Query
• 所有指南