शॉपिंग पार्टनर और अलग-अलग व्यापारी/कंपनी/कारोबारी के खातों के बीच, एक-दूसरे के खातों से कई ऐसे लिंक हो सकते हैं जिन्हें फ़्लैग किया गया हो.
listlinks
तरीका, एपीआई कॉल करने वाले Merchant Center खाते के लिए, इन सभी लिंक की सूची दिखाता है. इसके लिए किसी पैरामीटर की ज़रूरत नहीं होती और इसे एचटीटीपी GET
अनुरोध का इस्तेमाल करके शुरू किया जाता है.
सेवा की स्थिति
लिंक की सूची बनाते समय, जवाबों में हर लिंक के हर service
के लिए एक status
दिखेगा. व्यापारियों/कंपनियों/कारोबारियों के पास, सूची में दी गई सभी सेवाओं को स्वीकार करने या अनुरोध में बताई गई सेवाओं में से सिर्फ़ कुछ को स्वीकार करने का विकल्प होता है.
सेवाएं pending
स्टेटस में तब तक शुरू होती हैं, जब तक कि कारोबारी की ओर से साफ़ तौर पर अनुमति नहीं मिल जाती. अनुमति मिलने के बाद, सेवाओं का स्टेटस active
हो जाता है.
हटाई गई सेवाओं का स्टेटस inactive
दिखेगा. ऐसा तब होगा, जब pending
या active
वाली अन्य सेवाएं भी मौजूद हों. किसी लिंक में शामिल सभी सेवाएं हटाने के बाद, listlinks
तरीके से लिंक नहीं मिलेगा.
अनुरोध का उदाहरण
पार्टनर 123456789
से मिले, खाता लिंक करने के अनुरोध की सूची देखने के लिए, listlinks
तरीके का इस्तेमाल करके, बिना किसी पैरामीटर के GET
अनुरोध भेजें.
GET https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/listlinks
जवाब का उदाहरण
इस उदाहरण में, व्यापारी/कंपनी/कारोबारी 98765
ने अब तक अनुरोध को स्वीकार नहीं किया है. इसलिए, अलग-अलग सेवाओं का स्टेटस pending
है.
{
"linkedAccountId": "98765",
"services": [
{
"service": "shoppingAdsProductManagement",
"status": "pending"
},
{
"service": "shoppingActionsOrderManagement",
"status": "pending"
}
]
}
अगले सेक्शन में, खाते को लिंक करने के अनुरोध को स्वीकार करने का तरीका बताया गया है.