查看类别

如何将 Shopify 连接到 Google Sheets - 使用 SQL 查询电子商务数据

阅读时间：15分钟

0:00 16:38
连接 · Shopify 到 Google Sheets

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

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

大约10分钟 无需编程 凭证将一直随您保留 任何浏览器，任何设备
遇到任何问题？尽管问我们。 打开 支持 请在“查询流”（右上角菜单 → 支持）中给我们发送消息。我们会安排专人阅读您的消息，“我不知道这个屏幕需要什么”就是一个很好的问题。

你最终会得到什么

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

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

特工奔跑的地方任何始终在线且联网的计算机或服务器您的 Shopify帐户钥匙留在这里查询流代理持有凭证查询流加密链接通过互联网 · 仅显示结果无论你身在何处任何浏览器：笔记本电脑、平板电脑、手机、Chromebook谷歌工作表一行行数据以表格形式呈现
代理程序与您的数据共存。您的表格存储在 Google 云端。无论身在何处打开它，数据行都会同步显示。

你需要准备什么

查询流帐户

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

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

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

您的 Shopify 登录信息

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

哪个计算机获得代理？ 任何能够访问您的 Shopify 帐户且始终在线的设备。 Google Sheets 可以放在任何地方它在浏览器中运行。

分五步连接

  1. 创建您的帐户

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

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

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

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

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

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

  3. 将其指向您的 Shopify 帐户

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

    创建您的 Shopify 凭据 （约10分钟）

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

    谁能做到这一点？
    商店所有者，或具有“应用开发 > 开发”权限的员工帐户（协作帐户无法使用开发者控制面板）
    受到推崇的
    开发者控制面板应用（自定义应用）位于您店铺的 Shopify 组织内：客户端 ID + 客户端密钥，只读权限

    开始之前

    • 您的 Shopify 商店管理员登录信息：商店所有者，或拥有“应用开发 > 开发”权限的员工帐户。商店所有者自动拥有此权限。
    • 查询流向导将在另一个标签页中打开：数据代理 → 添加连接器 → Shopify，您的代理已在线。
    • 无需编写代码。Shopify 不再允许您复制新应用的现成访问令牌；查询流会将应用的客户端 ID 和客户端密钥转换为一个短期有效的令牌。

    步骤

    1. 打开应用商店的应用设置

      登录您的 Shopify 管理后台。点击“设置”（左下角），然后点击“应用”。

      在某些商店中，此菜单项显示为“应用和销售渠道”。请使用您要连接的商店的管理员帐户。

    2. 点击“开发应用”

      在“应用设置”页面上，点击“开发应用”。

      没有“开发应用”按钮？您的员工帐户缺少“应用开发 > 开发”权限。请联系商店所有者授予此权限，或按照以下步骤操作。

    3. 打开开发者控制面板

      在开发者控制面板中点击“构建应用”。开发者控制面板通常会在新标签页中打开。

      请通过店铺后台管理界面打开，而不是单独登录 dev.shopify.com。应用必须与店铺位于同一 Shopify 组织内，否则 Query Streams 将无法连接。

    4. 点击“创建应用”

      确认左侧菜单中已选择“应用”，然后点击右上角的“创建应用”。

    5. 从开发者控制面板选择“开始”

      选择从开发者控制面板开始（而不是从 Shopify CLI 开始）。

    6. 给应用命名

      输入一个你容易识别的名称，例如“查询流”，然后点击“创建”。应用程序的第一个版本页面随即打开。

      这个名称仅供您使用。查询流不需要特定的名称。

    7. 保留默认应用网址

      在“URL”部分，将应用 URL 保留为 https://shopify.dev/apps/default-app-home（如果该框为空，请手动输入）。如果您看到“在 Shopify 管理后台嵌入应用”选项，请将其关闭。

      Query Streams 不会在您的 Shopify 管理后台中打开，因此 Shopify 的默认地址才是正确的。

    8. 选择 Webhooks API 版本

      在 Webhooks API 版本中，选择列表中的最新版本。

      Query Streams 不使用 webhook，因此任何版本都可以使用。

    9. 添加读取范围

      在“访问权限”部分，找到“范围”。粘贴此列表，或单击“选择范围”并逐一勾选：read_orders、read_draft_orders、read_customers、read_products、read_inventory、read_locations、read_discounts、read_gift_cards、read_shipping、read_merchant_managed_fulfillment_orders、read_assigned_fulfillment_orders、read_third_party_fulfillment_orders、read_content、read_themes、read_legal_policies、read_shopify_payments_accounts、read_shopify_payments_payouts、read_shopify_payments_disputes。将“可选范围”留空。

      仅选择 read_ 权限范围：查询流不会更改您商店中的任何内容。请勿添加 read_all_orders 权限范围。Shopify 会拒绝此类应用，并提示“包含无效权限范围”（请参阅“限制”）。read_payouts 和 read_shopify_payments 也不是有效的权限范围名称。即使您不使用 Shopify Payments，也请保留这三个 Shopify Payments 权限范围；这些表将保持为空。

    10. 点击释放

      滚动到页面底部，然后单击“发布”。此时将打开一个对话框，其中包含可选的版本名称和消息。

      您可以两个方框都留空。

    11. 确认发布

      在对话框中点击“发布”。在应用的“版本”页面上，新版本现在会显示“已启用”徽章。

    12. 点击安装应用

      打开应用的首页（点击应用名称，或点击应用菜单中的“首页”）。在“已安装”卡片中，点击“安装应用”。此时会打开一个新标签页。

      在应用列表的应用行中，⋯菜单也包含相同的操作。

    13. 选择您的门店

      如果您有多家店铺，请选择要连接的店铺。

      选择你在步骤 1 中开始使用的商店的管理后台。

    14. 点击安装

      Shopify 会显示一个“安装应用”屏幕，其中列出了该应用可以查看的店铺数据。选中所需数据，然后点击“安装”。

      返回开发者控制面板，“安装”卡片现在显示 1 次安装。如果仍然显示 0 次安装，请刷新页面。

    15. 打开应用的设置

      在开发者控制面板中，打开您的应用，然后点击“设置”（某些屏幕上显示为“应用设置”）。找到“凭据”卡片。

    16. 复制客户端 ID

      在“客户端 ID”旁边，单击复制（剪贴板）图标。将其粘贴到“查询流”向导中的“客户端 ID”处。

      它由 32 个字母和数字组成，例如 a8ed94aa0680bc6580eea34486dcaa6b。它永远不会改变。

    17. 复制客户端密钥

      在“客户端密钥”（某些屏幕上标记为“密钥”）旁边，单击眼睛图标以显示它，然后单击复制图标。将其粘贴到“查询流”向导中的“客户端密钥”中。

      它以 shpss_ 开头。Shopify 会一直在这个页面上显示它，方便您稍后回来查看。除非您打算替换它，否则请不要点击“旋转”。

    18. 复制您的商店地址

      在 Shopify 管理后台，转到“设置”→“域名”，复制以 .myshopify.com 结尾的地址，例如 your-store.myshopify.com。将其粘贴到“查询流”向导的“商店地址”中。

      您自己的域名（例如 www.yourbrand.com）将无法使用。您在后台管理界面中浏览器地址栏里显示的地址，例如 admin.shopify.com/store/your-store，也是可以接受的。

    19. 测试连接

      在“查询流”向导中，单击“测试连接”。它显示“已连接”。

      如果显示的是消息，请在“常见问题”下查找。

    授予权限

    资源访问用于
    读取订单读orders、order_line_items、transactions、refunds、fulfillments、order_risks 和 abandon_checkouts 表（最近 60 天，参见限制）
    读取草稿订单读draft_orders 表
    读取客户读客户表和客户地址表
    读取产品读产品、变体、系列、智能系列和自定义系列表
    读取库存读inventory_levels 和 inventory_items 表
    读取位置读locations 表，以及 inventory_levels 表中每个位置的行
    读取折扣读价格规则和折扣码表
    读取礼品卡读礼品卡表
    读取发货信息读shipping_zones 和 carrier_services 表
    读取商家管理的履行订单读fulfillment_orders 表：您从自有仓库发货的订单
    读取已分配的履行订单读fulfillment_orders 表（三个 fulfillment-order 作用域中的任何一个都可以启用该表；三个作用域都启用则会显示完整列表）
    读取第三方履行订单读fulfillment_orders 表：由第三方履行服务完成的订单
    读取内容读博客、文章和页面表格
    读取主题读主题表
    阅读法律政策读策略表
    读取Shopify支付账户读需要与接下来的两个表格一起用于支付和争议表格（仅限 Shopify Payments 商店）
    读取 Shopify 付款信息读赔付表
    读取 Shopify 付款争议读争议表

    粘贴到查询流中

    商店地址
    第 18 步中的 .myshopify.com 地址（或浏览器地址栏中的 admin.shopify.com/store/… 地址）
    客户ID
    您在步骤 16 中复制的客户端 ID
    客户机密
    您在步骤 17 中复制的客户端密钥（以 shpss_ 开头）

    常见问题

    测试连接显示“应用和商店必须属于同一个 Shopify 组织”。

    为什么： 该应用是在与店铺不同的 Shopify 组织中创建的，例如，使用另一个帐户登录 dev.shopify.com 或选择另一个组织后创建的。拥有店铺所有权是不够的。

    使固定： 请从商店后台重新开始：设置 → 应用 → 开发应用 → 在开发者控制面板中构建应用，然后在那里创建应用（步骤 1 至 17）。如果您属于多个组织，组织 ID 位于开发者控制面板地址中（dev.shopify.com/dashboard/<org-id>）；应用和商店必须属于同一个组织。

    测试连接显示“客户端 ID 或客户端密钥错误，或者该应用未安装到此应用商店”。

    为什么： 值复制不完整或包含空格，客户端 ID 和客户端密钥互换，密钥已轮换，或者该应用未安装到此应用商店（或已卸载）。

    使固定： 使用应用设置页面上的复制图标再次复制这两个值；密钥以 shpss_ 开头。检查应用的“安装”卡片是否列出了您的应用商店，如果没有，请点击“安装应用”。如果有人点击了“旋转”，请使用标记为“新建”的密钥。然后再次点击“测试连接”。

    测试连接拒绝了商店地址（“请使用您的 .myshopify.com 地址（设置 → 域名）或 admin.shopify.com/store/… URL。API 不能使用自定义域名。”），或者显示“找不到商店。请检查商店地址。”

    为什么： 您输入的是自己的域名（例如 www.yourbrand.com），或者店铺用户名有拼写错误。

    使固定： 从 Shopify 管理后台的“设置”→“域名”复制 .myshopify.com 地址，或者从浏览器地址栏复制 admin.shopify.com/store/… 地址。

    测试连接显示“令牌已被接受，但没有作用域”，或者某些表因缺少名为“payouts”的作用域而被关闭（例如，payouts 需要 read_shopify_payments_payouts）。

    为什么： 该应用的当前版本不具备此功能，或者已发布新版本但应用商店尚未批准。

    使固定： 在开发者控制面板中，打开您的应用 → 版本 → 创建版本，添加缺失的 read_ 权限，然后点击“发布”。接下来，打开应用，在“安装”卡片中，再次点击“为您的应用商店安装应用”以批准更改：在我们自己的测试中，应用商店会保留旧权限，直到完成此操作。再次点击“测试连接”。

    点击“发布”按钮显示“包含无效作用域”。

    为什么： 添加了 read_all_orders 权限（Shopify 必须批准，开发者控制面板应用无法请求此权限），或者权限范围名称拼写错误，例如 read_payouts 或 read_shopify_payments。

    使固定： 将其删除，并完全使用步骤 9 中的名称。

    超过 60 天左右的订单永远不会显示。

    为什么： Shopify 只向没有 read_all_orders 权限的应用提供最近 60 天的订单（参见限制）。

    使固定： 今天应用或查询流中无需进行任何更改。已加载的订单会保留在您的查询流缓存中，因此您的历史记录会从您连接之日起不断累积。

    付款和争议表格仍然为空，并显示注释“此商店未启用 Shopify Payments，因此此表格中没有任何内容可以加载”。

    为什么： 该商店通过其他支付服务商收款，因此 Shopify 无需处理任何付款或纠纷。

    使固定： 无需修复。其他表格不受影响。

    当其他列加载完毕时，客户姓名、电子邮件、电话号码或地址均为空。

    为什么： Shopify 将这些字段视为受保护的客户数据。其帮助中心指出，基础套餐的店铺无法使用读取这些字段的自定义应用；需要升级到高级套餐或更高级别的套餐。

    使固定： 检查店铺当前使用的 Shopify 套餐。在基础套餐下，这些列将保持为空，直到店铺升级到成长套餐或更高级别；查询流设置不会更改此行为。

    如果没有“开发应用”按钮，开发者控制面板将无法打开。

    为什么： 您的员工帐户没有“应用开发 > 开发”权限，或者您使用协作帐户登录，而协作帐户无法使用开发者控制面板。

    使固定： 请店主授予您的员工帐户“应用程序开发 > 开发”权限，或者让他们自行按照以下步骤操作。

    需要了解的界限

    • 订单：Shopify 只允许应用访问最近 60 天内创建的订单。更早的订单需要 `read_all_orders` 权限，该权限必须经过 Shopify 的批准。开发者控制面板会拒绝此类应用的权限申请（“包含无效权限：read_all_orders”，检查日期：2026 年 9 月 29 日）。这涵盖了订单表及其衍生表（例如 `order_line_items`、`transactions`、`refunds`、`fulfillments`、`order_risks`）以及 `abbanded_checkouts`。产品、客户、库存和草稿订单不受此限制。
    • 访问令牌有效期为 24 小时。代理程序会自动根据客户端 ID 和客户端密钥请求新的令牌；您无需复制或续订令牌。
    • Shopify 根据店铺套餐限制 API 读取次数：标准套餐每秒 100 点，高级套餐每秒 200 点，Shopify Plus 套餐每秒 1000 点，Shopify 企业版套餐每秒 2000 点；单次请求的费用不得超过 1000 点。大型店铺首次完整加载可能需要一些时间；当 Shopify 进行限速时，代理程序会等待并继续执行。
    • 只有当商店使用 Shopify Payments 时，付款和争议才会显示记录。

    步骤已于2026年10月8日核实。来源： shopify.dev/docs/apps/build/dev-dashboard/create-apps-usi…, shopify.dev/docs/apps/build/authentication-authorization/…, shopify.dev/docs/apps/build/authentication-authorization/…, shopify.dev/docs/apps/build/authentication-authorization/…, shopify.dev/docs/api/usage/access-scopes, shopify.dev/docs/apps/build/apis/graphql-admin/rate-limits, shopify.dev/docs/apps/launch/protected-customer-data, help.shopify.com/en/manual/apps/install-setup-apps, help.shopify.com/en/manual/apps/about-apps, help.shopify.com/en/manual/domains, changelog.shopify.com/posts/legacy-custom-apps-can-t-be-c…, kb.wolfandbadger.com/creating-your-custom-shopify-app-usi…, docs.mydbsync.com/cloud-workflow/connectors/shopify/steps…, help.sarasanalytics.com/pulse-shopify-/shopify-app-creati….

    连接名称
    任何你以后会记住的名称，例如销售数据库。
    商店网址
    您的 Shopify 商店地址，例如 your-store.myshopify.com。
    客户ID
    您在 Shopify 中为您的商店创建的自定义应用程序的客户端 ID。
    客户端密钥
    该 Shopify 应用的客户密钥。

    点击 测试连接当它读到 已连接， 点击 节省连接会在几秒钟内到达您的代理。

    开放数据代理

    测试失败？ 通常是由于缺少权限，或者使用了错误的 Shopify 帐户凭据。上面的步骤详解列出了…… 常见问题 以及他们的解决方案。

  4. See your data in Query Builder 选修的

    You can look at your Shopify 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. 把你的第一张桌子拉过来

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

    输入要运行的查询语句。以下查询语句会从数据库中提取几列数据。 shopify.orders 桌子：

    示例 · SQL
    SELECT name, financial_status, total_price, created_at FROM shopify.orders 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 中运行。
  • 添加筛选器 例如日期范围，这样同一个查询就可以回答“本月”而无需编辑。
  • 分享结果 与同事一起操作。他们看到的是行，而不是你的凭证。

