ภาษาของคำค้นหาของ Google Ads สามารถค้นหา Google Ads API สำหรับ
- แหล่งข้อมูลและแอตทริบิวต์ กลุ่ม และเมตริกที่เกี่ยวข้องโดยใช้
GoogleAdsService
Search หรือ SearchStream- ผลลัพธ์จากการค้นหา GoogleAdsService คือรายการของอินสแตนซ์
GoogleAdsRow
โดยGoogleAdsRow
แต่ละรายการเป็นตัวแทนของทรัพยากร หากมีการขอแอตทริบิวต์หรือเมตริก แถวจะมีฟิลด์เหล่านั้นด้วย หากมีการขอกลุ่ม คำตอบจะแสดงแถวเพิ่มเติมสำหรับ Tuple ของทรัพยากรกลุ่มแต่ละรายการด้วย - ข้อมูลเมตาเกี่ยวกับช่องและทรัพยากรที่ใช้ได้ใน
GoogleAdsFieldService
บริการนี้มีแคตตาล็อกของช่องที่สืบค้นได้ที่มีข้อมูลเฉพาะเกี่ยวกับความเข้ากันได้และประเภทของช่อง
ผลลัพธ์จากการค้นหา
GoogleAdsFieldService
คือรายการอินสแตนซ์GoogleAdsField
โดยที่GoogleAdsField
แต่ละรายการมีรายละเอียดเกี่ยวกับช่องที่ขอ
การค้นหาแอตทริบิวต์ของทรัพยากร
ด้านล่างคือการค้นหาพื้นฐานของแอตทริบิวต์ของทรัพยากรแคมเปญ ซึ่งแสดงวิธีส่งคืนรหัส ชื่อ และสถานะแคมเปญ
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
การค้นหานี้จะเรียงลำดับตามรหัสแคมเปญ GoogleAdsRow
ที่ได้แต่ละรายการจะแสดงออบเจ็กต์ campaign
ที่มีการเติมข้อมูลในช่องที่เลือก (รวมถึง resource_name
ของแคมเปญนั้นๆ)
หากต้องการดูว่าช่องอื่นๆ นี้มีช่องใดบ้างสำหรับการค้นหาแคมเปญ โปรดดูเอกสารอ้างอิง Campaign
การค้นหาเมตริก
นอกจากแอตทริบิวต์ที่เลือกสำหรับทรัพยากรที่ระบุแล้ว คุณยังค้นหาเมตริกที่เกี่ยวข้องได้ด้วย
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
คำค้นหานี้จะกรองเฉพาะแคมเปญที่มีสถานะ PAUSED
และมีการแสดงผลมากกว่า 1, 000 ครั้ง โดยเรียงลำดับตามรหัสแคมเปญ แต่ละรายการผลลัพธ์ GoogleAdsRow
จะมีช่อง metrics
ซึ่งมีข้อมูลเมตริกที่เลือกรวมอยู่ด้วย
ดูรายการเมตริกที่สืบค้นได้ได้ในเอกสารประกอบ Metrics
การค้นหากลุ่ม
นอกจากแอตทริบิวต์ที่เลือกสำหรับทรัพยากรที่ระบุแล้ว คุณยังค้นหากลุ่มที่เกี่ยวข้องได้ด้วย โดยทำดังนี้
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions,
segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
เช่นเดียวกับการค้นหาเมตริก การค้นหานี้จะกรองเฉพาะแคมเปญที่มีสถานะ PAUSED
และมีการแสดงผลมากกว่า 1,000 ครั้ง อย่างไรก็ตาม การค้นหานี้จะแบ่งกลุ่มข้อมูลตามวันที่ ซึ่งจะนําไปยังผลลัพธ์ GoogleAdsRow
แต่ละรายการที่แสดง Tuple ของแคมเปญและวันที่ Segment
โปรดทราบว่าการแบ่งกลุ่มจะแบ่งเมตริกที่เลือก โดยจัดกลุ่มตามแต่ละกลุ่มในวลี SELECT
ดูรายการกลุ่มที่ค้นหาได้ในเอกสารประกอบเกี่ยวกับ Segments
การค้นหาแอตทริบิวต์ของทรัพยากรที่เกี่ยวข้อง
ในการค้นหาทรัพยากรหนึ่งๆ คุณอาจเข้าร่วมแหล่งข้อมูลที่เกี่ยวข้องอื่นๆ ได้ หากมี ทรัพยากรที่เกี่ยวข้องเหล่านี้เรียกว่า "ทรัพยากรที่มีการระบุแหล่งที่มา" คุณจะรวมกับทรัพยากรที่มีการระบุแหล่งที่มาโดยปริยายได้โดยเลือกแอตทริบิวต์ในการค้นหา
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
การค้นหานี้ไม่เพียงเลือกแอตทริบิวต์แคมเปญ แต่ยังดึงแอตทริบิวต์ที่เกี่ยวข้องจากแต่ละแคมเปญที่เลือกด้วย GoogleAdsRow
ที่ได้แต่ละรายการจะแสดงออบเจ็กต์ campaign
ซึ่งมีแอตทริบิวต์แคมเปญที่เลือก รวมถึงแอตทริบิวต์กลยุทธ์การเสนอราคาที่เลือก bidding_strategy.name
หากต้องการดูว่าทรัพยากรที่มีการระบุแหล่งที่มาใดใช้ได้กับการค้นหาแคมเปญ โปรดดูเอกสารอ้างอิง Campaign
การเปลี่ยนรูปแบบตามผลการค้นหา
เมื่อค้นหาทรัพยากรที่กำหนด คุณสามารถนำผลลัพธ์ที่แสดงออกมาเป็นออบเจ็กต์ แก้ไข และส่งกลับไปยังเมธอด Mutate ในบริการของทรัพยากรนั้นได้ ตัวอย่างเวิร์กโฟลว์มีดังนี้
- ดำเนินการค้นหาแคมเปญทั้งหมดที่ขณะนี้มี
PAUSED
และมีการแสดงผลมากกว่า 1,000 ครั้ง - รับออบเจ็กต์
Campaign
จากช่องcampaign
ของGoogleAdsRow
แต่ละรายการในคำตอบ - เปลี่ยนสถานะของแต่ละแคมเปญจาก
PAUSED
เป็นENABLED
- โทรหา
CampaignService.MutateCampaigns
พร้อมแคมเปญที่แก้ไขแล้วเพื่ออัปเดต
ข้อมูลเมตาของช่อง
คำค้นหาที่ส่งไปยัง GoogleAdsFieldService
มีไว้เพื่อดึงข้อมูลเมตาของช่อง
ข้อมูลนี้ใช้เพื่อทำความเข้าใจวิธีนำช่องเหล่านั้นมาใช้ร่วมกันในการค้นหา เนื่องจากข้อมูลพร้อมใช้งานจาก API และมีข้อมูลเมตาที่จำเป็นซึ่งจำเป็นต่อการตรวจสอบหรือสร้างคำค้นหา ทำให้นักพัฒนาซอฟต์แวร์สามารถเขียนโปรแกรมได้ ต่อไปนี้คือคำค้นหาที่ใช้กันโดยทั่วไปสำหรับข้อมูลเมตา
SELECT
name,
category,
selectable,
filterable,
sortable,
selectable_with,
data_type,
is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"
คุณแทนที่ <INSERT_RESOURCE_OR_FIELD>
ในการค้นหานี้ด้วยทรัพยากร (เช่น customer
หรือ campaign
) หรือช่อง (เช่น campaign.id
,metrics.impressions
หรือ ad_group.id
) ได้
โปรดดูรายการช่องที่ขอได้ในเอกสารประกอบเกี่ยวกับ GoogleAdsField
ตัวอย่างโค้ด
ไลบรารีของไคลเอ็นต์มีตัวอย่างการใช้ภาษาของคำค้นหาของ Google Ads ใน GoogleAdsService
โฟลเดอร์การดำเนินการพื้นฐานมีตัวอย่างต่างๆ เช่น GetCampaigns
, GetKeywords
และ SearchForGoogleAdsFields
โฟลเดอร์การรายงานมีตัวอย่าง GetKeywordStats