Google Ads API की मदद से, Google Ads खातों को अन्य प्रॉडक्ट खातों से लिंक किया जा सकता है. इस गाइड में, एपीआई का इस्तेमाल करके खातों को लिंक करने का तरीका बताया गया है.
खाते लिंक करने के तरीके
Google Ads खाते को किसी दूसरे प्रॉडक्ट खाते से लिंक करने के दो अलग-अलग तरीके हैं.
न्योता भेजने का फ़्लो
न्योता भेजने के तरीके का इस्तेमाल तब करें, जब आपके पास Google Ads खाते का एडमिन ऐक्सेस हो, लेकिन प्रॉडक्ट खाते का एडमिन ऐक्सेस न हो. यह फ़्लो दो स्थितियों में काम करता है:
- आपको दोनों खातों को लिंक करना है और प्रॉडक्ट खाते के एडमिन के लिए न्योता बनाना है. प्रॉडक्ट खाते का एडमिन, खाता लिंक करने की प्रोसेस को पूरा करने के लिए न्योता स्वीकार करता है.
- प्रॉडक्ट खाते का एडमिन, दोनों खातों को लिंक करना चाहता है, लेकिन उसके पास Google Ads खाते का ऐक्सेस नहीं है. प्रॉडक्ट खाते का एडमिन, न्योता भेजता है. इसके बाद, आपको न्योता स्वीकार करना होता है और खाता जोड़ने की प्रोसेस पूरी करनी होती है.
इस स्थिति में, इन तरीकों का इस्तेमाल करें:
| स्थिति | कार्रवाई | टिप्पणियां |
|---|---|---|
| पहली स्थिति | न्योता बनाना | न्योता बनाने के लिए,
ProductLinkInvitationService.CreateProductLinkInvitation तरीके
का इस्तेमाल करें.
ProductLinkInvitation के status को सेट नहीं किया जाना चाहिए. एपीआई कॉल के पूरा होने पर, Google Ads API सर्वर इसे REQUESTED पर सेट कर देगा. किसी विज्ञापन पार्टनर (AdvertisingPartnerLinkInvitationIdentifier) के लिए न्योता बनाते समय, v25 से advertising_partner_properties.allowed_domain ज़रूरी है. हालांकि, v24 और इससे पहले के वर्शन में यह ज़रूरी नहीं है. |
| न्योते का स्टेटस देखना | product_link_invitation
संसाधन के बारे में क्वेरी करने और उसका स्टेटस देखने के लिए, GoogleAdsService.Search
या GoogleAdsService.SearchStream
का इस्तेमाल करें. |
|
| दूसरी स्थिति | न्योता वापस पाना | product_link_invitation
संसाधन के बारे में क्वेरी करने के लिए, GoogleAdsService.Search
या GoogleAdsService.SearchStream
का इस्तेमाल करें. मंज़ूरी बाकी वाले न्योते को स्वीकार या अस्वीकार करने के लिए,
status = PENDING_APPROVAL को फ़िल्टर करें. |
| न्योता स्वीकार या अस्वीकार करना |
ProductLinkInvitation की स्थिति को ACCEPTED या REJECTED पर अपडेट करने के लिए,
ProductLinkInvitationService.UpdateProductLinkInvitation तरीके का इस्तेमाल करें. |
|
| न्योता वापस लेना | किसी मौजूदा
ProductLinkInvitation को रद्द करने के लिए,
ProductLinkInvitationService.RemoveProductLinkInvitation तरीके का इस्तेमाल करें. |
इस वर्कफ़्लो में ये सामान्य गड़बड़ियां हो सकती हैं:
| गड़बड़ी का कोड | स्पष्टीकरण |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
ग्राहक के पास यह कार्रवाई करने की अनुमति नहीं है. |
ProductLinkInvitationError.NO_INVITATION_REQUIRED |
न्योता नहीं भेजा जा सका, क्योंकि उपयोगकर्ता के पास पहले से ही न्योता पाने वाले खाते का एडमिन ऐक्सेस है. उपयोगकर्ता को ProductLinkService का इस्तेमाल करके, सीधे तौर पर एक ऐक्टिव लिंक बनाना चाहिए. |
डायरेक्ट लिंकिंग फ़्लो
अगर आपके पास Google Ads खाते और प्रॉडक्ट खाते, दोनों का एडमिन ऐक्सेस है, तो सीधे लिंक करने की प्रोसेस का इस्तेमाल करें. ऐसे में, न्योता भेजने के बजाय Google Ads खाते को सीधे प्रॉडक्ट खाते से लिंक करें.
इस स्थिति में, इन तरीकों का इस्तेमाल करें:
| कार्रवाई | टिप्पणियां |
|---|---|
| ऐक्टिव लिंक बनाना | ProductLink बनाने के लिए,
ProductLinkService.CreateProductLink का इस्तेमाल करें. |
| किसी चालू लिंक को बंद करना | किसी चालू ProductLink को हटाने के लिए,
ProductLinkService.RemoveProductLink का इस्तेमाल करें. |
| ऐक्टिव लिंक वापस पाना |
product_link संसाधन के बारे में क्वेरी करने के लिए,
GoogleAdsService.Search या
GoogleAdsService.SearchStream
का इस्तेमाल करें. |
इस वर्कफ़्लो में, ये सामान्य गड़बड़ियां हो सकती हैं:
| गड़बड़ी का कोड | स्पष्टीकरण |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
डायरेक्ट लिंक फ़्लो का इस्तेमाल करके, खाता लिंक करने की कोशिश की गई. हालांकि, अनुमतियां न होने की वजह से ऐसा नहीं किया जा सका. इसके बजाय, उपयोगकर्ता को न्योता भेजने के लिए,
ProductLinkInvitationService
का इस्तेमाल करना चाहिए.
|
ProductLinkError.INVITATION_EXISTS |
लिंक नहीं बनाया जा सकता, क्योंकि पहले से ही एक न्योता भेजा जा चुका है. |
मौजूदा प्रॉडक्ट के लिंक वापस पाना
product_link रिसॉर्स के लिए GAQL क्वेरी का इस्तेमाल करके, अपने Google Ads खाते से जुड़े सभी प्रॉडक्ट लिंक वापस पाए जा सकते हैं.
SELECT
product_link.product_link_id,
product_link.type
FROM product_link
product_link.type फ़ील्ड से, लिंक किए गए प्रॉडक्ट या सेवा के टाइप का पता चलता है.
type के आधार पर, product_link रिसॉर्स के अन्य फ़ील्ड अपने-आप भर जाएंगे. इससे लिंक के बारे में ज़्यादा जानकारी मिलेगी. उदाहरण के लिए, अगर टाइप DATA_PARTNER है, तो data_partner फ़ील्ड में लिंक किए गए डेटा पार्टनर खाते की जानकारी होगी.
इससे आपको सीधे अपने Google Ads खाते से लिंक की गई बाहरी सेवाओं और प्रॉडक्ट खातों की सूची मिलती है. जैसे, Merchant Center, Google Ads, विज्ञापन पार्टनर या डेटा पार्टनर.
AccountLinkService में बदलाव
अगर Google Ads खाते को किसी दूसरे प्रॉडक्ट खाते से लिंक करने के लिए AccountLinkService का इस्तेमाल किया जाता है, तो आपको अपने मौजूदा ऐप्लिकेशन को पहले बताए गए वर्कफ़्लो में से किसी एक पर माइग्रेट करना होगा. यहां दिए गए लिंक टाइप के लिए, AccountLinkService से माइग्रेट करें और ProductLinkService का इस्तेमाल करें:
ThirdPartyAppAnalyticsLinkIdentifier के लिए, AccountLinkService का इस्तेमाल जारी रखें.