प्रॉडक्ट खाते जोड़ना

Google Ads API की मदद से, Google Ads खातों को अन्य प्रॉडक्ट खातों से लिंक किया जा सकता है. इस गाइड में, खातों को लिंक करने के लिए एपीआई का इस्तेमाल करने का तरीका बताया गया है.

Google Ads खाते को किसी अन्य प्रॉडक्ट खाते से लिंक करने के दो अलग-अलग तरीके हैं.

न्योता भेजने का तरीका

न्योता भेजने के तरीके का इस्तेमाल तब करें, जब आपके पास Google Ads खाते का एडमिन ऐक्सेस हो, लेकिन प्रॉडक्ट खाते का एडमिन ऐक्सेस न हो. यह तरीका दो स्थितियों में काम करता है:

  1. आपको दोनों खातों को लिंक करना है और प्रॉडक्ट खाते के एडमिन के लिए एक न्योता बनाना है. खाते को लिंक करने की प्रोसेस पूरी करने के लिए, प्रॉडक्ट खाते का एडमिन न्योता स्वीकार करता है.
  2. प्रॉडक्ट खाते का एडमिन, दोनों खातों को लिंक करना चाहता है, लेकिन उसके पास Google Ads खाते का ऐक्सेस नहीं है. प्रॉडक्ट खाते का एडमिन एक न्योता बनाता है. इसके बाद, आपको न्योता स्वीकार करना होगा और लिंक करने की प्रोसेस पूरी करनी होगी.

इस स्थिति में, ये तरीके अपनाएं:

स्थिति कार्रवाई Remarks
पहली स्थिति कोई न्योता बनाएं कोई न्योता बनाने के लिए, ProductLinkInvitationService.CreateProductLinkInvitation तरीके का इस्तेमाल करें. status का ProductLinkInvitation सेट नहीं किया जाना चाहिए. 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 खाते को सीधे प्रॉडक्ट खाते से लिंक करें.

इस स्थिति में, ये तरीके अपनाएं:

कार्रवाई Remarks
कोई चालू लिंक बनाना कोई ProductLink बनाने के लिए, ProductLinkService.CreateProductLink का इस्तेमाल करें.
कोई चालू लिंक बंद करना कोई चालू ProductLinkService.RemoveProductLink हटाने के लिए, ProductLink का इस्तेमाल करें.
चालू लिंक वापस पाना 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 का इस्तेमाल जारी रखें.