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