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

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 संसाधन से क्वेरी करें और उसके स्टेटस की जांच करें.
दूसरी स्थिति	न्योता वापस पाना	GoogleAdsService.Search या GoogleAdsService.SearchStream का इस्तेमाल करके, product_link_invitation संसाधन के बारे में क्वेरी करें. 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 का इस्तेमाल करें.
चालू लिंक वापस पाना	product_link संसाधन के बारे में क्वेरी करने के लिए, GoogleAdsService.Search या GoogleAdsService.SearchStream का इस्तेमाल करें.

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

गड़बड़ी का कोड	जानकारी
ProductLinkError.CREATION_NOT_PERMITTED	डायरेक्ट लिंक फ़्लो का इस्तेमाल करके, खाता लिंक करने की कोशिश की गई थी. हालांकि, अनुमतियां न होने की वजह से, ऐसा नहीं किया जा सका. इसके बजाय, उपयोगकर्ता को न्योता भेजने के लिए ProductLinkInvitationService का इस्तेमाल करना चाहिए.
ProductLinkError.INVITATION_EXISTS	लिंक नहीं बनाया जा सकता, क्योंकि न्योता पहले से ही भेजा जा चुका है.

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

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

• GoogleAdsIdentifier
• MerchantCenterIdentifier
• AdvertisingPartnerIdentifier

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