โครงสร้างการค้นหา

คุณสามารถส่งการค้นหาสำหรับช่องเมตริกและกลุ่มไปยัง reports.search ได้ หากต้องการสร้างคำค้นหาในภาษาการค้นหาของ Merchant Center ก่อนอื่นคุณต้องเขียน โดยใช้ไวยากรณ์ภาษา ข้อความค้นหาประกอบด้วยวลีต่อไปนี้

  • SELECT
  • FROM
  • WHERE
  • ORDER BY
  • LIMIT

วรรคจะใช้ชื่อช่อง ชื่อตาราง โอเปอเรเตอร์ เงื่อนไข และ คำสั่งซื้อเพื่อช่วยคุณเลือกข้อมูลที่ต้องการ เมื่อรวมกันเป็นรายการเดียว คุณจะส่งคำขอโดยใช้ Google Content API for Shopping ได้ มาดูกันว่าแต่ละ สามารถใช้วลี

ข้อกำหนด

เลือก

คำสั่ง SELECT ระบุชุดช่องที่จะดึงข้อมูลในคำขอ SELECT จะใช้รายการช่องกลุ่มและเมตริกที่คั่นด้วยคอมมา ซึ่งแสดงผลค่า ในการตอบกลับ ต้องระบุการค้นหาด้วยอนุประโยค SELECT

ตัวอย่างการค้นหาที่เลือกเมตริกการคลิกจากตารางที่ระบุมีดังนี้

SELECT
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

นอกจากนี้ คุณยังค้นหาช่องประเภทต่างๆ ในคำขอเดียวได้ด้วย

SELECT
  segments.date,
  segments.program,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
  • ฟิลด์กลุ่ม

    • segments.date
    • segments.program
  • เมตริก

    • metrics.impressions
    • metrics.clicks

ไม่อนุญาตให้ใช้บางช่องในวรรค SELECT เนื่องจากสาเหตุต่อไปนี้ ข้อจำกัด:

  • การค้นหาช่องกลุ่มที่ไม่มีช่องเมตริกอย่างน้อย 1 ช่อง

ข้อมูลที่เกี่ยวข้องกับเงื่อนไขข้างต้นสามารถพบได้ในเอกสารอ้างอิงของเรา

จาก

อนุประโยค FROM ระบุตารางที่จะดึงข้อมูลในคำขอ ตารางในวลี FROM จะกำหนดฟิลด์ที่ใช้ได้โดยรายการอื่นทั้งหมด สำหรับข้อความค้นหาที่ระบุ คุณสามารถระบุตารางใน ข้อความ FROM ปัจจุบันรองรับเฉพาะตาราง MerchantPerformanceView เท่านั้น อนุประโยค FROM ต้องมี ในการค้นหาสำหรับเมธอด search ในเมธอด reports

ที่ไหน

อนุประโยค WHERE ระบุเงื่อนไขที่จะใช้เมื่อกรองข้อมูลสำหรับ อีกครั้ง เมื่อใช้วลี WHERE คุณจะระบุเงื่อนไขได้อย่างน้อย 1 รายการ ใช้ AND ในการแยกแคมเปญ แต่ละเงื่อนไขควรเป็นไปตามรูปแบบ field_name Operator value ช่องกลุ่มใดก็ได้ที่ใช้ใน WHERE แต่จำเป็นต้องระบุฟิลด์เมตริกในวรรค SELECT เพื่อ ที่ใช้ในวรรค WHERE ต้องระบุวลี WHERE ในการค้นหา เพราะคุณต้องระบุช่วงวันที่ไว้เสมอ ผลลัพธ์ข้อมูลประสิทธิภาพ

ต่อไปนี้เป็นตัวอย่างของการใช้ WHERE เพื่อแสดงผลเมตริกจากเวลาที่ระบุ ระยะเวลา:

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

โดยคุณสามารถรวมหลายเงื่อนไขเข้าด้วยกันเพื่อกรองข้อมูลได้ ตัวอย่างนี้จะแสดงผล จำนวนคลิกต่อข้อเสนอพิเศษสำหรับโปรแกรม SHOPPING_ADS การคลิก > 100 ภายในระยะเวลา 30 วันที่กำหนด

SELECT
  segments.offer_id,
  segments.program,
  metrics.clicks
FROM MerchantPerformanceView
WHERE metrics.clicks > 100
  AND segments.program = SHOPPING_ADS
  AND segments.date BETWEEN 2020-08-01 AND 2020-08-31;

ในการค้นหาต่อไปนี้ คุณจะเห็นว่ามีการเลือก segments.date ไว้ ไม่ว่าคุณจะเลือก segments.date หรือไม่ ช่วงวันที่ที่แน่นอนใน ต้องมีวรรค WHERE เสมอเพื่อเรียกข้อมูลประสิทธิภาพ

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

คุณต้องคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่เมื่อกรอง ในใจ

สำหรับรายการผู้ให้บริการทั้งหมด โปรดดูที่ ไวยากรณ์ภาษา

ORDER BY

วรรค ORDER BY จะระบุลำดับของผลลัพธ์ ส่งคืนแล้ว ซึ่งจะช่วยให้คุณจัดเรียงข้อมูลตามลำดับจากน้อยไปมากหรือมากไปน้อยได้ ตามชื่อฟิลด์ การสั่งซื้อแต่ละรายการจะระบุเป็น field_name ตามด้วย ASCหรือDESC หากไม่ได้ระบุ ASC และ DESC ไว้ ค่าเริ่มต้นของคำสั่งซื้อ ไปยัง ASC เฉพาะช่องที่ระบุไว้ในวรรค SELECT เท่านั้นที่ใช้ได้ใน ORDER BY ข้อ วลี ORDER BY เป็นไม่บังคับในการค้นหา

ข้อความค้นหาต่อไปนี้เรียงลำดับแถวที่แสดงผลตามจำนวนคลิกจากสูงสุดถึง ต่ำสุด:

SELECT
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY metrics.clicks DESC

คุณระบุช่องหลายช่องในคำสั่ง ORDER BY ได้โดยใช้คอมมา รายการ การเรียงลำดับจะเกิดขึ้นในลำดับเดียวกับที่ระบุไว้ในการค้นหา ตัวอย่างเช่น ในคำค้นหานี้ ผลลัพธ์จะจัดเรียงจากน้อยไปมาก offer_id จากนั้นเรียงลำดับจากมากไปหาน้อยตามจำนวนการแสดงผล จากนั้นใน ลำดับจากมากไปน้อยตามจำนวนคลิก:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY
  segments.offer_id,
  metrics.impressions DESC,
  metrics.clicks DESC

LIMIT

คำสั่ง LIMIT ช่วยให้คุณระบุจำนวนผลลัพธ์ที่จะส่งคืนได้ วิธีนี้เป็นประโยชน์หากคุณสนใจเฉพาะข้อมูลสรุป

ตัวอย่างเช่น LIMIT สามารถใช้เพื่อจำกัดจำนวนผลลัพธ์ทั้งหมดสำหรับ คำค้นหาต่อไปนี้:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY metrics.impressions DESC
LIMIT 50