يُعدّ الاختبار خطوة مهمة في إنشاء عملية دمج ناجحة مع Google Ads API، سواء كنت في بداية الطريق أو كنت تحتفظ بتطبيق أو تضيف ميزات جديدة إلى عملية دمج حالية. يقدّم هذا الدليل بعض أفضل الممارسات لاختبار عملية الدمج مع Google Ads API.
الحسابات التجريبية وحسابات الإنتاج
تتوفّر حسابات تجريبية لأغراض التطوير. باستخدام الحسابات الاختبارية، يمكنك التحقّق من أنّ الرمز البرمجي للتطبيق وإعداداته يعملان على النحو المطلوب.
ومع ذلك، لا يمكن اختبار جميع الميزات في حساب اختباري.
عندما تمنعك قيود الحساب الاختباري من اختبار بعض الميزات في عملية الدمج، يمكنك بدلاً من ذلك استخدام حساب إنتاج للتطوير. يجب أن يتضمّن مشروعك على Google Cloud مستوى الوصول Explorer (Explorer أو Basic أو Standard) على الأقل لاستدعاء حساب إنتاج. يُرجى العِلم أنّ إذن الوصول Explorer يظلّ يقيّد بعض الخدمات، بما في ذلك الفوترة (BillingSetupService وAccountBudgetProposalService) والتخطيط وإنشاء الحساب ودعوات المستخدمين (راجِع قيود ميزة Explorer)، والتي تتطلّب إذن الوصول Basic أو Standard. ستؤدي محاولة الاتصال بحساب إنتاج من مشروع بمستوى الوصول التجريبي إلى عرض الخطأ 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. يمكنك أيضًا تجربة الاختبار في مستكشف REST.