في 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
في صفحة المراجع الخاصة بها.