أداة إنشاء الطلبات في "إعلانات Google" هي أداة تفاعلية مصمّمة لمساعدتك في إنشاء طلبات البحث والتحقّق من صحتها باستخدام "لغة طلبات البحث في إعلانات Google" (GAQL). سواء كنت مستخدمًا جديدًا أو متمرّسًا في "لغة طلبات البحث في إعلانات Google"، يمكن لأداة إنشاء طلبات البحث تبسيط عملية جلب البيانات التي تحتاج إليها بالضبط من Google Ads API.
المزايا
- سهولة الاستخدام: تُبسّط عملية كتابة طلبات البحث بلغة GAQL، بدون الحاجة إلى الإلمام بالصياغة المحدّدة والحقول المتاحة.
- إمكانية الاكتشاف: تساعد في استكشاف المراجع والحقول والشرائح والمقاييس المتاحة والعثور عليها ضمن نموذج بيانات Google Ads API.
- تقليل الأخطاء: من خلال توفير واجهة منظَّمة وقوائم منسدلة للخيارات الصالحة، تساعد هذه الأداة في منع أخطاء الصياغة والأخطاء الإملائية، ما يضمن صلاحية طلب البحث الذي تم إنشاؤه.
- إنشاء طلبات البحث بشكل أسرع: تُسرّع عملية التطوير من خلال أتمتة إنشاء سلاسل طلبات البحث.
- التحقّق من الصحة: ترتبط الأداة بمستكشف واجهات برمجة التطبيقات وأداة التحقّق من صحة طلبات البحث، وذلك للتحقّق من طلبات البحث مقارنةً بقواعد واجهة برمجة التطبيقات قبل تنفيذها.
آلية العمل
توفّر أداة إنشاء الطلبات في "إعلانات Google" واجهة سهلة الاستخدام لتجميع طلبات البحث بلغة GAQL بشكل مرئي. في ما يلي سير العمل الأساسي:
- اختيار مرجع: ابدأ باختيار المرجع الأساسي من
علامة التبويب "المرجع" للإصدار
الذي تريد الاستعلام عنه. يتم وضع هذا المرجع في عبارة
FROM. تمثّل المراجع الكيانات ضمن "إعلانات Google"، مثلcampaignأوad_groupأوkeyword_view. تعرض أداة الإنشاء جميع المراجع المتاحة. - اختيار الحقول: بعد اختيار مرجع، تعرض الأداة جميع الحقول القابلة للاختيار، بما في ذلك السمات والشرائح والمقاييس المرتبطة بهذا المرجع والمراجع المنسوبة إليه (التي يمكن ربطها ضمنيًا). يمكنك وضع علامات في مربّعات الاختيار لتضمين الحقول في عبارة
SELECT. أثناء إجراء عمليات الاختيار، تنشئ الأداة ديناميكيًا سلسلة طلب البحث المقابلة بلغة GAQL، وتعرض أي أخطاء، وتزيل مجموعات الحقول غير المتوافقة. - تطبيق الفلاتر: أضِف شروط عبارة
WHEREلفلترة النتائج. تساعدك أداة الإنشاء في اختيار الحقول وعوامل التشغيل والقيم، ما يضمن استخدام الصياغة الصحيحة. - ترتيب النتائج: حدِّد أنظمة الترتيب باستخدام عبارة
ORDER BY. - ضبط الحدود: أضِف عبارة
LIMITللتحكّم في عدد النتائج المعروضة. - التحقّق من الصحة: ترشدك الأداة بطبيعتها إلى مجموعات الحقول الصالحة، وتربطك أيضًا بمستكشف واجهات برمجة التطبيقات حتى تتمكّن من اختبار طلب البحث مقارنةً ببيانات حسابك. تتوفّر أيضًا أداة منفصلة للتحقّق من صحة طلبات البحث يمكنك لصق طلبات البحث بلغة GAQL المكتوبة يدويًا والتحقّق منها.
- التصدير: بعد أن يصبح طلب البحث مناسبًا لك، انسخ سلسلة GAQL التي تم اختبارها والتي تتضمّن الصياغة الصحيحة والصقها في طلبات العميل
GoogleAdsService.SearchأوSearchStream.
تضمن أداة الإنشاء أنّ الحقول والشرائح والمقاييس المحدّدة متوافقة ويمكن استخدامها معًا في طلب بحث واحد، مع الإشارة إلى البيانات الوصفية الأساسية في Google Ads API.
البدء
تتوفّر طريقتان للوصول إلى أداة إنشاء طلبات البحث: الانتقال من خلال صفحة معيّنة في مستندات المرجع لإعداد التقارير، أو الاستكشاف من صفحة النظرة العامة على أداة إنشاء طلبات البحث.
من مستندات المرجع لإعداد التقارير
- ابدأ بـ مستندات المرجع لإعداد التقارير، واختَر مرجعًا معيّنًا للبدء به في قائمة جميع المراجع. بدلاً من ذلك، انتقِل مباشرةً إلى المرجع من لوحة التنقّل على يمين الصفحة.
- انقر على مساعدتي في إنشاء طلب بحث، ما ينقلك إلى أداة إنشاء طلبات البحث لهذا المرجع المحدّد.
من صفحة النظرة العامة على أداة إنشاء طلبات البحث
انتقِل إلى قسم "أداة إنشاء طلبات البحث " في مستندات المرجع لإعداد التقارير واختَر المرجع الذي تريد استكشافه.
التكامل مع الأدوات الأخرى
تم دمج أداة إنشاء طلبات البحث مع أدوات أخرى في حزمة أدوات المطوّرين في Google Ads API. يمكنك أخذ طلب بحث تم إنشاؤه في أداة إنشاء طلبات البحث واختباره في مستكشف واجهات برمجة التطبيقات أو التحقّق من صحته باستخدام أداة التحقّق من صحة طلبات البحث.
API Explorer
بعد إنشاء طلب البحث، انقر على تجربة طلب البحث في مستكشف واجهات برمجة التطبيقات لفتح طلب البحث في مستكشف واجهات برمجة التطبيقات. تتم تعبئة طلب البحث تلقائيًا في نص الطلب، ويمكنك بعد ذلك اختبار طلب البحث من خلال تشغيله مقارنةً ببيانات حسابك. يمكنك الاطّلاع على مستكشف واجهات برمجة التطبيقات لمزيد من المعلومات حول هذه الأداة.
أداة التحقّق من صحة طلبات البحث
عند النقر على إدخال طلب بحث أو تعديله، ستُفتح أداة التحقّق من صحة طلبات البحث. استخدِم أداة التحقّق من صحة طلبات البحث للتحقّق من صياغة طلب البحث. إنّ أي طلب بحث يتم إنشاؤه بالكامل من خلال أداة إنشاء طلبات البحث يتضمّن الصياغة الصحيحة، ولكن إذا كنت على دراية بالمرجع الذي تستعلم عنه، توفّر أداة التحقّق من صحة طلبات البحث طريقة سريعة لإدخال طلب بحث والتحقّق من صحته. يمكنك الاطّلاع على أداة التحقّق من صحة طلبات البحث لمزيد من المعلومات حول هذه الأداة.