กรองบัญชีที่คุณเข้าถึงได้

คุณใช้ Merchant Accounts API เพื่อดูรายการที่กรองแล้วของบัญชีได้ ที่คุณมีสิทธิ์เข้าถึง รวมถึงบัญชีย่อยด้วย คุณสามารถกรองตามชื่อที่แสดง และ ความสัมพันธ์กับบัญชีอื่นๆ ตัวอย่างเช่น คุณอาจกรองบัญชีที่มีชื่อที่แสดงซึ่งมี สตริง "store" ซึ่งมีสถานะลิงก์ PENDING ด้วยเพื่อดู ร้านค้าที่ยังไม่ได้ยอมรับคำขอลิงก์บัญชี

หากต้องการดูบัญชีย่อยทั้งหมดของคุณ โปรดโทร accounts.v1beta.accounts.listSubAccounts

หากต้องการดูรายการที่กรองของบัญชีทั้งหมดที่คุณมีสิทธิ์เข้าถึง รวมถึง บัญชีย่อยและบัญชีอื่นๆ ที่มีคุณเป็น User โทร accounts.v1beta.accounts.list และระบุเกณฑ์ตัวกรองในช่อง filter

โปรดดูรายละเอียดเกี่ยวกับไวยากรณ์ของช่อง filter ที่ไวยากรณ์ของตัวกรอง ข้อมูลอ้างอิง

ประเภทของตัวกรองที่คุณสามารถใช้ได้มีดังนี้

ตัวกรองบัญชี

คุณสามารถใช้ฟิลด์ต่อไปนี้เพื่อกรองที่ระดับ account ได้

• accountName: กรองตาม accountName จากแหล่งข้อมูล account
• relationship(...): กรองตามประเภทความสัมพันธ์ที่บัญชีมี ด้วยบัญชีอื่น คุณรวมตัวกรอง relationship(...) ได้หลายรายการ ในคำขอเดียว

ตัวกรองความสัมพันธ์

คุณใช้ฟังก์ชัน relationship(...) เพื่อกรองตามข้อมูลต่อไปนี้ได้ เกณฑ์:

• providerId: รหัสผู้ขายของผู้ให้บริการ ตัวอย่างเช่น หาก ตัวกรองควรแสดงเฉพาะบัญชีที่มีการบริการจาก account/123 ใช้ providerId = 123
• callerHasAccessToProviderFilter(): ตัวกรองสำหรับบัญชีที่มี ที่เกี่ยวข้องกับผู้ให้บริการที่คุณมีสิทธิ์เข้าถึง
• externalAccountId: รหัสบัญชีภายนอกของผู้ให้บริการสำหรับ ที่มีการให้บริการ
• accountIdAlias: ชื่อแทนรหัสบัญชีที่กำหนดค่าสำหรับ ความสัมพันธ์
• service(...): บริการที่มีให้เป็นส่วนหนึ่งของความสัมพันธ์ คุณสามารถรวม service(...) หลายฟังก์ชันไว้ใน relationship(...) เดียว

ตัวกรองบริการ

คุณสามารถใช้ฟังก์ชัน service(...) เพื่อกรองบัญชีเพิ่มเติมตาม สถานะความสัมพันธ์ และประเภทของบริการที่มีความสัมพันธ์เหล่านั้น ระบุ:

• handshakeState: สถานะของข้อตกลงในการให้บริการระหว่าง 2 บัญชี ยอมรับค่าต่อไปนี้
  • PENDING
  • APPROVED
• type: ประเภทบริการที่ระบุโดยผู้ให้บริการ ยอมรับรายการต่อไปนี้ มีดังนี้
  • ACCOUNT_MANAGEMENT ผู้ให้บริการเป็นผู้จัดการบัญชี
  • ACCOUNT_AGGREGATION ผู้ให้บริการเป็นผู้รวบรวมข้อมูลบัญชี

ตัวอย่าง

ตัวอย่างตัวกรองที่คุณลองใช้ได้มีดังนี้

กรองบัญชีที่มีชื่อที่แสดงที่มีคำว่า "ร้านค้า" และผู้ให้บริการที่มี รหัส "123":

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

กรองบัญชีย่อยทั้งหมดของบัญชี "123":

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

กรองหาบัญชีที่มีบริการจัดการบัญชีที่ได้รับอนุมัติ ดังนี้

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

กรองบัญชีที่มีชื่อแทนและรหัสที่เฉพาะเจาะจงซึ่งมีสิทธิ์เข้าถึงผู้ให้บริการ คุณต้องมีสิทธิ์เข้าถึงผู้ให้บริการสำหรับคำขอนี้ด้วย

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

ขั้นตอนถัดไป

• สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการกรองบัญชี โปรดดูที่ตัวกรอง ไวยากรณ์