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

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

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

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

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

محرر جديد لبرمجة التطبيقات

يتم عرض معلومات إصدار برمجة التطبيقات في مربع حوار الخدمات المتقدمة:

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

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

يتم عرض معلومات إصدار برمجة التطبيقات في مربع حوار الخدمات المتقدمة:

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

C#‎

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

1. يتم تضمين اسم حزمة nuget ومساحة الاسم للخدمة.

   Google.Apis.Dfareporting.v3_4

2. تم العرض من خلال موقع إلكتروني علني يضمّ DfareportingService.

   Console.WriteLine(DfareportingService.Version);

لغة Java

يتم عرض معلومات إصدار مكتبة عميل واجهة برمجة تطبيقات Google للغة جافا في الأماكن التالية:

1. محدّدة في العنصر الاصطناعي المخضرم.

   <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 للغة PHP عن طريق موقع عام لـ Google_Service_Dfareporting:

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

لغة Python

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

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

Ruby

لم يتم تحديد إصدارات مكتبة برامج "واجهة Google API" للإصدار < 0.9 من Ruby. يتم تحديد إصدار واجهة برمجة التطبيقات المُراد استخدامه كوسيطة لمنشئ الخدمة:

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

بالنسبة إلى "مكتبة عميل Google API" لإصدارات Ruby >= 0.9، يتم عرض الإصدار في مساحة اسم الخدمة:

Google.Apis.DfareportingV3_4

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

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

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

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

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

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

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

محرر جديد لبرمجة التطبيقات

يدعم النص البرمجي في Google Apps جميع إصدارات واجهة برمجة تطبيقات "مدير الحملة 360" ويتيح لك اختيار الإصدار المُراد استخدامه على أساس نص برمجي. لتغيير الإصدار المستخدم بواسطة نص برمجي معين:

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

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

يدعم النص البرمجي في Google Apps جميع إصدارات واجهة برمجة تطبيقات "مدير الحملة 360" ويتيح لك اختيار الإصدار المُراد استخدامه على أساس نص برمجي. لتغيير الإصدار المستخدم بواسطة نص برمجي معين:

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

C#‎

توفِّر مكتبة عميل "واجهة Google API" لنظام .NET إصدارات منفصلة لكل إصدار من "واجهة برمجة تطبيقات "مدير الحملة 360"" يتم توزيعها عبر Nuget.

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

لغة Java

توفِّر "مكتبة برامج Google API" للغة Java إصدارات منفصلة لكل إصدار من "واجهة برمجة تطبيقات "مدير الحملة 360"" يتم توزيعها من خلال Maven.

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

لغة PHP

توفِّر مكتبة برامج "واجهة Google API" للغة PHP إصدارات منفصلة لكل إصدار من "واجهة برمجة تطبيقات "مدير الحملة 360"" يتم توزيعها من خلال Packagist.

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

لغة Python

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

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

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

Ruby

تتوافق مكتبة عميل "واجهة Google API" للإصدار 0.8 من Ruby والإصدارات الأقدم مع جميع إصدارات واجهة برمجة تطبيقات "مدير الحملة 360". ما عليك سوى تعديل سلسلة الإصدار التي يتم تمريرها كوسيطة إلى منشئ الخدمة:

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

تقدّم مكتبة برامج "واجهة Google API" للإصدار 0.9 من Ruby إصدارات مختلفة لكل إصدار من واجهة برمجة تطبيقات "مدير الحملة 360" يتم توزيعها عبر برنامج RubyGems. للحصول على تعليمات تفصيلية عن التثبيت أو خيارات تنزيل بديلة، يُرجى الرجوع إلى وثائق مكتبة العميل.

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

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

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

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

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

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

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

كما ذكرنا سابقًا، تحدث عمليات إصدار وإيقاف واجهات برمجة التطبيقات في "مدير الحملة 360" بانتظام. يتم نشر التحديثات حول الإصدارات الجديدة، وعمليات الإيقاف، وإنهاء العمل بالقنوات التالية:

• مدونة مطوّري برامج إعلانات Google (الاشتراك في تنبيهات البريد الإلكتروني)
• منتدى واجهة برمجة تطبيقات "مدير الحملة 360"

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