في Google Ads API، يتم تمثيل كل تقرير عن المعايير بمورد منفصل.
ما لم يكن ذلك ضروريًا، لا تتضمّن موارد *_view
سوى حقل resource_name
.
ويجب أن يحدّد عملاء Google Ads API حقول ad_group_criterion
أو
campaign_criterion
المقابلة إذا كانت هناك حاجة لاسترجاع بيانات محدّدة للمعايير.
يتيح ذلك لعملاء Google Ads API طلب الحقول ad_group_criterion
أو campaign_criterion
والمورد *_view
في الطلب نفسه من خلال طريقة
GoogleAdsService.SearchStream
.
نموذج لطلب بحث
SELECT
ad_group_criterion.keyword.text,
ad_group.name,
campaign.name,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS
لاسترداد بيانات الأداء (المقاييس) لنوع معيّن من المعايير، حدِّد
مورد الملف الشخصي المقابل له في عبارة FROM
. على سبيل المثال، يمكنك استخدام
keyword_view
في عبارة FROM
وبعض حقول metrics
في العبارة SELECT
لاسترداد مقاييس الكلمات الرئيسية.
يمكنك اختيار الحقول من الموارد الرئيسية وصولاً إلى customer
من عرض المعايير. على سبيل المثال، عند اختيار FROM
keyword_view
، يمكنك طلب الحقول من جميع الموارد التالية:
ad_group_criterion
ad_group
campaign
customer
يمكنك معرفة الموارد التي يمكن طلبها بهذه الطريقة لمورد معيّن من خلال وضع علامة في المربّع بجانب صف موارد السمات في الصفحة المرجعية الخاصة به. على سبيل المثال، يمكنك العثور على الموارد الخاصة بالموقع الإلكتروني keyword_view
في الصفحة المرجعية.