ความช่วยเหลือ
เข้าสู่ระบบ

รับข้อมูลบทความ

ในเวิร์กโฟลว์ที่ต้องใช้ข้อมูลบทความบล็อก คุณสามารถใช้การดำเนินการรับข้อมูลบทความเพื่อดึงข้อมูลบทความจากร้านค้า Shopify ของคุณได้

ในหน้านี้

การกำหนดค่า

ช่อง

การดำเนินการรับข้อมูลบทความประกอบด้วยช่องต่างๆ ดังต่อไปนี้:

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

สตริงคำค้นหา

นี่คือตัวอย่างคำค้นหาสำหรับรับข้อมูลบทความที่เผยแพร่ในวันที่ผ่านมา:

published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'

ตัวแปร published_at คือตัวกรองที่มีอยู่ในคำค้นหาบทความ และสามารถใช้ได้หลายครั้งหรือใช้ร่วมกับตัวแปรอื่นๆ ได้ ตัวแปร Liquid แบบ scheduledAt จะใช้ได้ในเวิร์กโฟลว์ที่มีการใช้ทริกเกอร์เวลาที่กำหนด แท็ก Liquid แบบ date_minus คือแท็ก Flow แบบพิเศษที่จะช่วยให้คุณสามารถหักลบเวลาออกจากวันที่ได้

เมื่อค้นหาข้อมูล ข้อมูลต่อไปนี้จะเป็นประโยชน์:

  • รายการตัวกรองบทความที่พร้อมใช้งาน

  • คำค้นหาต้องเป็นไปตามไวยากรณ์ที่กำหนด

  • ค่าในช่องคำค้นหาไม่ได้มีการระบุเป็นเอกสารไว้เสมอไป ในบางกรณีคุณสามารถดูค่าเหล่านั้นได้ในเอกสารประกอบ API นอกจากนี้ คุณมักจะพบค่าในช่องต่างๆ ใน URL ในส่วนผู้ดูแลได้เมื่อคุณทำการกรอง ตัวอย่างเช่น หากต้องการค้นหาค่าคำค้นหาคำสั่งซื้อบางรายการ ให้กรองหน้าคำสั่งซื้อในส่วนผู้ดูแล แล้วตรวจสอบที่ URL

  • คุณสามารถรันหรือทดสอบคำค้นหาในร้านค้าของคุณได้โดยใช้แอป Shopify GraphiQL

  • โปรดระวังสิ่งที่จะเกิดขึ้นหากการค้นหาของคุณล้มเหลว บ่อยครั้งที่ API จะส่งคืนผลลัพธ์ทั้งหมด (แทนที่จะไม่ส่งคืนเลย)

ข้อมูลที่ส่งคืน

การดำเนินการรับข้อมูลทั้งหมดจะส่งคืนรายการทรัพยากรตั้งแต่ 0 ถึง 100 รายการ โดยคุณอาจต้องการใช้ข้อมูลนี้ในรูปแบบที่แตกต่างกันขึ้นอยู่กับกรณีการใช้งานของคุณ:

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

หากต้องการเข้าถึงข้อมูลที่ส่งคืนในขั้นตอนตามการดำเนินการนี้ ให้ใช้ตัวแปรที่ชื่อว่ารับข้อมูลบทความ ซึ่งเป็นรายการของบทความ คุณสามารถใช้ตัวแปรนี้ได้ในทั้งเงื่อนไขและการดำเนินการ ตัวอย่างเช่น คุณสามารถส่งรายการของบทความในการดำเนินการส่งอีเมลภายในในลักษณะนี้ได้:

{% for single_article in GetArticleData %}
    * {{ single_article.title }}
    {% endfor %}

ทริกเกอร์

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

ข้อมูลอ้างอิง API

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับ API ที่ใช้ในการดำเนินการนี้ โปรดดูที่คำค้นหาบทความ