ตัวอย่างกรณีการใช้งานทั่วไป

กรณีการใช้งานนี้สรุปประสิทธิภาพของบัญชีในช่วง 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 นี้ไปยัง GoogleAdsService.SearchStream อินเทอร์เฟซ

URL ของคําขอ HTTP

คําขอประกอบด้วย HTTP POST ไปยังเซิร์ฟเวอร์ Google Ads API ที่ URL ต่อไปนี้

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

แทนที่ {customer_id} ด้วยรหัสของบัญชี Google Ads ที่เฉพาะเจาะจงซึ่งคุณต้องการค้นหา อย่าใส่เครื่องหมายขีดกลางในรหัส หากต้องการดึงข้อมูลสําหรับบัญชีย่อย คุณต้องใช้รหัสของบัญชีย่อยนั้น การค้นหาด้วยรหัสบัญชีดูแลจัดการจะแสดงเฉพาะข้อมูลที่บัญชีดูแลจัดการนั้นเป็นเจ้าของโดยตรง และไม่รวมข้อมูลจากบัญชีย่อย

ตัวอย่างคําขอ 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"
}

ตัวอย่างโค้ด

ดูวิดีโอแนะนำทีละขั้นตอนของตัวอย่างโค้ดที่ค้นหาแคมเปญที่มีเมตริกในช่วง 7 วันที่ผ่านมา ตัวอย่างโค้ดนี้เขียนด้วยภาษา Java แต่กระบวนการจะคล้ายกันสําหรับทุกภาษา