نقل البيانات إلى إصدار جديد

يتم إصدار إصدارات جديدة من Campaign Manager 360 API بانتظام. ومع طرح إصدارات جديدة، يتم إيقاف الإصدارات القديمة نهائيًا. عند إيقاف إصدار نهائيًا، تبدأ جميع الطلبات التي تستهدف هذا الإصدار في عرض أخطاء.

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

الخطوة 1: تحديد الإصدار الذي تستخدمه

إذا كنت تدير تطبيقًا تشتبه في أنّه يستخدم إصدارًا متوقّفًا نهائيًا من Campaign Manager 360 API، عليك أولاً التحقّق من الإصدار المحدّد الذي تستخدمه. في معظم الحالات، ستتمكّن من الوصول إلى واجهة برمجة التطبيقات من خلال إحدى مكتبات البرامج الخاصة بالعملاء والمخصّصة للغة أو من خلال عملية دمج رسمية. يمكنك الاطّلاع أدناه على تعليمات العثور على إصدار واجهة برمجة التطبيقات المستخدَم في مكتبات العميل هذه وعمليات التكامل:

المحرِّر الجديد في Apps Script

يتم عرض معلومات الإصدار لـ Apps Script في مربّع حوار الخدمات المتقدّمة:

  1. من محرِّر Apps Script، انقر على إضافة خدمة .
  2. حدِّد موقع Campaign Manager 360 API في قائمة الخدمات المتاحة.
  3. القيمة المحدّدة في القائمة المنسدلة للإصدار هي إصدار Campaign Manager 360 API المستخدَم حاليًا.

المحرِّر القديم في Apps Script

يتم عرض معلومات الإصدار لـ Apps Script في مربّع حوار الخدمات المتقدّمة:

  1. من "محرِّر برمجة التطبيقات"، انتقِل إلى المراجع > خدمات Google المتقدّمة.
  2. حدِّد موقع Campaign Manager 360 API في قائمة الخدمات المتاحة.
  3. القيمة المحدّدة في القائمة المنسدلة للإصدار هي إصدار Campaign Manager 360 API المستخدَم حاليًا.

#C

يتم عرض معلومات الإصدار لمكتبة برامج Google API لنظام ‎ .NET في المواضع التالية:

  1. يتم تضمينها في اسم حزمة nuget ومساحة اسم الخدمة. 
    Google.Apis.Dfareporting.v3_4
  2. تم عرضها من خلال موقع إلكتروني علني تابع DfareportingService. 
    Console.WriteLine(DfareportingService.Version);

Java

يتم عرض معلومات الإصدار لمكتبة برامج Google API للغة Java في المواضع التالية:

  1. يتم تحديده في artifactId في Maven. 
    <dependency>
  <groupId>com.google.apis</groupId>
  <artifactId>google-api-services-dfareporting</artifactId>
  <version>v3.4-rev1-1.21.0</version>
</dependency>
  2. يتم تضمينها في اسم ملف JAR. 
    google-api-services-dfareporting-v3.4-rev1-1.21.0.jar
  3. تم عرضها من خلال موقع إلكتروني متاح للجميع على Dfareporting. 
    System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

يتم عرض معلومات الإصدار لمكتبة برامج Google API للغة PHP من خلال خاصيّة عامة من Google_Service_Dfareporting: 

$service = new Google_Service_Dfareporting($client)
print $service->version;

Python

لا تتضمّن مكتبة برامج Google API للغة Python (الإصدار 1 أو 2) إصدارًا. يتم تحديد إصدار واجهة برمجة التطبيقات المراد استخدامه كوسيطة لـ "أداة إنشاء المحتوى أثناء التصفّح": 

discovery.build('dfareporting', 'v3.4', http=http)

Ruby

لا تتضمّن الإصدارات الأقدم من 0.9 من مكتبة برامج Google API للغة Ruby رقم إصدار. يتم تحديد إصدار واجهة برمجة التطبيقات المطلوب استخدامه كوسيطة لإنشاء الخدمة: 

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)

بالنسبة إلى الإصدارات 0.9 والإصدارات الأحدث من مكتبة Google API Client Library للغة Ruby، يتم عرض الإصدار في مساحة اسم الخدمة: 

Google.Apis.DfareportingV3_4

دوِّن الإصدار الذي تستخدمه، لأنّك ستحتاج إلى هذه المعلومات لاحقًا.

الخطوة 2: تحديد حالة الإصدار

يسرد جدول إيقاف الإصدار حالة كل إصدار متاح حاليًا. ابحث عن إصدارك في هذه القائمة وحدِّد حالته على النحو التالي:

  1. إذا لم يتم إدراج أي تواريخ في عمودَي تاريخ الإيقاف وتاريخ الإيقاف النهائي، يعني ذلك أنّك تستخدم إصدارًا متوافقًا بالكامل.
  2. إذا كانت التواريخ مُدرَجة، يعني ذلك أنّ الإصدار الذي تستخدمه قديم حاليًا وسيتم إيقافه نهائيًا في التاريخ المحدّد.
  3. إذا لم يكن إصدارك مُدرَجًا، يعني ذلك أنّه تم إيقافه نهائيًا ولم يعُد متوافقًا.

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

الخطوة 3: ترقية الإصدارات

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

المحرِّر الجديد في Apps Script

