آخر تعديل: 2023-10-31
نقل بيانات تطبيقك
لنقل البيانات من الإصدار 2 إلى الإصدار 3، يجب تعديل عناوين URL لنقاط النهاية لاستدعاء الإصدار 3 وتحديث تطبيقك لمراعاة التغييرات التي قد تؤدي إلى أعطال.
تحديث طلبات البيانات من واجهة برمجة التطبيقات من الإصدار 2 إلى الإصدار 3
لاستخدام الإصدار 3 بدلاً من الإصدار 2، يجب تحديث طلباتك لاستخدام نقاط نهاية جديدة في الإصدار 3.
على سبيل المثال، لاستدعاء طريقة advertisers.get
مع v2، يمكنك استخدام عنوان URL التالي:
GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId
بالنسبة إلى الإصدار 3، قم بتحديث عنوان URL إلى ما يلي:
GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId
إذا كنت تستخدم مكتبة عملاء لإرسال طلبات إلى واجهة برمجة التطبيقات، عليك استخدام أحدث إصدار من مكتبة العميل وتعديل الإعدادات لاستخدام الإصدار 3.
إجراء التغييرات المطلوبة
نحن بصدد طرح عدد من التغييرات التي قد تؤدي إلى أعطال في الإصدار 3. يُرجى مراجعة التعليمات التالية وإجراء التغييرات المطلوبة ذات الصلة باستخدامك الحالي لواجهة برمجة التطبيقات لـ "مساحة العرض والفيديو 360".
تعديل المكالمات التي تسترد موارد YouTube والاستهداف المرتبط بها
- تم استبدال الموارد
YoutubeAdGroup
وYoutubeAdGroupAd
بالمواردAdGroup
وAdGroupAd
. توفر هذه الموارد الجديدة معلومات متطابقة تقريبًا كموارد الإصدار 2، ولكنها قد تستخدم أسماء حقول أو أنواع تعداد محدثة. في عملية الدمج، استبدل استخداماتك لمواردYoutubeAdGroup
أوYoutubeAdGroupAd
بمواردAdGroup
وAdGroupAd
وعدِّل عمليات إرسال الطلبات إلى خدمات الإصدار 2 التالية إلى خدمة الإصدار 3 المقابلة لها:advertisers.youtubeAdGroupAds
إلىadvertisers.adGroupAds
advertisers.youtubeAdGroups
إلىadvertisers.adGroups
advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions
إلىadvertisers.adGroups.targetingTypes.assignedTargetingOptions
- تم نقل الإشارات إلى عناصر
YoutubeAndPartnersBiddingStrategy
إلى حقلyoutubeAndPartnersBid
جديد ضمن العنصر العامBiddingStrategy
. تمت إزالة الحقلbiddingStrategy
من الكائنYoutubeAndPartnersSettings
. عدِّل عملية الدمج لاسترداد استراتيجية عروض الأسعار للعناصر أو المجموعات الإعلانية على YouTube من العنصرBiddingStrategy
في الحقلbidStrategy
في الموردLineItem
أوAdGroup
. - تمت إعادة تسمية الحقل
thirdPartyMeasurementSettings
إلىthirdPartyMeasurementConfigs
في الكائنYoutubeAndPartnersSettings
وتمت إعادة تسمية العنصرYoutubeAndPartnersThirdPartyMeasurementSettings
إلىThirdPartyMeasurementConfigs
. يُرجى تعديل عملية الدمج لاسترداد معلومات ضبط القياس التابعة لجهة خارجية باستخدام الحقل والعنصر الجديدَين.
تضمين إعدادات الفوترة المطلوبة عند إنشاء المعلِنين
أصبح حقل billingConfig
الآن حقلاً مطلوبًا في المورد
Advertiser
. عدِّل طلبات advertisers.create
للتحقق من ضبط هذا الحقل. يمكن استرداد معلومات الفوترة التلقائية للشريك الرئيسي من خلال حقل مورد Partner
الجديد billingConfig
.
استخدام حقل جديد للتحكّم في الاستهداف المحسّن
حل حقل enableOptimizedTargeting
منطقي جديد محل الحقل
targetingExpansionLevel
في الكائن TargetingExpansionConfig
.
تعديل دمج طلب الإدراج لاستخدام حقل مؤشر الأداء الرئيسي الجديد
تم استبدال الحقل performanceGoal
في المورد InsertionOrder
بحقل kpi
جديد. يستخدم هذا الحقل الجديد كائن Kpi
بدلاً من الكائن PerformanceGoal
ويستخدم حقولاً وتعدادات جديدة.
إزالة المراجع إلى الخدمات والحقول التي تم إيقافها نهائيًا
تمت إزالة العديد من الكيانات في الإصدار 3 تماشيًا مع الإيقافات السابقة للميزات:
- تمت إزالة خدمة
advertisers.manualTriggers
لأنّ المشغّلات اليدوية متوقّفة نهائيًا. - تمت إزالة الحقل
billableOutcome
من الموردInsertionOrder
بسبب إيقاف الشراء استنادًا إلى النتائج.
تغييرات إضافية
بالإضافة إلى التغييرات التي قد تؤدي إلى عطل أعلاه، يقدّم الإصدار 3 أيضًا ميزات جديدة.
يمكنك الاطّلاع على الميزات التي تمت إضافتها إلى الإصدار 3 بعد الإطلاق الأولي في ملاحظات الإصدار.
إدارة قائمة المواقع الجغرافية القريبة
في الإصدار 3، يمكنك إدارة قوائم المواقع القريبة بشكل كامل، ما يسمح لك باستخدام خدمة advertisers.locationLists.assignedLocations
لإنشاء وحذف المواقع الجغرافية المخصصة لـ TARGETING_LOCATION_TYPE_PROXIMITY
مورد LocationList
. يتم تحديد المواقع الجغرافية باستخدام رقم تعريف موارد
TARGETING_TYPE_POI
TargetingOption
. ويمكن استردادها باستخدام targetingTypes.targetingOptions.search
.
القدرة على إنشاء خوارزميات عروض أسعار مخصصة مستندة إلى القواعد
في الإصدار الثالث، يمكنك إنشاء خوارزميات عروض أسعار مخصّصة مستندة إلى القواعد واستردادها باستخدام خدمات
customBiddingAlgorithms
وmedia
وcustomBiddingAlgorithms.rules
.
هذه الميزة تجريبية ومتاحة فقط للشركاء المُدرَجين في القائمة المسموح بها. إذا لم يكن شريكك مدرجًا في القائمة المسموح بها، سيظهر خطأ في طلبك.