जिन खातों का ऐक्सेस आपके पास है उनकी फ़िल्टर की गई सूची देखने के लिए, Merchant Account API का इस्तेमाल किया जा सकता है. इसमें उप-खाते भी शामिल हैं. दूसरे खातों के डिसप्ले नेम और
संबंधों के हिसाब से फ़िल्टर किया जा सकता है.
उदाहरण के लिए, "store"
स्ट्रिंग वाले डिसप्ले नेम वाले उन खातों को फ़िल्टर किया जा सकता है जिनमें PENDING
लिंक का स्टेटस भी होता है. ऐसा करके, अपने उन सभी स्टोर को देखा जा सकता है जिन्होंने अब तक खाता लिंक करने का अनुरोध स्वीकार नहीं किया है.
अपने सभी उप-खाते देखने के लिए, accounts.v1beta.accounts.listSubAccounts
पर कॉल करें.
आपके पास जिन खातों का ऐक्सेस है उनकी फ़िल्टर की गई सूची देखने के लिए,
accounts.v1beta.accounts.list
को कॉल करें और filter
फ़ील्ड में फ़िल्टर की शर्तें तय करें. इनमें वे उप-खाते और खाते भी शामिल हैं जिनके पास आप User
हैं.
filter
फ़ील्ड के सिंटैक्स के बारे में जानने के लिए, फ़िल्टर सिंटैक्स का रेफ़रंस देखें.
यहां इस तरह के फ़िल्टर इस्तेमाल किए जा सकते हैं:
खाते के फ़िल्टर
account
लेवल पर फ़िल्टर करने के लिए, इन फ़ील्ड का इस्तेमाल किया जा सकता है:
accountName
:account
संसाधन केaccountName
के मुताबिक फ़िल्टर.relationship(...)
: किसी दूसरे खाते के साथ खाते का किस तरह का संबंध है, इसके हिसाब से फ़िल्टर किया जाता है. एक अनुरोध में एक से ज़्यादाrelationship(...)
फ़िल्टर शामिल किए जा सकते हैं.
संबंध से जुड़े फ़िल्टर
इन शर्तों के आधार पर फ़िल्टर करने के लिए, relationship(...)
फ़ंक्शन का इस्तेमाल किया जा सकता है:
providerId
: सेवा देने वाले का मर्चेंट आईडी. उदाहरण के लिए, अगर फ़िल्टर सिर्फ़ वे खाते दिखाना चाहिए जिनमेंaccount/123
से मिली सेवा मौजूद है, तोproviderId = 123
का इस्तेमाल करें.callerHasAccessToProviderFilter()
: उन खातों के लिए फ़िल्टर जिनका ऐक्सेस आपके पास, सेवा देने वाली किसी कंपनी के साथ है.externalAccountId
: सेवा देने वाली कंपनी के उस खाते का बाहरी खाता आईडी जिस पर वह सेवा देती है.accountIdAlias:
संबंध के लिए कॉन्फ़िगर किया गया खाता आईडी का दूसरा नाम.service(...)
: कारोबारी संबंध के तहत दी जाने वाली सेवा. एकrelationship(...)
फ़ंक्शन में कईservice(...)
फ़ंक्शन शामिल किए जा सकते हैं.
सेवा फ़िल्टर
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")
आगे क्या करना है
- खातों को फ़िल्टर करने के बारे में ज़्यादा जानकारी के लिए, फ़िल्टर सिंटैक्स देखें.