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

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 का इस्तेमाल जारी रखें.