Shopify Flow และ GraphQL Admin API

Flow ใช้ Shopify GraphQL Admin API เพื่อสร้างการทำงานอัตโนมัติและการผสานการทำงานที่ช่วยขยายและปรับปรุงส่วนผู้ดูแล Shopify Flow ใช้ API เวอร์ชัน 2026-01 เพื่อประเมินเงื่อนไขและตัวแปรในเวิร์กโฟลว์ รวมถึงดำเนินการในร้านค้า Shopify ของคุณ เนื่องจาก Flow เข้าถึงข้อมูลร้านค้าโดยการเรียกใช้ API คุณจึงสามารถเข้าถึงฟิลด์เกือบทั้งหมดที่มีใน API ได้จาก Flow

เนื่องจาก Shopify เปิดตัว API เวอร์ชันใหม่ทุกๆ 3 เดือน เวิร์กโฟลว์บางรายการจึงอาจต้องอัปเดตเมื่อมีการเปลี่ยนแปลงหรือเลิกใช้งานฟิลด์

การใช้ GraphQL Admin API ในเวิร์กโฟลว์

การดำเนินการส่วนใหญ่ใน Flow ใช้ GraphQL Admin API เพื่อทำการเปลี่ยนแปลงร้านค้า Shopify ของคุณ ตัวอย่างเช่น การดำเนินการเพิ่มแท็กคำสั่งซื้อจะใช้คำสั่งเปลี่ยนแปลงข้อมูล tagsAdd การดำเนินการส่งคำขอ Admin API สามารถใช้คำสั่งเปลี่ยนแปลงข้อมูลส่วนใหญ่ได้ รวมถึงคำสั่งที่ยังไม่มีให้ใช้เป็นการดำเนินการใน Flow

เมื่อคุณสร้างเวิร์กโฟลว์ คุณมักจะพบชื่อฟิลด์และคำอธิบายที่อิงตามไวยากรณ์ของ GraphQL Admin API ตัวอย่างเช่น หากต้องการระบุจำนวนรวมของตัวเลือกสินค้าที่ขายได้ในเวิร์กโฟลว์ คุณจะต้องใช้ตัวแปร variants_item.inventoryQuantity อีกตัวอย่างหนึ่ง หากต้องการระบุตำแหน่งที่ตั้งที่ลูกค้าสมัครรับจดหมายข่าวทางอีเมลของคุณ คุณจะต้องใช้ตัวแปร emailSubscriptionMethod

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

ข้อมูลร้านค้าและ GraphQL Admin API

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

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

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

อาร์กิวเมนต์ฟิลด์และ GraphQL Admin API

ฟิลด์ GraphQL Admin API บางฟิลด์จำเป็นต้องใช้อาร์กิวเมนต์ ซึ่งเป็นพารามิเตอร์เพิ่มเติมที่ช่วยจำกัดว่าระบบจะส่งคืนข้อมูลใด ตัวอย่างเช่น ฟิลด์ product.inCollection ต้องใช้อาร์กิวเมนต์ id ของคอลเลกชันเพื่อให้ทราบว่าต้องตรวจสอบคอลเลกชันใด หากไม่มีอาร์กิวเมนต์ดังกล่าว ฟิลด์จะไม่สามารถส่งคืนผลลัพธ์ได้

ใน Flow คุณสามารถสร้างตัวแปรจากฟิลด์เหล่านี้ได้โดยการระบุค่าอาร์กิวเมนต์ที่จำเป็น ซึ่งจะนำไปใช้ในเวิร์กโฟลว์ได้ นอกจากนี้ยังสามารถกำหนดชื่อแบบกำหนดเองให้แก่ตัวแปรเพื่อให้ง่ายต่อการอ้างอิงในขั้นตอนถัดไป ตัวอย่างเช่น การตั้งชื่อ product.inCollection(id: "gid://shopify/Collection/123456") เป็น product.inSummerBestsellers

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างตัวแปรจากฟิลด์ที่มีอาร์กิวเมนต์

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

การกำหนดเวอร์ชัน API

Shopify เปิดตัวเวอร์ชัน API ใหม่ทุกๆ 3 เดือน และ Flow จะนำเวอร์ชันใหม่มาใช้โดยเร็วที่สุด แต่อาจจะยังไม่ใช่เวอร์ชันล่าสุด เมื่อเป็นไปได้ การเปลี่ยนแปลงระหว่างเวอร์ชันจะได้รับการแก้ไขโดยอัตโนมัติ แต่การเปลี่ยนแปลงบางอย่างอาจไม่ตรงไปตรงมา ซึ่งรวมถึงสถานการณ์ต่อไปนี้:

• เมื่อมีการลบฟิลด์ออกไปแต่ไม่มีการแทนที่ให้ ซึ่งอาจส่งผลต่อวิธีการประเมินเงื่อนไขหรือ Liquid
• เมื่อฟิลด์กลายเป็นฟิลด์ที่อาจเป็น Null ได้ ซึ่งอาจส่งผลต่อวิธีการประเมินเงื่อนไขหรือ Liquid
• เมื่อค่า enum เปลี่ยนแปลง หรือมีการเพิ่มประเภท union หรือ interface ใหม่ ซึ่งอาจส่งผลต่อ Liquid หรือโค้ด
• เมื่ออาร์กิวเมนต์ของคำสั่งเปลี่ยนแปลงข้อมูลมีการเปลี่ยนแปลง ซึ่งอาจส่งผลต่อการกำหนดค่าของการดำเนินการส่งคำขอ Admin API

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

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