تعيينات الحقول

استخدِم عمليات الربط في الجداول لربط طرق إدارة شرائح جمهور "مطابقة العملاء" والحقول في 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	يمكن لواجهة Data Manager 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 (واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360")	userLists.get (Data Manager API)	ملاحظات
advertiserId partnerId firstPartyAndPartnerAudienceId	name	يحتوي الاسم UserList على رقم تعريف المعلِن أو الشريك الرئيسي بالإضافة إلى رقم تعريف الجمهور. راجِع أسماء الموارد للحصول على التفاصيل.

userLists.list

firstPartyAndPartnerAudiences.list (واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360")	userLists.list (Data Manager API)	ملاحظات
advertiserId partnerId	parent	يحتوي parent على رقم تعريف المعلِن أو الشريك الرئيسي.
pageSize	pageSize	الحد الأقصى لحجم الصفحة في Data Manager API هو 1000.
pageToken	pageToken
filter	filter
orderBy	بدون مكافئ

userLists.create

firstPartyAndPartnerAudiences.create (واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360")	userLists.create (Data Manager API)	ملاحظات
advertiserId partnerId	parent	يحتوي parent على رقم تعريف المعلِن أو الشريك الرئيسي لشريحة الجمهور الجديدة.
بدون مكافئ	validateOnly
نص طلب FirstPartyAndPartnerAudience	نص طلب UserList	راجِع UserList لمعرفة كيفية ربط نص الطلب.

userLists.update

firstPartyAndPartnerAudiences.patch (واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360")	userLists.patch (Data Manager API)	ملاحظات
advertiserId firstPartyAndPartnerAudienceId	المَعلمة userList.name	اسم المورد الخاص بـ UserList المطلوب تعديله.
updateMask	updateMask	يُنصح باستخدام هذا الحقل ولكنّه ليس مطلوبًا في Data Manager API، وسيؤدي إلى استبدال كامل لجميع الحقول المُدرَجة إذا تم تركه فارغًا.
بدون مكافئ	validateOnly
نص طلب FirstPartyAndPartnerAudience	نص طلب UserList	راجِع UserList لمعرفة كيفية ربط نص الطلب.

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360")	audienceMembers.ingest (Data Manager API)	ملاحظات
advertiserId firstPartyAndPartnerAudienceId	destinations	اطّلِع على إعداد الوجهات للحصول على التفاصيل.
addedContactInfoList.contactInfos	audienceMembers	يتم ضبط بيانات المستخدم الفردية في الحقل userData ضمن عناصر AudienceMember.
addedContactInfoList.consent	consent	يمكن أيضًا ضبط الموافقة في عناصر AudienceMember الفردية.
addedMobileDeviceIdList.mobileDeviceIds	audienceMembers	يتم ضبط أرقام تعريف الأجهزة الجوّالة الفردية في الحقل mobileData ضمن عناصر AudienceMember.
addedMobileDeviceIdList.consent	consent	يمكن أيضًا ضبط الموافقة في عناصر AudienceMember الفردية.
بدون مكافئ	validateOnly
بدون مكافئ	encoding	مطلوبة. اضبطها على Encoding المستخدَمة لقيم UserIdentifier.
بدون مكافئ	encryptionInfo	تحديد ما إذا كان الطلب يحتوي على قيم مشفّرة لمزيد من التفاصيل، يُرجى الاطّلاع على التشفير.
بدون مكافئ	termsOfService	مَعلمة مطلوبة. يتم ضبطها للإشارة إلى أنّ المستخدم قد قبل أو رفض بنود الخدمة في "مطابقة العملاء".

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360")	audienceMembers.remove (Data Manager API)	ملاحظات
advertiserId firstPartyAndPartnerAudienceId	destinations
removedContactInfoList.contactInfos	audienceMembers	يتم ضبط بيانات المستخدم الفردية في الحقل userData ضمن عناصر AudienceMember. لمزيد من التفاصيل، يُرجى الاطّلاع على UserData.
removedMobileDeviceIdList.mobileDeviceIds	audienceMembers	يتم ضبط أرقام تعريف الأجهزة الجوّالة الفردية في الحقل mobileData ضمن عناصر AudienceMember.
بدون مكافئ	validateOnly
بدون مكافئ	encoding	مَعلمة مطلوبة. اضبطها على Encoding المستخدَمة لقيم UserIdentifier.
بدون مكافئ	encryptionInfo	تحديد ما إذا كان الطلب يحتوي على قيم مشفّرة لمزيد من التفاصيل، يُرجى الاطّلاع على التشفير.

عمليات ربط حقول العناصر

في ما يلي عمليات الربط من عناصر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" إلى العناصر المكافئة في واجهة برمجة التطبيقات الخاصة بأداة "إدارة بيانات إعلانات Google".

UserList

FirstPartyAndPartnerAudience (واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360")	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، أضِف الأعضاء وأزِلهم باستخدام الطريقتَين ingest وremove في audienceMembers.
mobileDeviceIdList	طُرق audienceMembers	في Data Manager API، أضِف الأعضاء وأزِلهم باستخدام الطريقتَين ingest وremove في audienceMembers.

أسماء الموارد

تستخدِم Data Manager API تنسيقًا مختلفًا لاسم المورد عن Display & Video 360 API.

واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"

في واجهة برمجة التطبيقات 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

ContactInfo (واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360")	UserData (Data Manager API)	ملاحظات
hashedEmails	userIdentifiers.emailAddress	يجب ضبطه على عنوان البريد الإلكتروني المنسَّق والمجزَّأ. يمكنك أيضًا تشفير عنوان البريد الإلكتروني المجزّأ. يمكن استخدام عدّة عناوين بريد إلكتروني لمطابقة مستخدم واحد من خلال استخدام عدّة عناصر UserIdentifier.
hashedPhoneNumbers	userIdentifiers.phoneNumber	يتم ضبطه على رقم الهاتف المنسَّق والمشفَّر. يمكنك أيضًا تشفير رقم الهاتف المجزّأ. يمكن استخدام أرقام هواتف متعددة لمطابقة مستخدم واحد من خلال استخدام عناصر UserIdentifier متعددة.
hashedFirstName	userIdentifiers.address.givenName	اضبط على الاسم الأول المنسَّق والمجزّأ. يمكنك أيضًا تشفير الاسم الأول المجزّأ.
hashedLastName	userIdentifiers.address.familyName	يجب ضبطها على اسم العائلة المنسّق والمجزّأ. يمكنك أيضًا تشفير اسم العائلة المجزّأ.
countryCode	userIdentifiers.address.regionCode
zipCodes	userIdentifiers.address.postalCode	يمكن استخدام رموز بريدية متعددة لمطابقة مستخدم واحد من خلال استخدام عناصر UserIdentifier متعددة.

الوجهة

واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"	Destination (Data Manager API)	ملاحظات
رقم تعريف المعلِن أو الشريك الذي تم منح مستخدم "مساحة العرض والفيديو 360" إذن الوصول إليه.	loginAccount	يجب ضبط هذا الإعداد فقط في سيناريو وصول الشريك إلى "مساحة العرض والفيديو 360"، حيث تكون شريحة الجمهور ضمن حساب معلِن ولكن تم منح المستخدم الذي يصل إلى "مساحة العرض والفيديو 360" إذن الوصول إلى الشريك الرئيسي للمعلِن. وفي حال عدم توفّرها، يمكن تركها بدون تحديد.
رقم تعريف المعلِن أو الشريك الرئيسي لشريحة الجمهور	operatingAccount
firstPartyAndPartnerAudienceId	productDestinationId
بدون مكافئ	reference