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

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