نلقي الآن نظرة على حالة استخدام شائعة، وهي تلخيص أداء أحد الحسابات على مدار آخر 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
يتكون الطلب من طريقة POST لبروتوكول HTTP إلى خادم Google Ads API على عنوان URL التالي:
https://googleads.googleapis.com/v16/customers/{customer_id}/googleAds:searchStream
نموذج إكمال طلب HTTP
إليك مثال كامل لتعريف التقرير أعلاه، والذي تم تضمينه في طلب HTTP POST.
POST /v16/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، ولكن العملية مشابهة لجميع اللغات.