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

تاريخ التعديل الأخير: 31/10/2023

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

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

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

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

على سبيل المثال، لاستدعاء طريقة advertisers.get مع الإصدار 2، يمكنك استخدِم عنوان URL التالي:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

بالنسبة إلى الإصدار 3، عدِّل عنوان URL إلى ما يلي:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

إذا كنت تستخدم مكتبة برامج لتقديم طلبات إلى واجهة برمجة التطبيقات، استخدِم إصدار حديث من مكتبة البرامج وتحديث الإعدادات لاستخدام الإصدار 3.

إجراء التغييرات المطلوبة

نحن نُجري عددًا من التغييرات التي قد تؤدي إلى أعطال في الإصدار الثالث. راجِع ما يلي: من التعليمات وإجراء التغييرات المطلوبة ذات الصلة باستخدامك الحالي العرض Video 360 API:

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

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

حل حقل kpi جديد محل الحقل performanceGoal في المرجع 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:

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