自定义应用

自定义应用是您或开发者专门为您的 Shopify 商店开发的应用（与公共应用不同，公共应用是为很多商店构建的）。使用自定义应用，您可以在 Shopify 后台内添加功能、使用 Shopify API 直接访问商店数据或者使用店面 API 将在线商店扩展至其他平台。

备注

此页面介绍如何在 Shopify 后台中创建自定义应用并对其进行身份验证（无论您是店主还是具有合作者账户或员工账户的开发者）。如果您是开发者，则可以阅读自定义应用的开发者文档来详细了解自定义应用。

创建自定义应用需要开发知识并且可能具有难度。如果您需要为商店创建自定义应用方面的帮助，那么您可以聘请 Shopify 合作伙伴。详细了解如何聘请 Shopify 合作伙伴。

如果您希望让合作者账户或员工账户来创建、编辑或删除自定义应用，可以向其授予开发应用权限。合作者账户或员工账户还必须具有相关权限才能设置某些 API 范围。

自定义 2 级 PII 应用

权限用于控制应用为执行其功能可以访问或修改的商店信息类型。

个人身份信息 (PII) 是单独或组合的信息，可以唯一地识别个人。从 Shopify App Store 安装的应用在使用有关您的商店、客户、订单或其他业务数据的信息时可以访问不同类型的 PII。若要访问自定义 2 级 PII 应用，您的商店必须使用 Shopify 套餐或更高级的套餐。

注意

如果您注册 Basic Shopify 套餐或 Shopify Starter 套餐或降级到这些套餐，则将无法访问 Custom Level 2 Personally Identifiable Information (PII) 应用。

从 Shopify 后台激活自定义应用开发

您需要先激活自定义应用开发，然后才能为您的商店创建自定义应用。您需要是店主或是拥有启用应用开发权限的员工才能激活自定义应用开发。

步骤：

1. 在 Shopify 后台中，转到设置 > 应用和销售渠道。

2. 点击开发应用。

3. 点击允许自定义应用开发。

4. 阅读提供的警告和信息，然后点击允许自定义应用开发。

创建和安装自定义应用

激活自定义应用开发后，您可以在 Shopify 后台中创建和安装自定义应用。您需要设置 API 范围，以确定自定义应用可以访问商店的哪些部分。安装应用后，您将收到访问令牌，应用将使用这些访问令牌通过 Shopify API 访问商店信息。

店主以及具有相关权限的合作者和员工可以创建和安装自定义应用。

提示:

如果您需要为商店创建自定义应用方面的帮助，那么您可以聘请 Shopify 合作伙伴。详细了解如何聘请 Shopify 合作伙伴。

创建应用

1. 在 Shopify 后台中，转到设置 > 应用和销售渠道。

2. 点击开发应用。

3. 点击创建自定义应用。

4. 在模态窗口中，输入应用名称并选择应用开发人员。应用开发人员可以是店主，也可以是具有开发应用权限的任何员工或合作者账户。

5. 点击创建应用。

选择 API 范围

创建自定义应用后，您可以为其分配 API 范围。自定义应用可以具有 Admin API 范围和/或 Storefront API 范围，具体取决于应用的要求。在安装应用之前，您至少需要选择一个范围。

注意

Storefront API 是未经身份验证的公共 API，也就是说，您商店的任何访客都能看到您向该应用公开的所有数据。只有可以接受这样的风险，您才应使用 Storefront API，并且您只应授予专有应用所需数据类型的访问权限。

步骤：

1. 点击选择范围。

2. 在后台 API 访问范围部分中，选择向应用分配的 API 范围。

   1. 可选：设置要用于 Webhook 订阅的 API 版本。
   2. 可选：您可以设置 Google Cloud Pub/Sub 来处理应用的 Webhook 订阅。在 Google Cloud Pub/Sub 部分中，复制您的 Shopify 服务账户地址，并使用它来配置您的 Google Cloud Pub/Sub 账户。
   3. 可选：您可以设置 Amazon EventBridge 来处理应用的 Webhook 订阅。在 Amazon EventBridge 部分中，点击创建源。

3. 在店面 API 访问范围部分中，选择要向应用分配的 API 范围。

4. 点击保存。

安装应用并获取 API 访问令牌

为应用设置 API 范围后，就可以安装应用。安装后，您将获得 API 访问令牌。根据您分配给应用的 API 范围，您将获得后台 API 访问令牌和/或店面 API 访问令牌。

注意

Admin API 访问令牌只会显示一次，因为该令牌可为 API 提供敏感商店数据的访问权限。在访问令牌显示后，请在安全的地方写下或记录该令牌，以便您可以再次参考它。

请将令牌视为密码。只能与您信任的开发人员分享访问令牌。

步骤：

1. 点击安装应用。
2. 在模态窗口中，点击安装应用。
3. 获取访问令牌：
   • 如果您为应用选择了 Admin API 范围，请转到 Admin API 访问令牌部分，然后点击显示一次令牌。此页面将在首次被访问时显示完整访问令牌，在受到后续访问时，此页面将仅显示访问令牌的后 4 位数以供参考。
   • 如果您为应用选择了店面 API 范围，则可以转到店面 API 访问令牌部分并复制令牌。与后台 API 访问令牌不同，店面 API 访问令牌始终显示在此页面上。