人们提出的问题

我的 Shopify 账户必须安装在我使用 Sheets 的电脑上吗？

不，只有代理需要与你的 Shopify 账户位于同一位置。Google Sheets 可以在任何设备的浏览器中运行。使用同一个 Google 账户打开插件，你的连接就自动连接上了。

我的数据会被复制到查询流吗？

不。代理程序会运行查询，找到您的数据，然后只发送返回的行。中间不会进行任何同步或存储操作。

免费套餐真的包含这些吗？

是的。“免费”是一个永久有效的方案，而不是会过期的试用期。请查看具体包含内容。 定价页面.

表格会自动刷新吗？

如需获取最新行，请再次单击“运行查询”。要设置工作表自动刷新（无需用户手动操作），请在“查询流”门户（“流”→“自动化”）中设置自动化。此功能在所有套餐中均有提供。

还是不行？ 打开 支持 请在“查询流”中告诉我们您当前处于第几步以及您看到的内容。我们会帮您连接。
创建您的免费计划帐户查看免费内容包含哪些项目
查询流也将相同的数据连接到在 ExcelClaude、Cursor 和 ChatGPTREST API以及更多

每份指南 Shopify

Setup trouble?

  • Agent shows Offline, or Test connection and Browse are greyed out? Check that the Agent is online → Is the Agent online?
更新 10 月 17, 2026
谷歌表单

您的感觉是什么

  • Happy
  • 常规
  • Sad

Powered by BetterDocs