يُعدّ الاختبار خطوة مهمة في إنشاء عملية تكامل ناجحة مع 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 explorer.