نقل البيانات من الإصدار 2 إلى الإصدار 3

آخر تعديل: 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".

  • تم استبدال الموارد YoutubeAdGroup وYoutubeAdGroupAd بالموارد AdGroup وAdGroupAd. توفر هذه الموارد الجديدة معلومات متطابقة تقريبًا كموارد الإصدار 2، ولكنها قد تستخدم أسماء حقول أو أنواع تعداد محدثة. في عملية الدمج، استبدل استخداماتك لموارد YoutubeAdGroup أو YoutubeAdGroupAd بموارد AdGroup وAdGroupAd وعدِّل عمليات إرسال الطلبات إلى خدمات الإصدار 2 التالية إلى خدمة الإصدار 3 المقابلة لها:
  • تم نقل الإشارات إلى عناصر 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 تماشيًا مع الإيقافات السابقة للميزات:

تغييرات إضافية

بالإضافة إلى التغييرات التي قد تؤدي إلى عطل أعلاه، يقدّم الإصدار 3 أيضًا ميزات جديدة.

يمكنك الاطّلاع على الميزات التي تمت إضافتها إلى الإصدار 3 بعد الإطلاق الأولي في ملاحظات الإصدار.

إدارة قائمة المواقع الجغرافية القريبة

في الإصدار 3، يمكنك إدارة قوائم المواقع القريبة بشكل كامل، ما يسمح لك باستخدام خدمة advertisers.locationLists.assignedLocations لإنشاء وحذف المواقع الجغرافية المخصصة لـ TARGETING_LOCATION_TYPE_PROXIMITY مورد LocationList. يتم تحديد المواقع الجغرافية باستخدام رقم تعريف موارد TARGETING_TYPE_POI TargetingOption. ويمكن استردادها باستخدام targetingTypes.targetingOptions.search.

القدرة على إنشاء خوارزميات عروض أسعار مخصصة مستندة إلى القواعد

في الإصدار الثالث، يمكنك إنشاء خوارزميات عروض أسعار مخصّصة مستندة إلى القواعد واستردادها باستخدام خدمات customBiddingAlgorithms وmedia وcustomBiddingAlgorithms.rules.

هذه الميزة تجريبية ومتاحة فقط للشركاء المُدرَجين في القائمة المسموح بها. إذا لم يكن شريكك مدرجًا في القائمة المسموح بها، سيظهر خطأ في طلبك.