你可以使用 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
:服務供應商的外部帳戶 ID 帳戶提供服務accountIdAlias:
為 關係service(...)
:在關係中提供的服務。 您可以在一個relationship(...)
中加入多個service(...)
函式 函式。
服務篩選器
您可以使用 service(...)
函式,根據下列條件進一步篩選帳戶:
關係的狀態,以及這些關係的服務類型
提供:
handshakeState
:兩個帳戶之間的服務合約狀態。 可接受的值如下:PENDING
APPROVED
type:
提供者提供的服務類型。接受下列類型 值: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")
後續步驟
- 如需進一步瞭解如何篩選帳戶,請參閱篩選 語法