الاختبار

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

اختبار الحسابات

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

حسابات الإنتاج المخصّصة للتطوير

إذا كانت قيود الحساب التجريبي لا تتيح لك اختبار بعض الميزات في عملية الدمج، يمكنك بدلاً من ذلك استخدام حساب إنتاج لإجراء عملية التطوير. تختلف حسابات الإنتاج المخصّصة للتطوير عن الحسابات التجريبية في النواحي التالية:

نظرًا لأن حسابات الإنتاج تعرض الإعلانات، فهي تنشئ مقاييس تتيح لك اختبار تقارير الأداء، بالإضافة إلى إتاحة كل الميزات الأخرى في Google Ads API.

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

  • لا تمنح إذن الوصول إلا للمستخدمين الذين يحتاجون إليه لأغراض التطوير.
  • تحديد ميزانية يومية ثابتة ومنخفضة للحساب
  • لا تستخدم حسابات الإنتاج للتطوير إلا عندما يتعذّر استخدام الحسابات الاختبارية.

بيانات الاعتماد الاختبارية

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

ننصحك أيضًا بإنشاء رموز مميّزة منفصلة لإعادة التحميل لأغراض التطوير.

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

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

طلب التحقق

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

واجهة برمجة تطبيقات REST

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