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

ค้นหาข้อมูลทรัพยากรหรือข้อมูลเมตา

Google Ads Query Language สามารถค้นหาข้อมูลประเภทต่อไปนี้ใน 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แสดงถึงทูเพิลของแคมเปญและวันที่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 ครั้ง 1. รับออบเจ็กต์ Campaign จากฟิลด์ campaign ของแต่ละ GoogleAdsRow ใน การตอบกลับ 1. เปลี่ยนสถานะของแต่ละแคมเปญจาก PAUSED เป็น ENABLED 1. โทรหา 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