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

टेबल में दी गई मैपिंग का इस्तेमाल करके, Display & Video 360 API में मौजूद कस्टमर मैच ऑडियंस मैनेजमेंट के तरीकों और फ़ील्ड को Data Manager API में मौजूद उनके बराबर के तरीकों और फ़ील्ड के साथ मैप करें.

तरीके की मैपिंग

नीचे दी गई टेबल में, Display & Video 360 API के तरीकों को Data Manager API के मिलते-जुलते तरीकों के साथ मैप किया गया है:

Display & Video 360 API के तरीके	Data Manager API के तरीके	नोट
firstPartyAndPartnerAudiences.get	userLists.get	डेटा मैनेजर API सिर्फ़ कस्टमर मैच ऑडियंस को वापस पा सकता है.
firstPartyAndPartnerAudiences.list	userLists.list	Data Manager API सिर्फ़ कस्टमर मैच ऑडियंस दिखाएगा.
firstPartyAndPartnerAudiences.create	userLists.create	उपयोगकर्ता के डेटा को Data Manager API में बाद के अनुरोध में अपलोड किया जाना चाहिए.
कोई मिलती-जुलती रिपोर्ट नहीं	userLists.delete	Display & Video 360 API में उपलब्ध नहीं है.
firstPartyAndPartnerAudiences.patch	userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers	audienceMembers.ingest	कस्टमर मैच ऑडियंस में सदस्यों को जोड़ने और हटाने के लिए, Data Manager API के अलग-अलग तरीकों का इस्तेमाल किया जाता है.
firstPartyAndPartnerAudiences.editCustomerMatchMembers	audienceMembers.remove	कस्टमर मैच ऑडियंस में सदस्यों को जोड़ने और हटाने के लिए, Data Manager API के अलग-अलग तरीकों का इस्तेमाल किया जाता है.

मैपिंग का अनुरोध करना

यहां दी गई टेबल में, Display & Video 360 API के तरीकों के अनुरोध फ़ील्ड को Data Manager API में उनके बराबर के फ़ील्ड के साथ मैप किया गया है.

userLists.get

firstPartyAndPartnerAudiences.get (Display & Video 360 API)	userLists.get (Data Manager API)	नोट
advertiserId partnerId firstPartyAndPartnerAudienceId	name	UserList नाम में, विज्ञापन देने वाले व्यक्ति या कंपनी या पार्टनर के पैरंट खाते का आईडी और ऑडियंस आईडी, दोनों शामिल होते हैं. ज़्यादा जानकारी के लिए, संसाधन के नाम देखें.

userLists.list

firstPartyAndPartnerAudiences.list (Display & Video 360 API)	userLists.list (Data Manager API)	नोट
advertiserId partnerId	parent	parent में विज्ञापन देने वाले व्यक्ति या कंपनी या पार्टनर का आईडी होता है.
pageSize	pageSize	Data Manager API में, पेज का ज़्यादा से ज़्यादा साइज़ 1000 होता है.
pageToken	pageToken
filter	filter
orderBy	कोई मिलती-जुलती रिपोर्ट नहीं

userLists.create

firstPartyAndPartnerAudiences.create (Display & Video 360 API)	userLists.create (Data Manager API)	नोट
advertiserId partnerId	parent	parent में, नई ऑडियंस के विज्ञापन देने वाले पैरंट व्यक्ति या कंपनी या पार्टनर का आईडी होता है.
कोई मिलती-जुलती रिपोर्ट नहीं	validateOnly
FirstPartyAndPartnerAudience अनुरोध का मुख्य हिस्सा	UserList अनुरोध का मुख्य हिस्सा	अनुरोध के मुख्य हिस्से की मैपिंग के लिए, UserList देखें.

userLists.update

firstPartyAndPartnerAudiences.patch (Display & Video 360 API)	userLists.patch (Data Manager API)	नोट
advertiserId firstPartyAndPartnerAudienceId	userList.name पैरामीटर	अपडेट किए जाने वाले UserList का संसाधन का नाम.
updateMask	updateMask	डेटा मैनेजर एपीआई में इस फ़ील्ड का इस्तेमाल करने का सुझाव दिया जाता है, लेकिन यह ज़रूरी नहीं है. अगर इसे खाली छोड़ दिया जाता है, तो इसमें शामिल सभी फ़ील्ड पूरी तरह से बदल जाएंगे.
कोई मिलती-जुलती रिपोर्ट नहीं	validateOnly
FirstPartyAndPartnerAudience अनुरोध का मुख्य हिस्सा	UserList अनुरोध का मुख्य हिस्सा	अनुरोध के मुख्य हिस्से की मैपिंग के लिए, UserList देखें.

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API)	audienceMembers.ingest (Data Manager API)	नोट
advertiserId firstPartyAndPartnerAudienceId	destinations	ज़्यादा जानकारी के लिए, डेस्टिनेशन कॉन्फ़िगर करना लेख पढ़ें.
addedContactInfoList.contactInfos	audienceMembers	हर उपयोगकर्ता के आइडेंटिफ़ायर को AudienceMember ऑब्जेक्ट में मौजूद compositeData.userData फ़ील्ड में सेट किया जा सकता है. ज़्यादा जानकारी के लिए, उपयोगकर्ता आइडेंटिफ़ायर देखें.
addedContactInfoList.consent	consent	सहमति को अलग-अलग AudienceMember ऑब्जेक्ट में भी सेट किया जा सकता है.
addedMobileDeviceIdList.mobileDeviceIds	audienceMembers	हर मोबाइल डिवाइस आईडी को AudienceMember ऑब्जेक्ट में मौजूद mobileData फ़ील्ड में सेट किया जाता है.
addedMobileDeviceIdList.consent	consent	सहमति को अलग-अलग AudienceMember ऑब्जेक्ट में भी सेट किया जा सकता है.
कोई मिलती-जुलती रिपोर्ट नहीं	validateOnly
कोई मिलती-जुलती रिपोर्ट नहीं	encoding	ज़रूरी है. इसे UserIdentifier वैल्यू के लिए इस्तेमाल किए गए Encoding पर सेट करें.
कोई मिलती-जुलती रिपोर्ट नहीं	encryptionInfo	यह तब सेट होता है, जब अनुरोध में एन्क्रिप्ट की गई वैल्यू शामिल हों. ज़्यादा जानकारी के लिए, एन्क्रिप्शन देखें.
कोई मिलती-जुलती रिपोर्ट नहीं	termsOfService	ज़रूरी है. यह बताने के लिए सेट किया गया है कि उपयोगकर्ता ने कस्टमर मैच की सेवा की शर्तें स्वीकार की हैं या नहीं.

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API)	audienceMembers.remove (Data Manager API)	नोट
advertiserId firstPartyAndPartnerAudienceId	destinations
removedContactInfoList.contactInfos	audienceMembers	हर उपयोगकर्ता के आइडेंटिफ़ायर को AudienceMember ऑब्जेक्ट में मौजूद compositeData.userData फ़ील्ड में सेट किया जा सकता है. ज़्यादा जानकारी के लिए, उपयोगकर्ता आइडेंटिफ़ायर देखें.
removedMobileDeviceIdList.mobileDeviceIds	audienceMembers	हर मोबाइल डिवाइस आईडी को AudienceMember ऑब्जेक्ट में मौजूद mobileData फ़ील्ड में सेट किया जाता है.
कोई मिलती-जुलती रिपोर्ट नहीं	validateOnly
कोई मिलती-जुलती रिपोर्ट नहीं	encoding	ज़रूरी है. इसे UserIdentifier वैल्यू के लिए इस्तेमाल किए गए Encoding पर सेट करें.
कोई मिलती-जुलती रिपोर्ट नहीं	encryptionInfo	यह तब सेट होता है, जब अनुरोध में एन्क्रिप्ट की गई वैल्यू शामिल हों. ज़्यादा जानकारी के लिए, एन्क्रिप्शन देखें.

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

यहां Display & Video 360 API ऑब्जेक्ट से Data Manager API में मौजूद मिलते-जुलते ऑब्जेक्ट की मैपिंग दी गई है.

UserList

FirstPartyAndPartnerAudience (Display & Video 360 API)	UserList (Data Manager API)	नोट
name	name	इसमें संसाधन के नाम के लिए अलग फ़ॉर्मैट का इस्तेमाल किया जाता है. ज़्यादा जानकारी के लिए, संसाधन के नाम देखें.
firstPartyAndPartnerAudienceId	id
कोई मिलती-जुलती रिपोर्ट नहीं	readOnly
displayName	displayName
description	description
कोई मिलती-जुलती रिपोर्ट नहीं	membershipStatus
कोई मिलती-जुलती रिपोर्ट नहीं	integrationCode
membershipDurationDays	membershipDuration
कोई मिलती-जुलती रिपोर्ट नहीं	closingReason
कोई मिलती-जुलती रिपोर्ट नहीं	accessReason
कोई मिलती-जुलती रिपोर्ट नहीं	accountAccessStatus
displayAudienceSize	sizeInfo.displayNetworkMembersCount
कोई मिलती-जुलती रिपोर्ट नहीं	sizeInfo.searchNetworkMembersCount
कोई मिलती-जुलती रिपोर्ट नहीं	targetNetworkInfo
कोई मिलती-जुलती रिपोर्ट नहीं	ingestedUserListInfo
firstPartyAndPartnerAudienceType	कोई मिलती-जुलती रिपोर्ट नहीं
audienceType	कोई मिलती-जुलती रिपोर्ट नहीं
audienceSource	कोई मिलती-जुलती रिपोर्ट नहीं
activeDisplayAudienceSize	कोई मिलती-जुलती रिपोर्ट नहीं
youtubeAudienceSize	कोई मिलती-जुलती रिपोर्ट नहीं
gmailAudienceSize	कोई मिलती-जुलती रिपोर्ट नहीं
displayMobileAppAudienceSize	कोई मिलती-जुलती रिपोर्ट नहीं
displayMobileWebAudienceSize	कोई मिलती-जुलती रिपोर्ट नहीं
displayDesktopAudienceSize	कोई मिलती-जुलती रिपोर्ट नहीं
appId	ingestedUserListInfo.mobileIdInfo.appId
contactInfoList	audienceMembers तरीके	Data Manager API में, audienceMembers के ingest और remove तरीकों का इस्तेमाल करके सदस्यों को जोड़ें और हटाएं.
mobileDeviceIdList	audienceMembers तरीके	Data Manager API में, audienceMembers के ingest और remove तरीकों का इस्तेमाल करके सदस्यों को जोड़ें और हटाएं.

संसाधन के नाम

Data Manager API, Display & Video 360 API से अलग संसाधन के नाम का फ़ॉर्मैट इस्तेमाल करता है.

Display & Video 360 API

Display & Video 360 API में, UserList संसाधन के नाम में ऐसा फ़ॉर्मैट इस्तेमाल किया जाता है जिसमें सिर्फ़ ऑडियंस आईडी होता है:

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

Data Manager API

Data Manager API में, UserList संसाधन के नाम का फ़ॉर्मैट ऐसा होता है जिसमें ऑडियंस आईडी के साथ-साथ, ऑडियंस के मालिक पार्टनर या विज्ञापन देने वाले व्यक्ति या कंपनी का AccountType और खाता आईडी शामिल होता है:

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

यूज़र आइडेंटिफ़ायर

userData का इस्तेमाल अब भी किया जा सकता है. हालांकि, हमारा सुझाव है कि आप compositeData का इस्तेमाल करें, ताकि आने वाले समय में होने वाले सुधारों के लिए आपका इंटिग्रेशन तैयार रहे. ज़्यादा जानकारी के लिए, कंपोज़िट डेटा देखें.

ContactInfo (Display & Video 360 API)	CompositeData (Data Manager API)	नोट
hashedEmails	userData.userIdentifiers.emailAddress	फ़ॉर्मैट किए गए और हैश किए गए ईमेल पते पर सेट किया जाता है. हैश किए गए ईमेल पते को एन्क्रिप्ट (सुरक्षित) भी किया जा सकता है. एक ही उपयोगकर्ता से मैच करने के लिए, कई ईमेल पतों का इस्तेमाल किया जा सकता है. इसके लिए, कई UserIdentifier ऑब्जेक्ट का इस्तेमाल करें.
hashedPhoneNumbers	userData.userIdentifiers.phoneNumber	फ़ॉर्मैट किए गए और हैश किए गए फ़ोन नंबर पर सेट किया जाता है. आपके पास हैश किए गए फ़ोन नंबर को एन्क्रिप्ट (सुरक्षित) करने का विकल्प भी होता है. एक ही उपयोगकर्ता से मैच करने के लिए, कई फ़ोन नंबर इस्तेमाल किए जा सकते हैं. इसके लिए, कई UserIdentifier ऑब्जेक्ट का इस्तेमाल करें.
hashedFirstName	userData.userIdentifiers.address.givenName	यह फ़ॉर्मैट किए गए और हैश किए गए दिए गए नाम पर सेट होता है. आपके पास हैश किए गए नाम को एन्क्रिप्ट (सुरक्षित) करने का विकल्प भी होता है.
hashedLastName	userData.userIdentifiers.address.familyName	इसे फ़ैमिली नेम के फ़ॉर्मैट किए गए और हैश किए गए वर्शन पर सेट किया जाता है. आपके पास हैश किए गए फ़ैमिली ग्रुप के नाम को एन्क्रिप्ट (सुरक्षित) करने का विकल्प भी होता है.
countryCode	userData.userIdentifiers.address.regionCode
zipCodes	userData.userIdentifiers.address.postalCode	एक ही उपयोगकर्ता से मैच करने के लिए, एक से ज़्यादा ज़िप कोड का इस्तेमाल किया जा सकता है. इसके लिए, एक से ज़्यादा UserIdentifier ऑब्जेक्ट का इस्तेमाल करें.

मंज़िल

Display & Video 360 API	Destination (Data Manager API)	नोट
विज्ञापन देने वाले व्यक्ति या कंपनी या पार्टनर का वह आईडी जिसे Display & Video 360 के उपयोगकर्ता को ऐक्सेस करने की अनुमति दी गई है.	loginAccount	इसे सिर्फ़ Display & Video 360 पार्टनर ऐक्सेस के मामले में सेट करना होता है. इसमें ऑडियंस, विज्ञापन देने वाले व्यक्ति या कंपनी के खाते में होती है, लेकिन Display & Video 360 का इस्तेमाल करने वाले व्यक्ति को, विज्ञापन देने वाले व्यक्ति या कंपनी के पैरंट पार्टनर का ऐक्सेस दिया गया होता है. अगर ऐसा नहीं है, तो इसे सेट न करें.
ऑडियंस के पैरंट ऐडवर्टाइज़र या पार्टनर का आईडी.	operatingAccount
firstPartyAndPartnerAudienceId	productDestinationId
कोई मिलती-जुलती रिपोर्ट नहीं	reference