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

این مورد استفاده، عملکرد یک حساب کاربری را در 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

برای صدور این درخواست، این عبارت زبان جستجوی گوگل ادز را به رابط GoogleAdsService.SearchStream ارسال کنید.

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

آدرس درخواست HTTP

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

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

به جای {customer_id} ، شناسه حساب کاربری گوگل ادز خاصی را که می‌خواهید جستجو کنید، قرار دهید. در شناسه خط فاصله نگذارید. اگر می‌خواهید داده‌های یک زیرحساب را بازیابی کنید، باید از شناسه آن زیرحساب استفاده کنید. جستجو با شناسه حساب کاربری مدیر فقط داده‌هایی را که مستقیماً متعلق به آن حساب کاربری مدیر است، برمی‌گرداند و داده‌هایی از زیرحساب‌های آن را شامل نمی‌شود.

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

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

POST /v24/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"
}

نمونه‌های کد

ویدیوی آموزشی نمونه کدی را تماشا کنید که کمپین‌ها را با استفاده از معیارها در ۷ روز گذشته جستجو می‌کند. این نمونه کد به زبان جاوا نوشته شده است، اما روند کار برای همه زبان‌ها مشابه است.