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

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

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

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

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

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

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

คุณใช้ช่องต่อไปนี้เพื่อกรองที่ระดับ account ได้

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

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

คุณใช้ฟังก์ชัน 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")

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

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