حساب هایی را که می توانید به آنها دسترسی داشته باشید فیلتر کنید

می‌توانید از 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 ارائه دهنده یک جمع کننده حساب است.

نمونه ها

در اینجا چند نمونه از فیلترهایی وجود دارد که می توانید امتحان کنید.

فیلتر برای حساب‌های دارای نام‌های نمایشی حاوی «store» و ارائه‌دهندگان با شناسه «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")

بعدش چی

• برای اطلاعات بیشتر درباره فیلتر کردن حساب‌ها، به نحو فیلتر مراجعه کنید.