لغة طلب البحث في "إعلانات شبكة البحث 360"

تتيح لك "لغة طلبات البحث في إعلانات شبكة البحث 360" إنشاء طلبات بحث لاسترداد بيانات التقارير وبيانات وصفية للموارد باستخدام Search Ads 360 Reporting API.

خدمات "بحث Google"

يمكنك استخدام "لغة طلبات البحث في إعلانات شبكة البحث 360" لطلب بيانات من واجهة برمجة التطبيقات باستخدام:

SearchAds360Service

استخدِم هذه الخدمة للاستعلام عن المراجع وسماتها وشرائحها ومقاييسها ذات الصلة. هناك طريقتان، Search وSearchStream.

تعرض طلبات البحث SearchAds360Service قائمة بـ SearchAds360Row من الحالات:

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

يمكنك الاطّلاع على إنشاء تقارير البحث لمزيد من المعلومات.

SearchAds360FieldService

استخدِم هذه الخدمة للاستعلام عن البيانات الوصفية حول الحقول والموارد المتاحة. توفّر الخدمة فهرسًا للحقول القابلة للبحث مع تفاصيل حول توافقها ونوعها.

تعرض SearchAds360FieldService قائمة بـ SearchAds360Field من الحالات التالية:

  • يحتوي كل حقل على تفاصيل حول الحقل المطلوب.

لمزيد من المعلومات، يمكنك الاطّلاع على استرداد البيانات الوصفية الخاصة بالمرجع.

أمثلة طلبات البحث الأساسية

تقدّم الأقسام التالية أمثلة أساسية على طلبات البحث يمكنك تعديلها لإنشاء طلبات البحث الخاصة بك.

طلب سمات مورد

هذا استعلام أساسي عن سمات المورد campaign يعرض معرّف الحملة واسمها وحالتها:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • يمثّل كل SearchAds360Row تم إرجاعه عنصر campaign.

  • تتم تعبئة الصفوف بالحقول المحدّدة (بما في ذلك resource_name للحملة المحدّدة).

  • ترتيب طلب البحث حسب رقم تعريف الحملة.

اطّلِع على campaign لمعرفة الحقول الأخرى المتاحة التي يمكنك استخدامها في طلبات البحث.

طلب البحث عن المقاييس

هذا طلب بحث أساسي عن مقاييس مرتبطة بسمات 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 وأكثر من 1,000 مرة ظهور.

  • يحتوي كل SearchAds360Row تم عرضه على حقل metrics يتضمّن المقاييس المحدّدة.

  • ترتيب طلب البحث حسب رقم تعريف الحملة.

اطّلِع على metrics لمعرفة المقاييس الأخرى المتاحة التي يمكنك استخدامها في طلبات البحث.

طلب البحث عن الشرائح

هذا هو طلب البحث الأساسي عن الشرائح المرتبطة بسمات المرجع campaign:

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 مرة ظهور.

  • ويقسّم البيانات حسب التاريخ.

  • نتيجةً لهذا التقسيم، يمثّل كل SearchAds360Row مجموعة من الحملات وشريحة التاريخ.

  • ترتيب طلب البحث حسب رقم تعريف الحملة.

اطّلِع على segments للحصول على قائمة بالشرائح التي يمكنك استخدامها في طلبات البحث، وعلى التقسيم للحصول على مزيد من المعلومات حول تقسيم تقاريرك.

هذا طلب بحث أساسي في المورد campaign يربط سمات المورد bidding_strategy، إذا كانت متاحة. يُعرف هذا النوع من المراجع ذات الصلة باسم مرجع مصدر.

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

  • يختار طلب البحث سمات الحملة والسمات ذات الصلة من كل حملة تم اختيارها.

  • يمثّل كل SearchAds360Row تم إرجاعه عنصر campaign تم ملؤه بسمات الحملة المحدّدة، بالإضافة إلى سمة استراتيجية عروض الأسعار المحدّدة، bidding_strategy.name.

راجِع campaign لمعرفة الموارد التي يمكن إسنادها والمتوفّرة لطلبات البحث في الحملات.

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

يمكنك استخدام SearchAds360FieldService لاسترداد البيانات الوصفية للحقول.

في ما يلي استعلام أساسي عن البيانات الوصفية للحقل:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • استبدِل RESOURCE OR FIELD بمورد (مثل customer أو campaign) أو حقل (مثل campaign.id أو metrics.impressions أو ad_group.id).

راجِع مقالة استرداد البيانات الوصفية الخاصة بالموارد لمزيد من المعلومات حول استرداد البيانات الوصفية للحقول.

مزيد من المعلومات

مزيد من المعلومات عن كيفية إنشاء طلبات البحث في Search Ads 360 Reporting API: