أداة إنشاء طلبات البحث في "إعلانات Google" هي أداة تفاعلية مصمّمة لمساعدتك في إنشاء طلبات البحث والتحقّق منها بشكلٍ تفاعلي باستخدام لغة طلبات البحث في "إعلانات Google" (GAQL). سواء كنت مستخدمًا جديدًا للغة GAQL أو مستخدمًا متمرّسًا، يمكن لأداة إنشاء طلبات البحث تبسيط عملية جلب البيانات التي تحتاج إليها تحديدًا من 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
بعد إنشاء طلب البحث، انقر على تجربة في مستكشف واجهات برمجة التطبيقات لفتح طلب البحث في مستكشف واجهات برمجة التطبيقات. ستتم تعبئة طلب البحث تلقائيًا في نص الطلب، ويمكنك بعد ذلك اختبار طلب البحث من خلال تشغيله مقابل بيانات حسابك. اطّلِع على مستكشف واجهات برمجة التطبيقات لمزيد من المعلومات حول هذه الأداة.
أداة التحقّق من صحة طلبات البحث
عند النقر على إدخال طلب بحث أو تعديله، ستفتح أداة التحقّق من صحة طلبات البحث. استخدِم أداة التحقّق من صحة طلبات البحث للتحقّق من صياغة طلب البحث. سيتضمّن أي طلب بحث تم إنشاؤه بالكامل من خلال أداة إنشاء طلبات البحث الصياغة الصحيحة، ولكن إذا كنت على دراية بالمرجع الذي تستعلم عنه، ستوفّر أداة التحقّق من صحة طلبات البحث طريقة سريعة لإدخال طلب بحث والتحقّق من صحته. اطّلِع على أداة التحقّق من صحة طلبات البحث لمزيد من المعلومات حول هذه الأداة.