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