फ़ील्ड मैपिंग

Google Ads API से Data Manager API पर, पार्टनर लिंक के वर्कफ़्लो के हर चरण को अपग्रेड करने के लिए, फ़ील्ड मैपिंग का इस्तेमाल करें:

पुष्टि करना

Data Manager API के लिए, Google Ads API के मुकाबले अलग स्कोप वाले क्रेडेंशियल की ज़रूरत होती है. आपको नए क्रेडेंशियल जनरेट करने होंगे. इनमें पार्टनर लिंक मैनेज करने के लिए, Data Manager API का स्कोप शामिल होना चाहिए.

ऑब्जेक्ट फ़ील्ड मैपिंग

टेबल में दी गई मैपिंग का इस्तेमाल करके, टेबल में दी गई मैपिंग का इस्तेमाल करके, ProductLink को Google Ads API में मौजूद उसके PartnerLink equivalent in the Data Manager API.

ProductLink (Google Ads API) PartnerLink (Data Manager API) नोट
  • advertising_partner
  • data_partner
  • google_ads
  • merchant_center
partner_account Data Manager API में, लिंक किए गए हर तरह के खाते के लिए अलग-अलग फ़ील्ड नहीं होते सभी तरह के खातों के लिए, partner_account फ़ील्ड को ProductAccount पर सेट करें. साथ ही, लिंक किए गए खाते की पहचान करने के लिए, इसके account_type और account_id को सेट करें.
product_link_id partner_link_id
resource_name name

Google Ads API में, customer_id के resource_name का ProductLink यह दिखाता है कि मौजूदा लिंक का मालिक कौन सा खाता है. जब आप ProductLink, बनाते हैं, तो customer_id का CreateProductLinkRequest सेट करके, लिंक के मालिक की जानकारी दी जाती है.

Data Manager API में, accountType और accountId का owning_account का कॉम्बिनेशन यह दिखाता है कि कौन सा खाता मौजूदा लिंक का मालिक है. जब आप PartnerLink बनाते हैं, तो मालिक के संसाधन का नाम name पर सेट करके, लिंक के मालिक की जानकारी दी जाती है.

ज़्यादा जानकारी के लिए, संसाधन के नाम और अनुरोध करें देखें.

type owning_account.account_type

संसाधन के नाम

Data Manager API, Google Ads API के मुकाबले अलग फ़ॉर्मैट में संसाधन के नाम का इस्तेमाल करता है.

Google Ads API

Google Ads API में, ProductLink के संसाधन के नाम के लिए इस फ़ॉर्मैट का इस्तेमाल किया जाता है:

customers/{customer_id}/productLinks/{product_link_id}

Data Manager API

Data Manager API में, PartnerLink के संसाधन के नाम के लिए इस फ़ॉर्मैट का इस्तेमाल किया जाता है:

accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

लिंक मैनेजमेंट के अनुरोध की मैपिंग

पार्टनर लिंक बनाने, मिटाने, और वापस पाने के अनुरोधों को बदलने के लिए, इस सेक्शन में दिए गए अनुरोध की मैपिंग का इस्तेमाल करें.

अनुरोध करें

Google Ads API में मौजूद CreateProductLinkRequest को Data Manager API में मौजूद उसके बराबर वाले CreatePartnerLinkRequest में बदलने के लिए, यहां फ़ील्ड मैपिंग दी गई है.

CreateProductLinkRequest (Google Ads API) CreatePartnerLinkRequest (Data Manager API) नोट
customer_id parent विज्ञापन देने वाले उस खाते के संसाधन के नाम पर सेट करें जो लिंक का मालिक है.
product_link partner_link PartnerLink संसाधन पर सेट करें. ऑब्जेक्ट फ़ील्ड मैपिंग देखें

अनुरोध हटाएं

Google Ads API में मौजूद RemoveProductLinkRequest को Data Manager API में मौजूद उसके बराबर वाले DeletePartnerLinkRequest में बदलने के लिए, यहां फ़ील्ड मैपिंग दी गई है.

RemoveProductLinkRequest (Google Ads API) DeletePartnerLinkRequest (Data Manager API) नोट
customer_id इसके बराबर कोई फ़ील्ड नहीं है. name फ़ील्ड में, मालिक और पार्टनर के खाते की जानकारी शामिल होती है. इसलिए, इस अतिरिक्त फ़ील्ड की ज़रूरत नहीं होती.
resource_name name उस PartnerLink के संसाधन के नाम पर सेट करें जिसे आपको हटाना है.
validate_only इसके बराबर कोई फ़ील्ड नहीं है.

लिंक वापस पाने के अनुरोध की मैपिंग

Google Ads API और Data Manager API में, पार्टनर लिंक वापस पाने का तरीका अलग-अलग होता है.

Google Ads API

query वाला SearchGoogleAdsRequest भेजें. क्वेरी का वैकल्पिक WHERE क्लॉज़ यह तय करता है कि कौनसे संसाधन वापस पाने हैं. क्वेरी का SELECT क्लॉज़ यह तय करता है कि वापस पाए गए आंशिक संसाधनों में कौनसे फ़ील्ड भरने हैं.

SELECT
  product_link.product_link_id,
  ...
FROM product_link
WHERE
  ...
Data Manager API

SearchPartnerLinksRequest भेजें. अनुरोध का वैकल्पिक filter फ़ील्ड यह तय करता है कि कौनसे संसाधन वापस पाने हैं. जवाब में पूरे संसाधन शामिल होते हैं. इनमें सभी फ़ील्ड भरे होते हैं.

Google Ads API में मौजूद SearchGoogleAdsRequest को Data Manager API में मौजूद उसके बराबर वाले SearchPartnerLinksRequest में बदलने के लिए, यहां फ़ील्ड मैपिंग दी गई है.

SearchGoogleAdsRequest (Google Ads API) SearchPartnerLinksRequest (Data Manager API) नोट
customer_id parent खोजे जाने वाले खाते के संसाधन के नाम पर सेट करें.
page_size page_size
page_token page_token
query filter यह तय करने के लिए कि कौनसे संसाधन वापस पाने हैं, filter सेट करें. Data Manager API पूरे संसाधन दिखाता है. इसलिए, SELECT क्लॉज़ के बराबर कोई फ़ील्ड नहीं है.
search_settings इसके बराबर कोई फ़ील्ड नहीं है.
validate_only इसके बराबर कोई फ़ील्ड नहीं है.

ज़्यादा जानकारी के लिए, पार्टनर लिंक वापस पाना लेख पढ़ें. इसमें, filter अनुरोध का SearchPartnerLinksRequest बनाने का तरीका और अलग-अलग स्थितियों के लिए अनुरोध के हेडर सेट करने का तरीका शामिल है.