获取自定义应用的 API 凭据

您可以在应用的 API 凭据页面查看自定义应用的店面访问令牌、API 密钥和 API 加密密钥。您还可以查看 Admin API 访问令牌，但在首次访问该页面并看到该令牌后，您只能查看该令牌的后四位数。

备注

API 加密密钥与共享加密密钥相同。如果开发人员请求提供共享加密密钥，请提供您的 API 加密密钥。请务必仅与信任的开发人员共享您的 API 加密密钥。

1. 在 Shopify 后台中，转到设置 > 应用和销售渠道。

2. 点击开发应用。

3. 点击您要获取凭据的应用的名称。

4. 点击 API 凭据。

更新自定义应用的 Admin API 范围

如果您是店主或是具有相关权限的合作者或员工，您可以更新自定义应用的范围。

1. 在 Shopify 后台中，转到设置 > 应用和销售渠道。

2. 点击开发应用。

3. 点击您要更新的应用的名称。

4. 点击配置。

5. 在后台 API 集成部分中，点击编辑。

   • 如果您之前没有分配任何后台 API 范围，请点击配置。

6. 选择要分配给应用的范围。

7. 可选：设置要用于 Webhook 订阅的 API 版本。

8. 可选：您可以设置 Google Cloud Pub/Sub 来处理应用的 Webhook 订阅。在 Google Cloud Pub/Sub 部分中，复制您的 Shopify 服务账户地址，并使用它来配置您的 Google Cloud Pub/Sub 账户。

9. 可选：您可以设置 Amazon EventBridge 来处理应用的 Webhook 订阅。在 Amazon EventBridge 部分中，点击创建源。

10. 点击保存。

如果商店中安装了该应用，那么除非至少选择了一个范围，或者为应用分配了店面 API 范围，否则无法点击保存。

更新自定义应用的 Storefront API 访问范围

注意

Storefront API 是未经身份验证的公共 API，也就是说，您商店的任何访客都能看到您向该应用公开的所有数据。只有可以接受这样的风险，您才应使用 Storefront API，并且您只应授予专有应用所需数据类型的访问权限。

如果您是店主或是具有相关权限的合作者或员工，您可以更新自定义应用的范围。

1. 在 Shopify 后台中，转到设置 > 应用和销售渠道。

2. 点击开发应用。

3. 点击您要更新的应用的名称。

4. 点击配置。

5. 在店面 API 集成部分中，点击编辑。

   • 如果您之前没有分配任何店面 API 范围，请点击配置。

6. 选择要分配给应用的范围。

7. 可选：如果您的应用集成了 iOS Buy 软件开发套件 (SDK)，则您可在 iOS Buy SDK 部分中进行任何必要的更改。如果已安装应用，那么您只能在此部分中进行更改。

   • 有关详细信息，请参阅 iOS Buy SDK 开发者文档。

8. 可选：如果您的应用集成了 Android Buy SDK，那么您可以在 Android Buy SDK 部分中进行任何必要的更改。如果已安装应用，那么您只能在此部分中进行更改。

   • 有关详细信息，请参阅 Android Buy SDK 开发人员文档。

9. 点击保存。

如果商店中安装了该应用，那么除非至少选择了一个范围，或者为应用分配了店面 API 范围，否则无法点击保存。

更新自定义应用的设置

您可以更新应用的名称、描述以及应用开发者。

如果您将应用开发者设置为员工或合作者账户，然后删除该账户，则默认情况下，店主将成为应用开发者。

1. 在 Shopify 后台中，转到设置 > 应用和销售渠道。

2. 点击开发应用。

3. 点击您要更新的应用的名称。

4. 点击应用设置。

5. 若要更改名称或描述，请输入新的应用名称或应用描述。

6. 若要更改与应用关联的应用开发者，请选择主要应用开发者。

7. 可选：若要向其他邮箱发送关于此应用的开发更新通知，请在开发更新联系人下输入邮箱。

8. 点击保存。

卸载自定义应用

卸载自定义应用时，您的 Admin API 和 Storefront API 访问令牌将被撤销，在该应用下注册的任何 Webhook 和发货服务也将被删除，并且您的应用将无法访问商店数据。如果您重新安装该应用，您将获得新的访问令牌。

1. 在 Shopify 后台中，转到设置 > 应用和销售渠道。

2. 点击开发应用。

3. 点击您要卸载的应用的名称。

4. 点击卸载应用。

删除自定义应用

删除自定义应用后便无法恢复。如果您想暂时停用商店上的应用而不将其删除，请改为卸载应用。

1. 在 Shopify 后台中，转到设置 > 应用和销售渠道。

2. 点击开发应用。

3. 点击应用设置。

4. 点击删除应用。

自定义应用的 API 范围权限

只有当账户拥有开发应用权限以及与所设置的 API 范围相关的任何其他员工权限时，合作者账户和员工账户才能为自定义应用设置 API 范围。

您应咨询应用的开发人员，以确定自定义应用需要哪些账户权限和 API 范围才能正常工作。请确保您了解并熟悉您向开发人员授予的权限。