نقل البيانات من Bid Manager API v1.1 إلى v2

في آذار (مارس) 2022، أطلقنا الإصدار 2 من Bid Manager API. بناءً على من هذا الإصدار الجديد، فإننا نخطط للإعلان عن تاريخ الإيقاف النهائي للإصدار 1.1 قريبًا. أر ننصحك ببدء عملية نقل البيانات من الإصدار 1.1 إلى الإصدار 2 في أقرب وقت ممكن.

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

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

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

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

تحديد الطرق المكافئة

لتعديل طلبات البيانات من واجهة برمجة التطبيقات من استخدام الإصدار 1.1 إلى الإصدار 2، عليك أولاً تحديد الطرق المكافئة لإصدار v1.1 في الإصدار 2.

تم تغيير الأسماء التالية لجميع الخدمات والطرق قليلاً بين الإصداران 1.1 و2:

التحديث إلى نقاط نهاية جديدة

بعد تحديد الطرق المكافئة، عليك تعديل طلباتك. بالنسبة على سبيل المثال، لاستدعاء طريقة queries.getquery مع الإصدار 1.1، يمكنك استخدام عنوان URL التالي:

https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId

لطلب الطريقة المكافئة في الإصدار 2، والمعروفة باسم queries.get، عليك تعديل إلى ما يلي:

GET https://doubleclickbidmanager.googleapis.com/v2/queries/queryId

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

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

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

تعديل المكالمات إلى خدمة "queries"

تعديل المكالمات إلى خدمة "reports"

تعديل منطق معالجة الأخطاء

تم تحديث رسائل الخطأ عبر واجهة برمجة التطبيقات في الإصدار 2. رسائل الخطأ الجديدة هذه أكثر تحديدًا، وفي بعض الحالات، تقدم معلومات عن القيم في طلب واجهة برمجة التطبيقات الذي يتسبّب في عرض الخطأ. إذا كان الخطأ الحالي فإن التعامل مع المنطق يعتمد على نص رسالة خطأ محددة، مع تعميم الخطأ المعالجة قبل الانتقال إلى الإصدار 2.