الاختبار

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

حسابات تجريبية

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

حسابات الإنتاج للتطوير

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

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

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

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

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

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

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

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

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

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

طلب التحقق

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

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

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