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

ภาษาของคำค้นหาของ Google Ads สามารถค้นหาใน Google Ads API ได้

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

GoogleAdsService ค้นหา หรือ SearchStream

ผลลัพธ์จากการค้นหา GoogleAdsService คือรายการอินสแตนซ์ GoogleAdsRow โดยแต่ละรายการ GoogleAdsRow เป็นตัวแทนของทรัพยากร หากมีการขอแอตทริบิวต์หรือเมตริก แถวจะมีช่องเหล่านั้นด้วย หากมีการขอกลุ่ม การตอบกลับจะแสดงแถวเพิ่มเติม 1 แถวสำหรับ 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

การเปลี่ยนรูปแบบตามผลการค้นหา

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

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 รายการ