مثال مورد استفاده رایج

این مورد استفاده، عملکرد یک حساب را در 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 Ads Query Language را به رابط GoogleAdsService.SearchStream ارسال کنید.

نکته کلیدی: این مثال درخواست اصلی HTTP را فقط به عنوان یک روش آموزشی نشان می دهد. ما شما را تشویق می کنیم که از یکی از کتابخانه های مشتری برای ارسال درخواست ها در برنامه خود استفاده کنید.

URL درخواست HTTP

این درخواست شامل یک HTTP POST به سرور Google Ads API در URL زیر است:

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

نمونه درخواست HTTP را کامل کنید

در اینجا یک مثال کامل از این تعریف گزارش است که در یک درخواست HTTP POST محصور شده است.

POST /v21/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 روز گذشته جستجو می‌کند، تماشا کنید. این نمونه کد در جاوا نوشته شده است، اما فرآیند برای همه زبان ها مشابه است.