套餐和附加项

Listings 和 Social 的套餐等级、各等级包含的内容、每种附加项的价格、按比例计费的方式，以及限制自助服务账户进一步扩展的上限。

Listings API 提供 2 款产品。Listings 管理商家地点及其在目录中的商家信息。Social 管理品牌，并向其社交账号发布内容。这两款产品分别定价、分别计费，并各自设有上限。

Listings

Listings 的套餐等级根据您可拥有的地点数量定价。

套餐中的每个地点均可使用完整的目录网络、评价管理、帖子和分析功能。套餐等级决定您可拥有的地点数量和请求配额，并不影响您可以调用哪些端点。

Social

Social 的套餐等级根据您可拥有的连接数量定价。一个连接是指通过连接链接关联到某个品牌在某个网络上的一个社交账号，例如 Facebook 公共主页、Instagram Business 账号、X 账号、LinkedIn 组织或 Pinterest 看板。

所有套餐等级的品牌数量均不限，且不按品牌数量计费。品牌只是一个容器，其下包含已连接账户以及通过这些账户发布的帖子；创建品牌不产生费用，也绝不会因达到数量上限而被拒绝。POST /social/brands在 API 套餐中没有品牌数量限制。

您购买的是连接数。由于支持 5 个网络，一个连接了所有网络的品牌会占用 5 个连接，因此，20 个连接大致可供 4 个品牌连接所有网络，125 个连接则大致可供 25 个品牌使用，但并不要求您这样分配。您可以将 125 个连接分配给 60 个品牌，让每个品牌连接 2 个网络，也可以将这些连接集中用于少数几个品牌。

附加项

附加项采用公开定价，可随时购买，无需更换套餐等级。

连接包可叠加。连接包按数量购买，因此，2 个包每月 $50，可增加 10 个连接；3 个包每月 $75，可增加 15 个连接，以此类推。没有按品牌提供的附加项，也无法单独购买 1 个连接：必须以 5 个为单位购买。连接包不区分类型：它会向连接池中增加 5 个连接，由您决定将其分配给哪些网络和品牌。

连接构成整个账户共用的连接池

连接不按品牌分配。您的套餐等级与连接包共同构成整个账户共用的连接池，任何品牌都可以使用其中的连接额度：

maxConnections = tier connections + (5 × connection packs)

使用 Social Growth 并购买 2 个连接包时，账户共有 125 + 10 = 135 个可用连接，其中一个品牌可以占用 12 个，另一个品牌占用 1 个。每个品牌没有单独的连接上限，只有连接池的总量限制。

连接名额一旦使用，就会在整个计费周期内被占用，而不只是在连接期间被占用。 连接池按账户在当前周期内使用过的不同连接计量，因此断开渠道连接会使其立即离线，但其名额仍被占用，直到下一个计费周期开始。此规则与账户中其他所有用量缩减所遵循的规则相同，参见按比例计费，这意味着连接池名额无法在同一周期内循环使用：连接 20 个后再全部断开，已用名额仍为 20 个，直到续订时才会释放。

由此可得出两点。将同一个社交账号重新关联到同一个品牌是免费的，因为这会复用该账号在该品牌下已占用的名额。一个名额归属于一个品牌与账号的组合，因此将同一个账号关联到另一个品牌会占用第 2 个名额，而第 1 个名额仍会被占用，直到下一个周期开始。此外，购买连接包是在周期中途增加容量的唯一方式，因为附加项会立即收费并生效，而已释放的名额则要等到下一个周期开始时才会恢复可用。

GET /social/limits 会报告完整情况：

剩余额度为 maxConnections - usage.connections。连接池额度耗尽时，连接链接端点会返回 SY95042，这就是为什么开发者刚断开多个社交账号的连接后，仍可能被拒绝连接。在 API 套餐中，创建品牌不会因类似限制而失败。

自助服务上限

无论购买多少附加项，都有以下 2 个硬性上限：

• 自助服务 Listings 账户最多可有 100 个地点。
• 自助服务 Social 账户最多可有 250 个连接。

品牌数量没有上限：品牌数量不限，只要这些品牌使用的连接总数不超出连接池额度，账户就可以拥有任意数量的品牌。

超出任一上限时，账户都必须升级到 Enterprise，其上限需协商确定，请联系销售团队，而不是继续购买连接包。完全没有 Listings 套餐的账户无法创建地点，并会收到 SY10155；Social 的对应情况是没有 Social 订阅，此时所有 /social/* 端点均不可用。

添加第 2 款产品

已拥有一款产品的账户可以通过控制台购买另一款产品，无需联系销售团队，也无需创建新账户。每款产品都有独立的订阅、续订日期和取消订阅安排，与分别购买时完全相同。

每款产品都有独立的免费试用。 对于您从未拥有过的产品，其 Launch 等级提供 14 天免费试用，即使您已经是另一款产品的付费客户，也同样适用。Listings Growth 客户添加 Social Launch 后，可获得 Social 独立的 14 天免费试用及独立的续订日期，其 Listings 计费则照常继续，不受影响。反过来，Social 客户添加 Listings Launch 时也同样如此。

所有高于 Launch 的等级都会在购买当天收费，而两款产品的 Enterprise 都需要与我们商定服务范围，无法通过自助方式购买。

每款产品只能试用一次。 如果您已经试用过某款产品，再次购买该产品时会立即收费，同一款产品不会有第 2 次免费期。在订阅仍处于试用期时购买附加项，会结束该试用并开始付费计费，控制台会在此操作生效前向您确认。

按比例计费

附加项会立即收费。购买额外地点或连接包后会立即生效，并当场按当前计费周期剩余时间的比例开具账单。您无需等到下一个周期，就能使用刚购买的容量。

缩减在计费周期结束时生效。您放弃的任何项目都不会退还本周期剩余时间的费用，也不会在周期结束前释放容量。这条规则适用于这两种产品的所有缩减操作：

因此，释放连接名额的行为与取消附加项完全相同：在周期结束时生效，而不是在调用 API 时生效。等待期间，该名额会在 GET /social/limits 中显示为 usage.connectionsReleased，供您预估将返还的容量。

这种不对称性是刻意设计的：您始终可以立即扩容，并且仅为实际使用的部分付费，同时也不会失去已付费的容量，或在同一周期内重复使用该容量。

90 天存续期规则

地点或品牌必须在创建满 90 天后才能归档。POST /locations/archive 和 POST /social/brands/archive 都会执行此规则；品牌端点会返回 status: "TENURE_NOT_MET"，并附带 SY95051。

之所以有这条规则，是因为归档是缩减订阅的方式，否则，在同一周期内创建并归档的资源就不会产生任何费用。这条规则有一个值得在设计时考虑的实际影响：误建的品牌或地点在 90 天内无法移除。请在创建前先校验输入。

满足存续期要求后，不同产品的处理方式有所不同：

• 品牌会立即归档，但其连接名额不会立即返还。品牌及其关联的所有连接会在同一次请求中归档并立即下线；随后，每个连接名额都会保留至计费周期结束，与直接断开连接的处理方式完全相同。下次读取 GET /social/limits 时，会显示 usage.connectionsActive 的减少和 usage.connectionsReleased 的相应增加，而用于计费的 usage.connections 在续订前保持不变。归档本身没有待执行状态，也没有可取消的操作。
• 地点的归档会安排在计费周期结束时执行。在周期结束前，地点会保持上线并继续占用您的 Listings 配额，您也可以在此之前通过 取消地点归档 撤销该决定。

查看您的限额

请在创建前检查相关配额，而不是在失败后再检查：这样，您就可以向客户展示升级途径，而不是错误代码。