يُعدّ الاختبار خطوة مهمة في إنشاء عملية دمج ناجحة مع Google Ads API، سواء كنت في بداية عملية الدمج أو كنت بصدد صيانة تطبيق أو إضافة ميزات جديدة إلى عملية دمج حالية. يقدّم هذا الدليل بعض أفضل الممارسات لاختبار عملية الدمج مع Google Ads API.
الحسابات التجريبية وحسابات الإنتاج
تتوفّر حسابات تجريبية لأغراض التطوير. باستخدام الحسابات الاختبارية، يمكنك التأكّد من أنّ رمز التطبيق وإعداداته تعمل على النحو المنشود.
ومع ذلك، لا يمكن اختبار جميع الميزات في حساب اختباري.
عندما تمنعك قيود الحساب التجريبي من اختبار بعض الميزات في عملية الدمج، يمكنك بدلاً من ذلك استخدام حساب إنتاج لأغراض التطوير. تختلف حسابات الإنتاج المخصّصة للتطوير عن حسابات الاختبار بالطرق التالية:
- عرض إعلانات يمكن للمستخدمين رؤيتها
- طلب عناوين URL صالحة
- يجب الالتزام بالسياسات الإعلانية
بما أنّ حسابات الإنتاج تعرض الإعلانات، فإنّها تنشئ مقاييس تتيح لك اختبار تقارير الأداء، بالإضافة إلى إتاحة جميع الميزات الأخرى في Google Ads API. ومع ذلك، يتطلّب استخدامها في التطوير توخّي الحذر الشديد. ننصحك باتّخاذ الإجراءات التالية:
- لا تمنح إذن الوصول إلا للمستخدمين الذين يحتاجون إليه لأغراض التطوير.
- حدِّد ميزانية يومية ثابتة ومنخفضة للحساب.
- استخدِم حسابات الإنتاج لأغراض التطوير فقط عندما يتعذّر استخدام الحسابات التجريبية.
وبالتالي، لإجراء اختبار كامل لعملية الدمج، من المحتمل أن تحتاج إلى بيانات اعتماد اختبارية وبيانات اعتماد إنتاجية.
بيانات اعتماد الاختبار
للحدّ من خطر تعديل حسابات الإنتاج عن طريق الخطأ عند محاولة تعديل حسابات التطوير، ننصحك بالاحتفاظ بمجموعة من بيانات الاعتماد التجريبية منفصلة عن بيانات اعتماد تطبيقك المخصّص للإنتاج.
لإنشاء مجموعة من بيانات اعتماد الاختبار، اتّبِع الخطوات التالية:
- أنشئ حساب بريد إلكتروني (مثل api.test@example.com) أو حساب خدمة سيتم استخدامه لأغراض الاختبار فقط.
- أضِف هذا المستخدم أو حساب الخدمة كمستخدم صالح في حسابات "إعلانات Google" التي تجري اختبارات عليها. تأكَّد من منح مستويات الوصول المناسبة لهذا المستخدم أو حساب الخدمة. لا تمنح هذا المستخدم أو حساب الخدمة إذن الوصول إلى أي حسابات إنتاج.
- إذا كنت تستخدم مسار مصادقة المستخدمين في الإصدار 2.0 من OAuth بدلاً من مسار حساب الخدمة، عليك إنشاء رمز مميز لإعادة التحميل لحساب المستخدم التجريبي.
- استخدِم بيانات الاعتماد الجديدة هذه عند اختبار تطبيقك. يمكن إعادة استخدام رمز المطوّر ومعرّف العميل وسر العميل لأغراض الاختبار، لأنّها لا تؤثّر في تحديد حسابات "إعلانات Google" التي يمكن الوصول إليها.
طلب التحقق
إذا كنت بحاجة فقط إلى اختبار ما إذا كان الطلب صالحًا، مثلاً للتأكّد من أنّ الطلب منظَّم بشكل صحيح ولا ينتهك السياسات، يمكنك استخدام الحقل validate_only، وهو متاح لطلبات GoogleAdsService.SearchStream وGoogleAdsService.Search، بالإضافة إلى معظم طلبات التعديل.
راجِع المستندات المرجعية للتأكّد مما إذا كان هذا الحقل متاحًا لطريقة معيّنة.
واجهة برمجة تطبيقات REST
بالنسبة إلى الاختبارات المخصّصة، مثلاً للتحقّق من أنّ الطلب يؤدي إلى الناتج المتوقّع، يكون استخدام REST API غالبًا هو الخيار الأسهل. راجِع أمثلة REST للتعرّف على كيفية استخدام curl في تقديم الطلبات إلى واجهة REST API. يمكنك أيضًا تجربة الاختبار في REST explorer.