您可以使用 Merchant Accounts API 查看经过过滤的账号列表
包括子账号。您可以按显示名进行过滤
关系。
例如,您可以过滤出显示名称中包含
关联状态为 PENDING
的字符串 "store"
,可查看您的所有
商店。
要查看所有子账号,请调用
accounts.v1beta.accounts.listSubAccounts
。
如需查看您有权访问的所有账号的过滤后列表,包括
子账号以及以您身份的任何账号
User
,通话
accounts.v1beta.accounts.list
并在 filter
字段中指定过滤条件。
要详细了解 filter
字段的语法,请参阅过滤器语法
参考文档。
以下是您可以使用的过滤器类型:
账号过滤条件
您可以使用以下字段在 account
级别进行过滤:
accountName
:按account
资源的accountName
进行过滤。relationship(...)
:按与账号相关联的关系类型进行过滤 使用另一个账号。您可以添加多个relationship(...)
过滤条件 提交一个请求
关系过滤器
您可以使用 relationship(...)
函数根据以下信息进行过滤
条件:
providerId
:服务提供商的商家 ID。例如,如果 过滤器应仅返回由account/123
,请使用providerId = 123
。callerHasAccessToProviderFilter()
:此过滤条件适用于具有以下政策的账号: 您有权与其访问的服务提供商建立关系。externalAccountId
: 向其提供服务的账号accountIdAlias:
。为 关系。service(...)
:作为关系的一部分提供的服务。 您可以在一个relationship(...)
中包含多个service(...)
函数 函数。
服务过滤条件
您可以使用 service(...)
函数,根据
关系状态,以及这些关系提供的服务类型
提供:
handshakeState
:两个账号之间的服务协议的状态。 接受以下值: <ph type="x-smartling-placeholder">- </ph>
PENDING
APPROVED
type:
:提供商提供的服务类型。接受以下付款方式 值: <ph type="x-smartling-placeholder">- </ph>
ACCOUNT_MANAGEMENT
:账号由提供方管理。ACCOUNT_AGGREGATION
该提供商是账号的集合商家。
示例
以下是一些您可以尝试的过滤条件示例。
过滤出显示名称包含“store”的账号具有 ID“123”:
accountName = "*store*" AND relationship(providerId = 123)
过滤出账号“123”的所有子账号:
relationship(providerId = 123 AND service(type = "ACCOUNT_AGGREGATION"))
过滤出提供已批准的账号管理服务的账号:
relationship(service(handshakeState = "APPROVED" AND type = "ACCOUNT_MANAGEMENT"))
过滤出具有特定别名和 ID 且有权访问提供商的账号。 您还必须有权访问此请求的提供方:
relationship(callerHasAccessToProviderFilter() AND externalAccountId = "extAcctId" AND accountIdAlias = "alias")
后续步骤
- 有关过滤账号的详情,请参阅过滤 语法。