ภาษาของคำค้นหาใน 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)

ประเด็นหลัก: โปรดทราบว่าไม่มีอนุประโยค FROM ในการค้นหานี้

ดูรายการฟิลด์ที่สามารถสอบถามได้ที่ GoogleAdsField เอกสารประกอบ

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

ไลบรารีของไคลเอ็นต์มีตัวอย่างการใช้ ภาษาของคำค้นหา Google Ads ในภาษาGoogleAdsService โฟลเดอร์การดำเนินงานพื้นฐานมี เช่น GetCampaigns, GetKeywords และ SearchForGoogleAdsFields โฟลเดอร์การรายงานมีตัวอย่าง GetKeywordStats