لغة طلب البحث في "إعلانات Google"

يمكن للغة طلب البحث في إعلانات Google إجراء طلب بحث في إعلانات Google API عن

الموارد والسمات والشرائح والمقاييس المرتبطة بها باستخدام

GoogleAdsService بحث أو SearchStream

نتيجة طلب بحث GoogleAdsService هي قائمة GoogleAdsRow مثال مع كل GoogleAdsRow تمثل موردًا. في حال طلب أي سمات أو مقاييس، يجب الصف أيضًا هذه الحقول. في حال طلب أي شرائح، يتم عرض صفًا إضافيًا لكل صف من مجموعات موارد الشرائح.

بيانات التعريف حول الحقول والموارد المتاحة في

GoogleAdsFieldService

توفر هذه الخدمة كتالوج من الحقول التي يمكن الاستعلام عنها مع تفاصيل حول توافقها ونوعها.

النتيجة من استعلام GoogleAdsFieldService هي قائمة GoogleAdsField مثيل مع كل GoogleAdsField تتضمن تفاصيل حول الحقل المطلوب.

الاستعلام عن سمات مورد

وفي ما يلي طلب بحث أساسي عن سمات مورد الحملة، لتوضيح كيف لعرض رقم تعريف الحملة واسمها وحالتها:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

يطلب هذا الطلب حسب رقم تعريف الحملة. سيمثل كل GoogleAdsRow ناتج تم ملء عنصر campaign بالحقول المحدّدة (بما في ذلك الحقول المحدّدة). resource_name للحملة).

لمعرفة الحقول الأخرى المتاحة لطلبات بحث الحملات، يُرجى الرجوع إلى المستندات المرجعية التي تخصّ Campaign

الاستعلام عن المقاييس

إلى جانب السمات المحددة لمورد معين، يمكنك أيضًا الاستعلام عن المقاييس ذات الصلة:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

تتم تصفية طلب البحث هذا فقط للحملات التي تحمل الحالة PAUSED على أكثر من 1000 مرة ظهور، بينما تم الترتيب حسب رقم تعريف الحملة. على كل ستؤدي GoogleAdsRow إلى تضمين الحقل metrics معبأ المقاييس المحددة.

للحصول على قائمة بالمقاييس التي يمكن طلبها، راجِع Metrics. المستندات.

الاستعلام عن الشرائح

إلى جانب السمات المحددة لمورد معين، يمكنك أيضًا الاستعلام عن شرائح الجمهور ذات الصلة:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id

وعلى غرار الاستعلام عن المقاييس، يعمل طلب البحث هذا فقط على تصفية الحملات أن تكون بالحالة PAUSED ولديك أكثر من 1,000 مرة ظهور وَلَكِنْ يعمل هذا الاستعلام على تقسيم البيانات حسب التاريخ. يؤدي هذا إلى كل نتيجة تمثّل السمة GoogleAdsRow صفًا من إحدى الحملات والتاريخ Segment. من المهم أن نلاحظ أن التقسيم يقسم المقاييس المحددة، ويتم تجميعها حسب كل في عبارة SELECT.

للحصول على قائمة بالشرائح التي يمكن طلب البحث عنها، يُرجى الرجوع إلى Segments. المستندات.

الاستعلام عن سمات مورد ذي صلة

في طلب لمورد معيّن، قد تتمكن من الانضمام إلى مراجع أخرى ذات صلة إذا كان ذلك متاحًا. وتُعرف هذه الموارد ذات الصلة باسم "المصادر الموارد". يمكنك الانضمام إلى الموارد المُحالة ضمنيًا عن طريق اختيار السمة في استعلامك.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

لا يختار هذا الطلب سمات الحملات فحسب، بل يستقطب أيضًا من كل حملة تم اختيارها. يمثل كل GoogleAdsRow ناتج عنصر campaign تمت تعبئته بسمات الحملات المحدّدة بالإضافة إلى سمة استراتيجية عروض الأسعار المحدّدة bidding_strategy.name

للتعرّف على الموارد المُحالة المتاحة لطلبات البحث في الحملات، راجِع مستندات Campaign المرجعية.

التبديل استنادًا إلى نتائج طلب البحث

عند الاستعلام عن مورد معين، يمكنك أن تأخذ فورًا الموارد التي تم إرجاعها ككائنات، وتعديلها، وإعادة إرسالها إلى طريقة mutate في تلك خدمة المورد. في ما يلي نموذج لسير العمل:

1. تنفيذ طلب بحث لجميع الحملات PAUSED حاليًا والتي تحتوي على مرة ظهور أكبر من 1000.
2. احصل على كائن Campaign من الحقل "campaign" في كل GoogleAdsRow. الرد.
3. غيِّر حالة كلّ حملة من PAUSED إلى ENABLED.
4. الاتصال بالرقم CampaignService.MutateCampaigns تحتوي على الحملات المعدّلة لتعديلها.

البيانات الوصفية للحقل

إنّ طلبات البحث المُرسَلة إلى GoogleAdsFieldService مخصّصة لاسترداد البيانات الوصفية للحقول. يمكن استخدام هذه المعلومات لفهم كيفية استخدام الحقول معًا. في استعلام. وبما أن البيانات متوفرة من واجهة برمجة التطبيقات وتوفر البيانات الوصفية اللازمة للتحقق من صحة أو إنشاء استعلام، فإن هذا يتيح للمطورين إجراء بشكل آلي. إليك طلب البحث النموذجي للبيانات الوصفية:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

يمكنك استبدال <INSERT_RESOURCE_OR_FIELD> في طلب البحث هذا بأيٍّ من مورد (مثل customer أو campaign) أو حقل (مثل campaign.id، metrics.impressions أو ad_group.id).

نقطة رئيسية: يُرجى ملاحظة أنّه لا تتوفر عبارة FROM في طلب البحث هذا.

للحصول على قائمة بالحقول التي يمكن طلبها، يُرجى الرجوع إلى GoogleAdsField. المستندات.

أمثلة على الرموز البرمجية

تحتوي مكتبات البرامج على أمثلة على استخدام لغة طلب البحث في "إعلانات Google" باللغة GoogleAdsService يحتوي مجلد العمليات الأساسية على أمثلة مثل GetCampaigns وGetKeywords وSearchForGoogleAdsFields. يحتوي مجلد إعداد التقارير على مثال GetKeywordStats.