प्रॉडक्ट खाते लिंक करना

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

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

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

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

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

इस स्थिति में, इन तरीकों का इस्तेमाल किया जाता है:

स्थिति कार्रवाई टिप्पणियां
पहली स्थिति न्योता बनाना न्योता बनाने के लिए, ProductLinkInvitationService.CreateProductLinkInvitation तरीके का इस्तेमाल करें. ProductLinkInvitation के status को सेट नहीं किया जाना चाहिए. एपीआई कॉल पूरा होने पर, Google Ads API सर्वर इसे REQUESTED पर सेट कर देगा.
न्योते की स्थिति देखना 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 ग्राहक के पास यह कार्रवाई करने की अनुमति नहीं है.
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 में हुए बदलाव

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

  • GoogleAdsIdentifier
  • MerchantCenterIdentifier
  • AdvertisingPartnerIdentifier

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