Konten filtern, auf die Sie Zugriff haben

Mit der Merchant Accounts API können Sie eine gefilterte Liste der Konten aufrufen auf die Sie Zugriff haben, einschließlich Unterkonten. Sie können nach Anzeigenamen und Beziehungen zu anderen Konten. Beispielsweise können Sie nach Konten filtern, deren Anzeigenamen die folgenden Zeichen enthalten: "store" die auch den Linkstatus PENDING haben, um alle Ihre die eine Anfrage zur Kontoverknüpfung noch nicht akzeptiert haben.

Wenn Sie alle Ihre Unterkonten sehen möchten, rufen Sie accounts.v1beta.accounts.listSubAccounts

So rufen Sie eine gefilterte Liste aller Konten auf, auf die Sie Zugriff haben: Unterkonten und alle Konten, bei denen Sie als User, Anruf accounts.v1beta.accounts.list und geben Sie Ihre Filterkriterien im Feld filter an.

Ausführliche Informationen zur Syntax für das Feld filter finden Sie unter Filtersyntax Referenz.

Sie können folgende Arten von Filtern verwenden:

Kontofilter

Sie können die folgenden Felder verwenden, um auf account-Ebene zu filtern:

• accountName: Filtert nach accountName der Ressource account.
• relationship(...): Filtert nach der Art der Beziehung des Kontos. mit einem anderen Konto. Sie können mehrere relationship(...)-Filter hinzufügen in einer Anfrage.

Beziehungsfilter

Mit der Funktion relationship(...) können Sie nach Folgendem filtern: Kriterien:

• providerId: Die Händler-ID des Dienstanbieters. Wenn zum Beispiel der Parameter Der Filter soll nur Konten zurückgeben, die einen Dienst von account/123, providerId = 123 verwenden.
• callerHasAccessToProviderFilter(): Filter für Konten mit Beziehung zu einem Dienstanbieter, auf den Sie Zugriff haben.
• externalAccountId: Die externe Konto-ID des Dienstanbieters für die für das er einen Dienst bereitstellt.
• accountIdAlias: Der Konto-ID-Alias, der für die Beziehung.
• service(...): Der Dienst, der im Rahmen der Beziehung bereitgestellt wird. Sie können mehrere service(...)-Funktionen in einer relationship(...)-Funktion verwenden. .

Dienstfilter

Mit der Funktion service(...) können Sie Konten weiter filtern basierend auf dem Status ihrer Beziehungen und die Arten von Dienstleistungen, die durch diese Beziehungen entstehen Folgendes angeben:

• handshakeState: Der Status einer Servicevereinbarung zwischen zwei Konten. Akzeptiert die folgenden Werte: <ph type="x-smartling-placeholder">
  </ph>
  • PENDING
  • APPROVED
• type: Die vom Anbieter angegebene Art der Dienstleistung. Akzeptiert Folgendes Werte: <ph type="x-smartling-placeholder">
  </ph>
  • ACCOUNT_MANAGEMENT Das Konto wird vom Anbieter verwaltet.
  • ACCOUNT_AGGREGATION Der Anbieter ist ein Aggregator des Kontos.

Beispiele

Hier sind einige Beispiele für Filter, die Sie ausprobieren können.

Nach Konten filtern, deren Anzeigenamen das Wort „store“ enthalten und Anbietern mit ID „123“:

accountName = "*store*" AND relationship(providerId = 123)

Nach allen Unterkonten des Kontos "123" filtern:

relationship(providerId = 123 AND service(type = "ACCOUNT_AGGREGATION"))

Nach Konten mit genehmigten Kontoverwaltungsdiensten filtern:

relationship(service(handshakeState = "APPROVED" AND type = "ACCOUNT_MANAGEMENT"))

Sie können nach Konten mit einem bestimmten Alias und einer bestimmten ID filtern, die Zugriff auf einen Anbieter haben. Für diese Anfrage benötigen Sie außerdem Zugriff auf den Anbieter:

relationship(callerHasAccessToProviderFilter() AND externalAccountId = "extAcctId" AND accountIdAlias = "alias")

Nächste Schritte

• Weitere Informationen zum Filtern von Konten finden Sie unter Filter Syntax.