액세스 권한이 있는 계정 필터링

판매자 계정 API를 사용하여 필터링된 계정 목록을 볼 수 있습니다. 액세스 권한이 있는 모든 계정, 즉 하위 계정을 포함합니다. 표시 이름별로 필터링할 수 있습니다. 관계 예를 들어 표시 이름에 PENDING 링크 상태도 있는 "store" 문자열로, 모든 아직 계정 연결 요청을 수락하지 않은 매장

모든 하위 계정을 보려면 accounts.v1beta.accounts.listSubAccounts

다음을 포함하여 액세스할 수 있는 모든 계정의 필터링된 목록을 보는 방법 하위 계정 및 User, 호출 accounts.v1beta.accounts.list filter 필드에서 필터 기준을 지정합니다.

filter 필드의 구문에 대한 자세한 내용은 필터 문법을 참고하세요. 참조

사용할 수 있는 필터의 종류는 다음과 같습니다.

계정 필터

다음 필드를 사용하여 account 수준에서 필터링할 수 있습니다.

  • accountName: account 리소스의 accountName를 기준으로 필터링합니다.
  • relationship(...): 계정의 관계 유형을 기준으로 필터링합니다. 다른 계정과 연결할 수 있습니다. 여러 relationship(...) 필터를 포함할 수 있습니다. 요청할 수 있습니다

관계 필터

relationship(...) 함수를 사용하여 다음을 기준으로 필터링할 수 있습니다. 기준:

  • providerId: 서비스 제공업체의 판매자 ID입니다. 예를 들어 필터는 Google에서 제공하는 서비스가 있는 계정만 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 제공업체가 계정의 애그리게이터입니다.

다음과 같은 필터를 사용해 볼 수 있습니다.

표시 이름에 '매장'이 포함된 계정을 위한 필터링 및 제공업체와 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")

다음 단계

  • 계정 필터링에 대한 자세한 내용은 필터링 구문을 사용합니다.