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

تاريخ آخر تعديل: 27‏/03‏/2025

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

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

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

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

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

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

بالنسبة إلى الإصدار 4، عدِّل عنوان URL على النحو التالي:

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

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

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

نحن بصدد طرح عدد من التغييرات الأساسية في الإصدار 4. راجِع الخطوات التالية وأجرِ التغييرات المطلوبة ذات الصلة باستخدامك الحالي لواجهة برمجة التطبيقات Display & Video 360 API.

تعديل المكالمات بشأن مراجع الجمهور التابعة للطرف الأول والجهات الخارجية والاستهداف ذي الصلة

تم استبدال موارد FirstAndThirdPartyAudience بموارد FirstPartyAndPartnerAudience.

يتطلّب هذا التغيير منك تعديل ما يلي:

• مراجع إلى مراجع FirstAndThirdPartyAudience لاستخدام المرجع الجديد FirstPartyAndPartnerAudience
• الطلبات الحالية إلى الطرق في خدمة الإصدار 3 firstAndThirdPartyAudiences إلى خدمة الإصدار 4 الجديدة firstPartyAndPartnerAudiences
• توقّعات حجم الصفحة التلقائي لطلبات firstPartyAndPartnerAudiences.list من 100 إلى 5,000 عنصر
• الإشارات إلى حقل firstAndThirdPartyAudienceType في الإصدار 3 إلى حقل firstPartyAndPartnerAudienceType الجديد في الإصدار 4، باستخدام نوع التعداد FirstPartyAndPartnerAudienceType الجديد، مع قيم قديمة تتوافق مع القيم الجديدة التالية:
  • من FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY إلى TYPE_FIRST_PARTY
  • من FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY إلى TYPE_PARTNER

• الإشارات إلى قيمة التعداد AudienceType LICENSED لاستخدام إحدى القيم الجديدة التالية الأكثر تحديدًا:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• الإشارات إلى موارد AssignedTargetingOption الخاصة بملف TargetingType TARGETING_TYPE_AUDIENCE_GROUP لاستبدال حقول الإصدار 3 في AudienceGroupAssignedTargetingOptionDetails بحقول الإصدار 4 الجديدة التالية:

  • excludedFirstAndThirdPartyAudienceGroup باستخدام excludedFirstPartyAndPartnerAudienceGroup
  • includedFirstAndThirdPartyAudienceGroups باستخدام includedFirstPartyAndPartnerAudienceGroups

تعديل طلبات استهداف القوائم المجمّعة الحالية للمجموعات الإعلانية

تمت إعادة تسمية advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions advertisers.adGroups.bulkListAssignedTargetingOptions. عدِّل طلباتك الحالية لاستخدام اسم الطريقة الجديد.

تضمين هدف تحسين عند إنشاء طلبات إدراج

أصبح optimizationObjective حقلًا مطلوبًا في موارد InsertionOrder. عدِّل طلبات advertisers.insertionOrders.create للتأكّد من ضبط هذا الحقل.

إزالة أي طلبات لإدارة استهداف الحملة أو طلب الإدراج أو استرجاعه

تمت إزالة إمكانية استرداد استهداف الحملة أو طلب الإدراج أو إدارته. أزِل أي طلبات إلى الخدمات أو الطرق التالية:

• خدمة advertisers.campaigns.targetingTypes.assignedTargetingOptions
• خدمة advertisers.insertionOrders.targetingTypes.assignedTargetingOptions
• طريقة advertisers.campaigns.listAssignedTargetingOptions
• طريقة advertisers.insertionOrders.listAssignedTargetingOptions

إزالة الإشارات إلى حقل مورد تصميم الإعلان publisherReviewStatuses

تمت إزالة الحقل publisherReviewStatuses من العنصر ReviewStatusInfo ضمن المورد Creative بعد إيقافه نهائيًا في حزيران (يونيو) 2024.