किसी कारोबारी या कंपनी के खाते के साथ संबंध दिखाने के लिए, शॉपिंग पार्टनर को सबसे पहले accounts.link तरीके का इस्तेमाल करके, खाता जोड़ने का अनुरोध भेजना होगा.
लिंक करने के अनुरोध में एक linkedAccountId शामिल होता है. इससे उस कारोबारी या कंपनी की पहचान होती है जिसे अनुरोध मिला है. साथ ही, इसमें request टाइप का action होता है. हर लिंक में services का एक सेट भी होना चाहिए. इससे यह पता चलता है कि पार्टनर, कारोबारी या कंपनी को कौनसी सुविधाएं देता है. ये services वैल्यू इस्तेमाल की जा सकती हैं.
| सेवा | ब्यौरा |
|---|---|
shoppingAdsProductManagement |
शॉपिंग विज्ञापनों के लिए प्रॉडक्ट डेटा का मैनेजमेंट |
shoppingActionsProductManagement |
'Google पर खरीदें' (पहले इसे Shopping Actions के नाम से जाना जाता था) के लिए प्रॉडक्ट डेटा का मैनेजमेंट |
shoppingActionsOrderManagement |
'Google पर खरीदें' (पहले इसे Shopping Actions के नाम से जाना जाता था) के लिए ऑर्डर मैनेज करना |
इसके अलावा, अनुरोध में एक मान्य linkType भी शामिल होना चाहिए. इससे यह पता चलता है कि अनुरोध करने वाला शॉपिंग पार्टनर किस तरह का है. शॉपिंग पार्टनर को इनमें से कोई एक लेबल असाइन किया जाता है. उन्हें एपीआई कॉल करते समय, linkType फ़ील्ड में असाइन किया गया लेबल इस्तेमाल करना चाहिए.
| मान्य linkTypes |
|---|
channelPartner |
eCommercePlatform |
उदाहरण
नीचे दिया गया एपीआई कॉल, पार्टनर के खाते 123456789 से "98765" के linkedAccountId वाले कारोबारी या कंपनी को लिंक करने का अनुरोध भेजता है.
"eCommercePlatform" linkType से पता चलता है कि पार्टनर एक ई-कॉमर्स प्लैटफ़ॉर्म है. services सूची से पता चलता है कि पार्टनर, "shoppingAdsProductManagement" (शॉपिंग विज्ञापनों के लिए प्रॉडक्ट डेटा मैनेजमेंट) और "shoppingActionsOrderManagement" ('Google पर खरीदें' के लिए ऑर्डर मैनेजमेंट, जिसे पहले Shopping Actions के नाम से जाना जाता था) सुविधाएं उपलब्ध कराता है.
POST https://shoppingcontent.googleapis.com/content/v2.1/123456789/accounts/123456789/link
{
"linkedAccountId": "98765",
"linkType": "eCommercePlatform",
"services": ["shoppingAdsProductManagement", "shoppingActionsOrderManagement"],
"action": "request"
}
अगले सेक्शन में, मौजूदा लिंक की सूची पाने का तरीका बताया गया है.