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

تاريخ آخر تعديل: 2023-10-31

نقل تطبيقك

يتطلّب النقل من الإصدار 2 إلى الإصدار 3 تعديل عناوين URL لنقاط النهاية من أجل طلب الإصدار 3، وتعديل تطبيقك لاستيعاب التغييرات غير المتوافقة مع الإصدارات السابقة.

تعديل طلبات البيانات من واجهة برمجة التطبيقات من الإصدار 2 إلى الإصدار 3

لاستخدام الإصدار 3 بدلاً من الإصدار 2، عليك تعديل طلباتك لاستخدام نقاط النهاية الجديدة للإصدار 3.

على سبيل المثال، لطلب بيانات من طريقة advertisers.get باستخدام الإصدار 2، عليك استخدام عنوان 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.

استخدام حقل جديد للتحكّم في ميزة "الاستهداف المحسّن"

تم استبدال الحقل targetingExpansionLevel بحقل منطقي جديد enableOptimizedTargeting في العنصر TargetingExpansionConfig.

تعديل عملية دمج طلب الإدراج لاستخدام حقل مؤشر الأداء الرئيسي الجديد

تم استبدال الحقل performanceGoal بالحقل الجديد kpi في المرجع InsertionOrder. يستخدم هذا الحقل الجديد عنصر Kpi بدلاً من العنصر PerformanceGoal، كما يستخدم حقولًا وقيمًا تعدادية جديدة.

إزالة الإشارات إلى الخدمات والحقول المتوقّفة نهائيًا

تمت إزالة عناصر مختلفة في الإصدار 3 لتتوافق مع عمليات الإيقاف النهائي السابقة للميزات:

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

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

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

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

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

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

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

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