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

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

पुष्टि करना

डेटा मैनेजर एपीआई के लिए, 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

संसाधन के नाम

डेटा मैनेजर एपीआई, 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 कोई मिलता-जुलता नहीं.

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