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

تاريخ آخر تعديل: 31‏ تشرين الأول (أكتوبر) 2023

نقل بيانات تطبيقك

يتطلّب نقل البيانات من الإصدار 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. راجِع الخطوات التالية وأجرِ التغييرات المطلوبة ذات الصلة باستخدامك الحالي لواجهة برمجة التطبيقات Display & Video 360 API.

  • تم استبدال الموردَين YoutubeAdGroup وYoutubeAdGroupAd بالموردَين AdGroup وAdGroupAd. توفّر هذه الموارد الجديدة معلومات متطابقة تقريبًا مع موارد الإصدار 2، ولكن قد تستخدم أسماء حقول أو أنواعًا معدَّلة من التعدادات. في عملية الدمج، استبدِل استخدامات موارد YoutubeAdGroup أو YoutubeAdGroupAd بموارد AdGroup و AdGroupAd وعدِّل طلبات البيانات إلى خدمات الإصدار 2 التالية لتكون خدمة الإصدار 3 المقابلة:
  • تم نقل الإشارات إلى عناصر YoutubeAndPartnersBiddingStrategy إلى حقل youtubeAndPartnersBid جديد ضمن العنصر العام BiddingStrategy. تمت إزالة حقل biddingStrategy من عنصر YoutubeAndPartnersSettings. عدِّل عملية الدمج ل retrieving the bidding strategy for YouTube line items or ad groups from the BiddingStrategy object in the bidStrategy field in the LineItem or AdGroup resource.
  • تمت إعادة تسمية الحقل thirdPartyMeasurementSettings ليصبح thirdPartyMeasurementConfigs في العنصر YoutubeAndPartnersSettings، كما تمت إعادة تسمية العنصر YoutubeAndPartnersThirdPartyMeasurementSettings ليصبح ThirdPartyMeasurementConfigs. عدِّل عملية الدمج ل retrieving retrieve third-party measurement configuration information using the new field and object.

تضمين إعدادات الفوترة المطلوبة عند إنشاء المعلِنين

أصبح billingConfig حقلًا مطلوبًا في موارد Advertiser. عدِّل طلبات advertisers.create للتأكّد من ضبط هذا الحقل. يمكن retrieving استرداد معلومات الفوترة التلقائية للشريك الرئيسي من خلال حقل مورد billingConfig الجديد في Partner.

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

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

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

تم استبدال حقل 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.

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