篩選您可以存取的帳戶

你可以使用 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")

後續步驟

  • 如需進一步瞭解如何篩選帳戶,請參閱篩選 語法