Ví dụ về trường hợp sử dụng phổ biến

Giờ chúng ta hãy xem một trường hợp sử dụng phổ biến: tóm tắt hiệu suất của một tài khoản trong 30 ngày qua theo chiến dịch, được phân đoạn theo thiết bị. Cụm từ tìm kiếm về báo cáo này như sau:

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

Để đưa ra yêu cầu này, hãy chuyển câu lệnh Ngôn ngữ truy vấn Google Ads ở trên đến hàm GoogleAdsService.SearchStream .

Lưu ý quan trọng: Ví dụ này chỉ cho thấy yêu cầu HTTP cơ bản để cung cấp thông tin phương thức; bạn nên dùng một trong các thư viện ứng dụng để gửi yêu cầu trong ứng dụng của chính bạn.

URL yêu cầu HTTP

Yêu cầu bao gồm một yêu cầu POST qua HTTP tới máy chủ API Google Ads tại URL sau:

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

Mẫu yêu cầu HTTP hoàn chỉnh

Dưới đây là một ví dụ hoàn chỉnh về định nghĩa báo cáo ở trên, được đặt trong HTTP Yêu cầu 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"
}

Mã mẫu

Xem video hướng dẫn từng bước về một đoạn mã mẫu tìm kiếm chiến dịch theo chỉ số trong 7 ngày qua. Mã mẫu trong video được viết bằng Java, nhưng tương tự như đối với tất cả các ngôn ngữ.