يتوافق Google Apps Script مع جميع إصدارات واجهة برمجة التطبيقات Campaign Manager 360 API ويسمح لك باختيار الإصدار المراد استخدامه على أساس كل نص برمجي على حدة. لتغيير الإصدار المستخدَم في نص برمجي معيّن:

  1. من محرِّر Apps Script، انقر على إضافة خدمة .
  2. حدِّد موقع Campaign Manager 360 API في قائمة الخدمات المتاحة.
  3. يمكنك تغيير إصدار Campaign Manager 360 API المستخدَم من خلال القائمة المنسدلة للإصدار.
  4. انقر على إضافة لحفظ التغييرات.

المحرِّر القديم في Apps Script

يتوافق Google Apps Script مع جميع إصدارات واجهة برمجة التطبيقات Campaign Manager 360 API ويسمح لك باختيار الإصدار المراد استخدامه على أساس كل نص برمجي على حدة. لتغيير الإصدار المستخدَم في نص برمجي معيّن:

  1. من "محرِّر تطبيقات Google Script"، انتقِل إلى المراجع > خدمات Google المتقدّمة.
  2. حدِّد موقع Campaign Manager 360 API في قائمة الخدمات المتاحة.
  3. يمكنك تغيير إصدار Campaign Manager 360 API المستخدَم من خلال القائمة المنسدلة للإصدار.
  4. انقر على موافق لحفظ تغييراتك.

#C

توفّر مكتبة عميل Google API لنظام ‎ .NET إصدارات منفصلة لكل إصدار من Campaign Manager 360 API، ويتم توزيعها من خلال Nuget.

للحصول على تعليمات التثبيت التفصيلية أو خيارات تنزيل بديلة، يُرجى الرجوع إلى مستندات مكتبة العميل.

Java

توفّر مكتبة عميل Google API للغة Java إصدارات منفصلة لكل إصدار من Campaign Manager 360 API، ويتم توزيعها من خلال Maven.

للحصول على تعليمات التثبيت التفصيلية أو خيارات تنزيل بديلة، يُرجى الرجوع إلى مستندات مكتبة العميل.

PHP

توفّر مكتبة Google API Client Library للغة PHP إصدارات منفصلة لكل إصدار من Campaign Manager 360 API، ويتم توزيعها من خلال Packagist.

للحصول على تعليمات تفصيلية حول التثبيت أو خيارات تنزيل بديلة، يُرجى الرجوع إلى مستندات مكتبة العميل.

Python

تتوافق كلّ إصدارات مكتبة برامج Google API للغة Python (الإصدار 1 أو 2) مع جميع إصدارات واجهة برمجة التطبيقات Campaign Manager 360 API. ما عليك سوى تعديل سلسلة الإصدار التي يتم تمريرها كوسيطة إلى أداة إنشاء "الحملات أثناء التصفّح": 

discovery.build('dfareporting', 'v3.4', http=http)
 للحصول على تعليمات تفصيلية حول التثبيت أو خيارات تنزيل بديلة، يُرجى الرجوع إلى مستندات مكتبة العميل.

Ruby

تتوافق مكتبة Google API Client Library للغة Ruby الإصدار 0.8 والإصدارات الأقدم مع جميع إصدارات واجهة برمجة تطبيقات Campaign Manager 360. ما عليك سوى تعديل سلسلة الإصدار التي يتم تمريرها كمَعلمة إلى أداة إنشاء الخدمة: 

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)
 توفّر الإصدار 0.9 من مكتبة برامج Google API للغة Ruby والإصدارات الأحدث إصدارات منفصلة لكل إصدار من Campaign Manager 360 API، ويتم توزيعها من خلال RubyGems. للحصول على تعليمات تفصيلية حول التثبيت أو خيارات تنزيل بديلة، يُرجى الرجوع إلى مستندات مكتبة العميل.

الخطوة 4: معالجة الاختلافات في الإصدار

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

في هذه المرحلة، عليك مراجعة ملاحظات الإصدار، بدءًا من الإصدار التالي للإصدار الذي بدأت منه (الذي سجّلته في قسم سابق) ووصولاً إلى الإصدار الذي تريد الترقية إليه. يجب تفسير أقسام ملاحظات الإصدار على النحو التالي:

  • الميزات الجديدة: وظائف تمت إضافتها حديثًا
  • الميزات التي سيتم إيقافها نهائيًا: هي الوظائف التي تمت إزالتها من واجهة برمجة التطبيقات. سيتم تناول وظيفة الاستبدال في هذا القسم عند توفّرها.
  • المشاكل المعروفة: التغييرات التي لا تُعدّ إضافات أو عمليات إزالة على سبيل المثال، قد يتناول هذا القسم الحقول أو الطرق التي تمت إعادة تسميتها أو منطق التحقّق الذي تغيّر.

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

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

الاطّلاع على آخر المعلومات

كما ذكرنا سابقًا، يتم إصدار Campaign Manager 360 API وإيقافها نهائيًا بانتظام. يتم نشر آخر الأخبار حول الإصدارات الجديدة والإيقاف النهائي للميزات على القنوات التالية:

ننصحك بالاشتراك في قناة واحدة أو أكثر من هذه القنوات للاطّلاع على آخر أخبار واجهات برمجة التطبيقات.