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

تاريخ آخر تعديل: 2025-07-31

نقل تطبيقك

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

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

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

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

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

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

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

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

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

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