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