Reseller API 概览

Google 向用户提供 Google 产品服务的方式之一是通过服务分销渠道，例如 Google Workspace 授权转销商。使用 Reseller API 时，务必要了解转销商与客户、付款方案、产品 SKU 和许可之间的概念关系。

转销商

转销商从 Google 购买用户许可，然后将这些许可转售给 Google 客户。转销商可以直接管理客户订阅，也可以在自定义多项服务时与服务集成商合作来管理客户。

转销商可以选择以下方案：

  • 年度合约：转销商从 Google 购买固定数量的许可，期限为一年。客户可以创建的许可数量上限为许可数量，但经销商需要为订购的许可数量付费。如果客户需要更多许可，经销商可以使用 subscriptions.changeSeats API 调用来增加订购的许可数量。
  • 灵活：每次客户创建新用户时，Google 都会向转销商收取相应许可的费用。经销商与 Google 之间的合同中会说明价格、规格和许可数量上限。

除了管理用户许可之外，转销商（或其合作伙伴服务集成商）还可为客户提供广泛的附加服务，例如培训、促销、广告、定价、部署自定义、问题排查和维护。

许可

许可可让拥有 Google 账号的用户访问 Google Workspace 服务。客户为用户分配许可后，该许可即会变为有效许可。在计算客户的总用户数时，系统只会统计有效许可。

客户

Google 客户首先需要拥有由经销商配置的 Google Workspace 账号。在设置客户的账号时，经销商会提供主域名、备用电子邮件地址和实际地址。然后，转销商还会为客户可用的每个产品 SKU 创建订阅。客户托管每个单独的用户账号。如需了解详情，请参阅订购新的客户账号。

方案

方案定义了转销商与 Google 之间的结算条款。这些方案不定义转销商与其客户之间的结算关系。经销商可自行与客户确定结算条款。

Reseller API 支持 Google Workspace 按月后付费系统，该系统提供多种付款方案：

  • ANNUAL_MONTHLY_PAY：包年合约，按月付款
  • ANNUAL_YEARLY_PAY：包年，每年付款一次
  • FLEXIBLE：按月付款的无合约方案
  • TRIAL：免费试用方案
    • 试用期长短不一，最长为 30 天。
    • 每位用户的每日 Gmail 发信上限为 500 封。
  • FREE：仅适用于 Cloud Identity 免费版订阅的免费方案

如需详细了解这些方案，请参阅为客户选择付款方案。

订阅

订阅用于管理 Google 客户的付款方案与产品 SKU、用户许可、30 天免费试用状态和续订选项之间的关系。转销商的主要角色是管理 Google 客户的订阅。

在 Reseller API 中，订阅是一项主要 API 资源。它定义了付款方案、许可、30 天免费试用、续订和转销商的采购订单的相关设置。客户可以拥有多个订阅，每个订阅对应于转销商分配给客户的相应产品 SKU。

每项订阅都有一个唯一标识符，即 subscriptionId。由于 subscriptionId 会在订阅发生变化时发生变化，因此请勿将 subscriptionId 值用作持久性数据的键。如果订阅发生变化，此密钥将失效。

如需了解详情，请参阅管理订阅。

产品和产品 SKU

产品是指一组专门的 Google 服务和应用功能组成的商业产品。产品可以有自定义的条款、价格和其他协议详细信息。每个产品版本都由产品 SKU 标识。在此版本中，Reseller API 为 Google Workspace、Google 保险柜和 Google 云端硬盘产品中的每个 SKU 提供订阅。如需了解详情，请参阅产品和 SKU。