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