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

ภาษาของคำค้นหาของ 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 ในบริการของทรัพยากรนั้นได้ ตัวอย่างเวิร์กโฟลว์มีดังนี้

  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 โฟลเดอร์การรายงานมีตัวอย่าง GetKeywordStats

ถัดไป
ไวยากรณ์ของคําค้นหา