تتيح لك لغة طلبات البحث في "إعلانات شبكة البحث 360" إنشاء طلبات بحث لاسترداد بيانات إعداد التقارير والبيانات الوصفية للموارد باستخدام Search Ads 360 Reporting API.
البحث في الخدمات
يمكنك استخدام لغة طلب البحث في "إعلانات شبكة البحث 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
- استبدِل المورد أو الحقل بمورد (مثل
customer
أوcampaign
) أو بحقل (مثلcampaign.id
أوmetrics.impressions
أوad_group.id
).
راجع استرداد البيانات الوصفية للموارد لمزيد من المعلومات حول استرداد البيانات الوصفية للحقل.
مزيد من المعلومات
اطّلِع على مزيد من المعلومات عن كيفية إنشاء طلبات البحث في Search Ads 360 Reporting API: