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

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

• ऑब्जेक्ट फ़ील्ड मैपिंग में, पार्टनर लिंक ऑब्जेक्ट को दिखाने वाले संसाधन के लिए फ़ील्ड मैपिंग होती हैं.
• लिंक मैनेज करने के अनुरोधों की मैपिंग में, पार्टनर लिंक बनाने और मिटाने के अनुरोधों के लिए फ़ील्ड मैपिंग होती है.
• लिंक वापस पाने के अनुरोध की मैपिंग में, पार्टनर के लिंक वापस पाने के लिए फ़ील्ड मैपिंग होती हैं.

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

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

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 में, ProductLink के resource_name का customer_id यह दिखाता है कि मौजूदा लिंक का मालिकाना हक किस खाते के पास है. ProductLink बनाते समय, आपको लिंक के मालिक की जानकारी देनी होती है. इसके लिए, आपको CreateProductLinkRequest का customer_id सेट करना होता है. Data Manager API में, owning_account के accountType और accountId के कॉम्बिनेशन से पता चलता है कि मौजूदा लिंक का मालिकाना हक किस खाते के पास है. 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

SearchPartnerLinkRequest भेजें. 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 अनुरोध का filter बनाने और अलग-अलग स्थितियों के लिए अनुरोध हेडर सेट करने का तरीका भी बताया गया है.SearchPartnerLinksRequest