مثال لحالة الاستخدام الشائعة

نلقي نظرة الآن على حالة استخدام شائعة، وهي تلخيص أداء حساب خلال آخر 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 من واجهة pyplot.

عنوان URL لطلب HTTP

يتألف الطلب من طلب HTTP POST لخادم Google Ads API على عنوان URL التالي:

https://googleads.googleapis.com/v17/customers/{customer_id}/googleAds:searchStream

إكمال نموذج طلب HTTP

في ما يلي مثال كامل لتعريف التقرير أعلاه، وهو مضمن في HTTP طلب POST

POST /v17/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، لكن العملية متشابهة لجميع اللغات.