في 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
، يمكنك العثور على موارده في الصفحة المرجعية.