الاختبار

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

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

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

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

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

  • عرض إعلانات يمكن للمستخدمين رؤيتها
  • طلب عناوين URL صالحة
  • يجب أن تكون متوافقة مع السياسات الإعلانية

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

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

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

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

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

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

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

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

طلب التحقق

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

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

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