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

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

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 और MerchantCenterLinkService में बदलाव

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

लिंक का टाइप क्या यह नई सेवाओं में काम करती है? इस तारीख तक सहायता उपलब्ध है टिप्पणियां
DataPartnerIdentifier हां v15 MerchantCenterLinkService से बाहर माइग्रेट करें
GoogleAdsIdentifier हां v16 AccountLinkService को बंद करें
MerchantCenterIdentifier हां v16 AccountLinkService को बंद करें
AdvertisingPartnerIdentifier हां v16 AccountLinkService को बंद करें
ThirdPartyAppAnalyticsLinkIdentifier नहीं AccountLinkService का उपयोग जारी रखें