تلخّص حالة الاستخدام هذه أداء حساب خلال آخر 30 يومًا حسب الحملة، مع تقسيمها حسب الجهاز. يكون طلب البحث الخاص بهذا التقرير على النحو التالي:
SELECT
campaign.name,
campaign.status,
segments.device,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
لإصدار هذا الطلب، مرِّر عبارة "لغة طلبات البحث في إعلانات Google" هذه إلى واجهة
GoogleAdsService.SearchStream.
عنوان URL لطلب HTTP
يتألف الطلب من طلب HTTP POST إلى خادم Google Ads API على عنوان URL التالي:
https://googleads.googleapis.com/v22/customers/{customer_id}/googleAds:searchStream
مثال على طلب HTTP كامل
في ما يلي مثال كامل على تعريف هذا التقرير، وهو مضمّن في طلب HTTP POST.
POST /v22/customers/{customer_id}/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]
developer-token: [Enter developerToken here]
Parameters:
{
"query" : "SELECT campaign.name, campaign.status, segments.device,
metrics.impressions, metrics.clicks, metrics.ctr,
metrics.average_cpc, metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS"
}
عيّنات تعليمات برمجية
شاهِد فيديو يشرح بالتفصيل نموذج رمز برمجي يبحث عن الحملات التي تتضمّن مقاييس خلال آخر 7 أيام. تمت كتابة نموذج الرمز البرمجي هذا بلغة Java، ولكن العملية مشابهة لجميع اللغات.