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

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

खाते लिंक करने के तरीके

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

न्योता भेजने का फ़्लो

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

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

इस उदाहरण में, इन तरीकों का इस्तेमाल किया गया है:

स्थिति	कार्रवाई	टिप्पणियां
पहली स्थिति	न्योता बनाना	न्योता बनाने के लिए, ProductLinkInvitationService.CreateProductLinkInvitation तरीके का इस्तेमाल करें. ProductLinkInvitation का status सेट नहीं किया जाना चाहिए. एपीआई कॉल पूरा होने के बाद, Google Ads API सर्वर इसे REQUESTED पर सेट कर देगा.
	न्योते का स्टेटस देखना	GoogleAdsService.Search या GoogleAdsService.SearchStream का इस्तेमाल करके, product_link_invitation संसाधन से क्वेरी करें और उसकी स्थिति की जांच करें.
दूसरी स्थिति	न्योता वापस पाना	product_link_invitation संसाधन के बारे में क्वेरी करने के लिए, GoogleAdsService.Search या GoogleAdsService.SearchStream का इस्तेमाल करें. status = PENDING_APPROVAL के लिए फ़िल्टर करें, ताकि मंज़ूरी बाकी वाले न्योते को स्वीकार या अस्वीकार किया जा सके.
	न्योता स्वीकार या अस्वीकार करना	ProductLinkInvitationService.UpdateProductLinkInvitation तरीके का इस्तेमाल करके, ProductLinkInvitation की स्थिति को ACCEPTED या REJECTED पर अपडेट करें.
	न्योता वापस लेना	मौजूदा ProductLinkInvitation को रद्द करने के लिए, ProductLinkInvitationService.RemoveProductLinkInvitation तरीके का इस्तेमाल करें.

इस वर्कफ़्लो में, ये सामान्य गड़बड़ियां हो सकती हैं:

गड़बड़ी का कोड	जानकारी
ProductLinkInvitationError.PERMISSION_DENIED	ग्राहक के पास यह कार्रवाई करने की अनुमति नहीं है.
ProductLinkError.NO_INVITATION_REQUIRED	न्योता नहीं भेजा जा सका, क्योंकि उपयोगकर्ता के पास पहले से ही न्योता पाए गए खाते का एडमिन ऐक्सेस है. उपयोगकर्ता को ProductLinkService का इस्तेमाल करके, सीधे तौर पर चालू लिंक बनाना चाहिए.

सीधे तौर पर लिंक करने का फ़्लो

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

इस उदाहरण में, इन तरीकों का इस्तेमाल किया गया है:

कार्रवाई	टिप्पणियां
चालू लिंक बनाना	ProductLink बनाने के लिए, ProductLinkService.createProductLink का इस्तेमाल करें.
चालू लिंक बंद करना	किसी चालू ProductLink को हटाने के लिए, ProductLinkService.removeProductLink का इस्तेमाल करें.
चालू लिंक वापस पाना	GoogleAdsService.Search या GoogleAdsService.SearchStream का इस्तेमाल करके, product_link संसाधन के बारे में क्वेरी करें.

इस वर्कफ़्लो में, ये सामान्य गड़बड़ियां दिख सकती हैं:

गड़बड़ी का कोड	जानकारी
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 रिसॉर्स में मौजूद अन्य फ़ील्ड भर जाएंगे. इससे लिंक के बारे में ज़्यादा जानकारी मिलेगी. उदाहरण के लिए, अगर टाइप THIRD_PARTY_APP_ANALYTICS है, तो third_party_app_analytics फ़ील्ड में, आंकड़ों की सेवा देने वाली कंपनी के बारे में जानकारी होगी.

इससे आपको उन बाहरी सेवाओं और ऐप्लिकेशन की सूची मिलती है जो सीधे तौर पर आपके Google Ads खाते से लिंक हैं. जैसे, Google Play, डेटा पार्टनर या तीसरे पक्ष के ऐप्लिकेशन के आंकड़ों से जुड़े प्लैटफ़ॉर्म.

AccountLinkService में किए गए बदलाव

अगर आपको AccountLinkService का इस्तेमाल करके, Google Ads खाते को किसी दूसरे प्रॉडक्ट खाते से लिंक करना है, तो आपको अपने मौजूदा ऐप्लिकेशन को पहले बताए गए किसी एक वर्कफ़्लो पर माइग्रेट करना होगा. नीचे दिए गए लिंक टाइप के लिए, AccountLinkService से माइग्रेट करें और ProductLinkService का इस्तेमाल करें:

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

ThirdPartyAppAnalyticsLinkIdentifier के लिए, AccountLinkService का इस्तेमाल जारी रखें.