فلترة الحسابات التي يمكنك الوصول إليها

يمكنك استخدام 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: حالة اتفاقية خدمة بين حسابين. تقبل القيم التالية:
  • 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")

الخطوات التالية

• لمزيد من المعلومات عن فلترة الحسابات، اطّلِع على مقالة فلترة. البنية.