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

اکنون نگاهی به یک مورد استفاده متداول می اندازیم: خلاصه کردن عملکرد یک حساب در 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/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 روز گذشته جستجو می‌کند، تماشا کنید. نمونه کد موجود در ویدیو به زبان جاوا نوشته شده است، اما این روند برای همه زبان ها مشابه است.