Google Ads API की मदद से, Google Ads खातों को अन्य प्रॉडक्ट खातों से लिंक किया जा सकता है. इस गाइड में, खातों को लिंक करने के लिए एपीआई का इस्तेमाल करने का तरीका बताया गया है.
खाते लिंक करने के तरीके
Google Ads खाते को किसी दूसरे प्रॉडक्ट खाते से लिंक करने के दो अलग-अलग तरीके हैं.
न्योता भेजने का फ़्लो
अगर आपके पास Google Ads खाते का एडमिन ऐक्सेस है, लेकिन प्रॉडक्ट खाते का एडमिन ऐक्सेस नहीं है, तो न्योता भेजने की सुविधा का इस्तेमाल करें. यह फ़्लो दो स्थितियों में काम करता है:
- आपको दोनों खातों को लिंक करना है और प्रॉडक्ट खाते के एडमिन के लिए न्योता बनाना है. प्रॉडक्ट खाते का एडमिन, खाता लिंक करने की प्रोसेस पूरी करने के लिए न्योता स्वीकार करता है.
- प्रॉडक्ट खाते का एडमिन, दोनों खातों को लिंक करना चाहता है, लेकिन उसके पास Google Ads खाते का ऐक्सेस नहीं है. प्रॉडक्ट खाते का एडमिन, न्योता बनाता है. इसके बाद, आपको न्योता स्वीकार करना होता है और खाता लिंक करने की प्रोसेस पूरी करनी होती है.
इस स्थिति में, इन तरीकों का इस्तेमाल करें:
| स्थिति | कार्रवाई | टिप्पणियां |
|---|---|---|
| पहली स्थिति | न्योता बनाना | न्योता बनाने के लिए,
ProductLinkInvitationService.CreateProductLinkInvitation तरीके का इस्तेमाल करें. status
की
ProductLinkInvitation वैल्यू सेट नहीं होनी चाहिए. एपीआई कॉल पूरा होने के बाद, Google Ads API सर्वर इसे REQUESTED पर सेट कर देगा. विज्ञापन पार्टनर (AdvertisingPartnerLinkInvitationIdentifier) के लिए न्योता बनाते समय, advertising_partner_properties.allowed_domain का इस्तेमाल करना ज़रूरी है. यह v25 से लागू होगा. हालांकि, v24 और इससे पहले के वर्शन में इसका इस्तेमाल करना ज़रूरी नहीं है. |
| न्योते का स्टेटस देखना | product_link_invitation
संसाधन से क्वेरी करने और उसका स्टेटस देखने के लिए, GoogleAdsService.Search
या GoogleAdsService.SearchStream
का इस्तेमाल करें. |
|
| दूसरी स्थिति | न्योता वापस पाना | product_link_invitation
संसाधन के बारे में क्वेरी करने के लिए, GoogleAdsService.Search
या GoogleAdsService.SearchStream
का इस्तेमाल करें.
status = PENDING_APPROVAL के लिए फ़िल्टर करें, ताकि
मंज़ूरी बाकी वाले न्योते को स्वीकार या अस्वीकार किया जा सके. |
| न्योता स्वीकार या अस्वीकार करना |
ProductLinkInvitationService.UpdateProductLinkInvitation तरीके का इस्तेमाल करके,
ProductLinkInvitation के स्टेटस को ACCEPTED या
REJECTED पर अपडेट करें. |
|
| न्योता वापस लेना | मौजूदा
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 |
लिंक नहीं बनाया जा सकता, क्योंकि पहले से ही एक न्योता भेजा जा चुका है. |
मौजूदा प्रॉडक्ट लिंक वापस पाना
अपने Google Ads खाते से जुड़े सभी प्रॉडक्ट लिंक को वापस पाने के लिए, product_link संसाधन के ख़िलाफ़ GAQL क्वेरी का इस्तेमाल करें.
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 का इस्तेमाल जारी रखें.