الاختبار

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

الحسابات الاختبارية

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

حسابات الإنتاج المخصّصة للتطوير

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

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

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

في الوقت نفسه، يتطلّب استخدامها في مرحلة التطوير توخي الحذر الشديد. ننصح باتخاذ التدابير التالية:

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

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

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

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

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

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

طلب التحقق

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

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

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