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

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

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

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

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

محرِّر "برمجة تطبيقات Google" الجديد

تظهر معلومات الإصدار الخاصة بـ "برمجة تطبيقات Google" في مربّع الحوار الخاص بالخدمات المتقدّمة:

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

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

تظهر معلومات الإصدار الخاصة بـ "برمجة تطبيقات Google" في مربّع الحوار الخاص بالخدمات المتقدّمة:

  1. من "محرّر نصوص Apps Script"، انتقِل إلى المراجع > خدمات 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);

جافا

تتوفّر معلومات الإصدار الخاصة بمكتبة عميل 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 Client Library للغة PHP باستخدام سمة عامة من Google_Service_Dfareporting: 

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

Python

لا تتضمّن مكتبة عملاء Google API للغة Python (v1/v2) أرقام إصدارات. يتم تحديد إصدار واجهة برمجة التطبيقات المطلوب استخدامه كمعلَمة لأداة إنشاء الاكتشاف: 

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

Ruby

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

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

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

Google.Apis.DfareportingV3_4

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

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

إذا كانت نسختك مُدرَجة، راجِع عمودَي تاريخ الإيقاف النهائي وتاريخ الإيقاف:

  • إذا لم تظهر أي تواريخ، يعني ذلك أنّ الإصدار متوافق تمامًا.
  • إذا كانت التواريخ متوفّرة، يعني ذلك أنّه تم إيقاف إصدارك نهائيًا وسيتم إيقافه في التاريخ المحدّد.

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

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

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

محرِّر "برمجة تطبيقات Google" الجديد

تتوافق 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. من "محرّر نصوص Apps Script"، انتقِل إلى المراجع > خدمات Google المتقدّمة.
  2. ابحث عن Campaign Manager 360 API في قائمة الخدمات المتاحة.
  3. غيِّر إصدار Campaign Manager 360 API باستخدام القائمة المنسدلة الخاصة بالإصدار.
  4. انقر على موافق لحفظ تغييراتك.

#C

توفّر &quot;مكتبة عميل Google API&quot; لنظام ‎NET إصدارات منفصلة لكل إصدار من Campaign Manager 360 API، ويتم توزيعها من خلال NuGet. حدِّث مكتبة العميل إلى إصدار يتوافق مع إصدار واجهة برمجة التطبيقات الذي تريد استخدامه.

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

جافا

توفّر &quot;مكتبة عميل واجهة Google API للغة Java&quot; إصدارات منفصلة لكل إصدار من Campaign Manager 360 API، ويتم توزيعها من خلال Maven. حدِّث مكتبة العميل إلى إصدار يتوافق مع إصدار واجهة برمجة التطبيقات الذي تريد استخدامه.

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

PHP

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

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

Python

يتوافق كل إصدار من Google API Client Library للغة Python (الإصدار 1 أو 2) مع جميع إصدارات Campaign Manager 360 API. للانتقال إلى إصدار جديد من Campaign Manager 360 API، عدِّل سلسلة الإصدار التي يتم تمريرها كمعلَمة إلى أداة إنشاء الاكتشاف: 

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

Ruby

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

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

REST

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

على سبيل المثال، عند نقل البيانات من v4 إلى v5، عليك تغيير عنوان URL الأساسي من: 

https://dfareporting.googleapis.com/dfareporting/v4/...
 إلى: 
https://dfareporting.googleapis.com/dfareporting/v5/...

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

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

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

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

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

متابعة آخر الأخبار

ننصحك بمتابعة مدونة مطوّري البرامج على "إعلانات Google" بانتظام لتكون أوّل من يعلم بشأن إصدارات واجهة برمجة التطبيقات وإيقافها نهائيًا.