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

يلخّص مثال الاستخدام هذا أداء حساب على مدار آخر 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/v20/customers/{customer_id}/googleAds:searchStream

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

في ما يلي مثال كامل على تعريف هذا التقرير، مُدرَج في طلب HTTP POST.

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