获取 Social 套餐限额和用量

返回您的 Social 套餐允许的额度，以及您已使用的额度。请在签发连接链接之前读取这些信息，以便在客户没有剩余额度时告知他们，而不是在写入失败后显示 SY95042。

usage.connections 恰好等于 usage.connectionsActive + usage.connectionsReleased。

已释放的名额会保留至周期结束

断开渠道连接会使其立即离线，但不会归还名额。在一个计费周期内，上限计算的是您使用过的不同连接数，无论这些连接是否仍处于连接状态，因此名额会一直被占用，直到订阅续订。代码中应考虑以下 3 点影响：

• 剩余额度为 maxConnections - usage.connections，绝不是 maxConnections - usage.connectionsActive。使用活跃连接数计算会让客户误以为仍有额度，而下一次请求连接链接时将返回 SY95042。
• 将同一账号重新连接到同一品牌是免费的。如果客户重新连接了本周期内先前从该品牌断开的主页，则会复用其已占用的名额：connectionsActive 增加，connectionsReleased 减少，而 connections 保持不变。将同一主页关联到另一个品牌会占用一个单独的名额，而原名额仍会保留至续订。
• connectionsReleased 是您的续订预测值。它恰好表示进入下一个周期时归还到共享池的名额数，应向正在决定是等待续订还是立即购买连接包的客户展示此值。

这与计费模型的其余部分遵循相同的规则：您购买的容量立即可用，而您放弃的容量在周期结束时移除。请参阅套餐和附加项。

使用场景：在您的开通流程中预先检查。在向客户显示“连接账号”按钮之前，请将 usage.connections（计费连接数，而非 connectionsActive）与 maxConnections 比较。如果没有剩余额度，请向他们展示购买附加项或升级的途径，而不是让 POST /social/brands/{brandId}/connections/link 失败。品牌无需类似检查：使用 POST /social/brands 创建品牌时，永远不会遇到额度不足的情况。

使用场景：确定下一次购买的附加项数量。连接包以每包 5 个连接的形式出售，因此 maxConnections - usage.connections 直接表示您还可以连接多少个社交网络，而 ceil((needed - headroom) / 5) 表示需要购买多少个连接包。

注意事项。

• 品牌不设数量上限，也不计量。对于 listingsAPI 账户，brands 返回 null。之前将其视为整数上限的客户端代码必须处理 null，并且不应显示“剩余 0 个品牌”。
• 连接是同一账户内共享的资源池，而不是按品牌分配的额度。只要共享池仍有额度，一个品牌就可以按需建立连接，最多可连接其支持的 5 个社交网络。请参阅套餐和附加项。
• 此端点仅涵盖 Social 订阅。地点上限属于 Listings 订阅，由 POST /locations 单独执行；当账户完全没有 Listings 套餐时，该端点返回 SY10155。
• 自助服务账户的连接上限为 250 个，无论购买多少连接包都不例外。若需超过此上限，账户必须迁移至 Enterprise。
• 有剩余容量并不保证能连接 Instagram。Instagram 仅允许连接已关联 Facebook 主页的商业账号或创作者账号；个人账号会在 Meta 的授权页面被拒绝，而不是被此上限阻止。如果客户在此处仍有额度，但请求 Instagram 的连接链接仍然失败，则需要转换账号类型，而不是增加容量。
• 这些数字实时更新，但释放连接并不意味着退款。使用 disconnect 断开连接或归档品牌后，下次读取时就会在此处体现为 usage.connectionsActive 减少，usage.connectionsReleased 相应增加。usage.connections 保持不变，因为名额会保留至周期结束。两种释放途径的行为完全相同。