ภาษาของคำค้นหาใน Google Ads

ภาษาคําค้นหาของ Google Ads สามารถค้นหาข้อมูลต่อไปนี้ใน Google Ads API

ทรัพยากรและแอตทริบิวต์ กลุ่ม และเมตริกที่เกี่ยวข้องโดยใช้

GoogleAdsService Search หรือ SearchStream

ผลลัพธ์จากการค้นหา GoogleAdsService คือรายการอินสแตนซ์ GoogleAdsRow โดยที่ GoogleAdsRow แต่ละรายการแสดงถึงทรัพยากร หากมีการขอแอตทริบิวต์หรือเมตริกใดๆ แถวดังกล่าวจะมีฟิลด์เหล่านั้นด้วย หากมีการขอกลุ่ม ระบบจะแสดงแถวเพิ่มเติมสำหรับแต่ละกลุ่มทรัพยากรในคำตอบด้วย

ข้อมูลเมตาเกี่ยวกับฟิลด์และทรัพยากรที่ใช้ได้ใน

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 แต่ละรายการแสดงชุดค่าผสมของแคมเปญและวันที่ 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 ในบริการของทรัพยากรนั้นทันที เวิร์กโฟลว์ตัวอย่างมีดังนี้

1. เรียกใช้การค้นหาแคมเปญทั้งหมดที่ปัจจุบันมีสถานะเป็น PAUSED และการแสดงผลมากกว่า 1,000 ครั้ง
2. รับออบเจ็กต์ Campaign จากช่อง campaign ของ GoogleAdsRow แต่ละรายการในการตอบกลับ
3. เปลี่ยนสถานะของแต่ละแคมเปญจาก PAUSED เป็น ENABLED
4. โทรหา 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