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

การเข้าถึงข้อมูลโดยละเอียดในส่วนผู้ดูแล Shopify โดยใช้ JSON

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

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

โดยส่วนมากแล้ว JSON จะถูกใช้งานโดยนักพัฒนา แต่ผู้ใช้ที่มีความรู้ด้านการเขียนโค้ดเพียงเล็กน้อยก็สามารถได้รับประโยชน์จากการเรียนรู้วิธีค้นหาและตีความข้อมูล JSON ทั่วไปบางส่วนในส่วนผู้ดูแล Shopify ของตนเองได้

ในหน้านี้

การจัดรูปแบบไฟล์ JSON ใหม่

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

หากต้องการทำให้รูปแบบ JSON อ่านง่ายขึ้น โปรดพิจารณาตัวเลือกใดๆ ต่อไปนี้

  • ติดตั้งส่วนขยายตัวแสดง JSON ในเบราว์เซอร์ของคุณ
  • ใช้ความสามารถ Pretty-print ที่เว็บเบราว์เซอร์สมัยใหม่ส่วนใหญ่มีให้ใช้งานเป็นค่าเริ่มต้น

ภาพหน้าจอของไฟล์ JSON สินค้าที่แสดงข้อมูลสินค้าตัวอย่าง การตั้งค่าช่องทำเครื่องหมาย “Pretty-print” เปิดใช้งานอยู่และถูกไฮไลต์ไว้ที่ด้านซ้ายบนของหน้า

การเข้าถึงไฟล์ JSON ในส่วนผู้ดูแล Shopify

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

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

ตัวอย่าง: การเข้าถึงไฟล์ JSON ของคำสั่งซื้อ

ในตัวอย่างนี้ คุณจะได้เข้าถึงไฟล์ JSON ของคำสั่งซื้อในส่วนผู้ดูแล Shopify

ขั้นตอน

  1. จากส่วนผู้ดูแล Shopify ของคุณ ให้ไปที่ คำสั่งซื้อ

  2. คลิกที่คำสั่งซื้อใดก็ได้ในรายการคำสั่งซื้อ

  3. ในแถบที่อยู่ของเบราว์เซอร์ ให้เพิ่ม .json ต่อท้ายที่อยู่ URL ซึ่งจะมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json
  1. กด Enter เพื่อโหลดหน้าเว็บอีกครั้งในรูปแบบ JSON
  2. ตัวเลือกเสริม: หากคุณไม่ได้ติดตั้งส่วนขยายตัวแสดง JSON ไว้ในเบราว์เซอร์ ให้เปิดใช้งานการตั้งค่า Pretty-print ในเบราว์เซอร์ของคุณเพื่อให้ไฟล์ JSON ใช้งานง่ายขึ้น ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดรูปแบบไฟล์ JSON ใหม่

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

การแสดงฟิลด์ที่ต้องการในไฟล์ JSON

คุณสามารถบังคับให้ไฟล์ JSON แสดงเฉพาะฟิลด์ที่ต้องการได้ ซึ่งจะทำให้ตีความข้อมูลได้ง่ายขึ้นเมื่อคุณทราบพร็อพเพอร์ตี้ที่ต้องการรวมไว้ ในตอนท้ายของ URL ไฟล์ JSON ใดๆ ในแถบที่อยู่เบราว์เซอร์ ให้เพิ่ม ?fields= จากนั้นใส่ชื่อพร็อพเพอร์ตี้ที่ต้องการแสดง โดยจะเรียงตามลำดับใดก็ได้และคั่นด้วยเครื่องหมายจุลภาค

ตัวอย่างเช่น หากต้องการแสดง ID คำสั่งซื้อ ข้อมูลลูกค้า ราคารวม และแท็ก ให้เพิ่ม ?fields=id,customer,total_price,tags ต่อท้าย URL ของไฟล์ JSON ดังตัวอย่างต่อไปนี้

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json?fields=id,customer,total_price,tags

การใช้รีซอร์ส JSON อื่นๆ

คุณสามารถใช้รีซอร์ส JSON ต่อไปนี้เพื่อแสดงข้อมูลที่ต้องการในส่วนผู้ดูแล Shopify

  • จำนวนสินค้า: เพิ่ม /count.json ต่อท้าย URL ของรายการสินค้า เพื่อแสดงจำนวนสินค้าทั้งหมด โดย URL ฉบับเต็มควรเป็นดังนี้:
https://admin.shopify.com/store/{example-shop-name}/products/count.json
  • ธุรกรรม: เพิ่ม /transactions.json ต่อท้าย URL หน้าคำสั่งซื้อเพื่อแสดงเฉพาะข้อมูลธุรกรรมของคำสั่งซื้อ ดูข้อมูลเพิ่มเติมเกี่ยวกับรีซอร์สธุรกรรม
  • การจัดการคำสั่งซื้อ: เพิ่ม /fulfillments.json ต่อท้าย URL หน้าคำสั่งซื้อเพื่อแสดงเฉพาะข้อมูลการจัดการคำสั่งซื้อ ดูข้อมูลเพิ่มเติมเกี่ยวกับรีซอร์สการจัดการคำสั่งซื้อ
  • ขั้นตอนการชำระเงินที่ยังไม่เสร็จสิ้น: เพิ่ม .json ต่อท้าย URL ของขั้นตอนการชำระเงินที่ยังไม่เสร็จสิ้นเพื่อแสดงข้อมูลโดยละเอียดเกี่ยวกับรายการดังกล่าว ดูข้อมูลเพิ่มเติมเกี่ยวกับรีซอร์สขั้นตอนการชำระเงินที่ยังไม่เสร็จสิ้น

พร็อพเพอร์ตี้ JSON ทั่วไปสำหรับการแก้ไขปัญหา

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

ตารางนี้ไม่ได้รวมรีซอร์สหรือคุณสมบัติ JSON ที่เป็นไปได้ทั้งหมดที่จัดเก็บไว้ในส่วนผู้ดูแล Shopify ดังนั้นโปรดอ้างอิงเอกสารสำหรับนักพัฒนาของ Shopify เพื่อดูคำจำกัดความของรีซอร์สหรือคุณสมบัติใดๆ ที่ไม่ได้ระบุไว้ในที่นี้

แสดงรายการรีซอร์สผู้ดูแลตัวอย่างและพร็อพเพอร์ตี้ทั่วไปที่เกี่ยวข้อง พร้อมคำจำกัดความของสิ่งที่อาจนำไปใช้เมื่อแก้ไขปัญหา
รีซอร์สพร็อพเพอร์ตี้ JSONคำจำกัดความ
สินค้า
"product": {
  "created_at"
เวลาและวันที่สร้างสินค้าขึ้นครั้งแรก
"product": {
  "published_at"
เวลาและวันที่สถานะของสินค้าถูกตั้งค่าเป็นพร้อมจำหน่าย
"product": {
  "updated_at"
เวลาและวันที่ล่าสุดที่มีการอัปเดตสินค้า ซึ่งอาจรวมถึงการเปลี่ยนแปลงคำอธิบายสินค้า ชื่อ หรือข้อมูล SEO ตลอดจนการอัปเดตอัตโนมัติ เช่น การเปลี่ยนแปลงสินค้าคงคลังเมื่อมีการซื้อสินค้า
ตัวเลือกสินค้า
"product": {
  "variants": [
    {
    "created_at"
เวลาและวันที่สร้างตัวเลือกสินค้าขึ้นครั้งแรก ซึ่งอาจแตกต่างจากวันและเวลาที่สร้างสินค้าโดยรวม
"product": {
  "variants": [
    {
    "updated_at"
เวลาและวันที่ล่าสุดที่มีการอัปเดตตัวเลือกสินค้า ซึ่งอาจแตกต่างจากวันและเวลาที่อัปเดตสินค้าโดยรวมครั้งล่าสุด
"product": {
  "variants": [
    {
    "inventory_quantity"
ค่าฐานข้อมูลปัจจุบันและจำนวนที่ลูกค้าสามารถเข้าถึงเพื่อซื้อได้ ซึ่งอาจเป็นค่าติดลบหากไม่มีการติดตามสินค้าคงคลังของตัวเลือกสินค้า หรือหากตั้งค่าให้ขายเกินจำนวนได้
"product": {
  "variants": [
    {
    "old_inventory_quantity"
ค่าฐานข้อมูลก่อนวันที่ updated_at ล่าสุดของตัวเลือกสินค้า
คำสั่งซื้อ
"order": {
   "line_items": [
    {
    "requires_shipping"
แสดงเป็น true หรือ false ซึ่งจะบ่งชี้การตั้งค่าการจัดส่งของสินค้าหรือตัวเลือกสินค้า ณ เวลาที่ทำการสั่งซื้อ
"order": {
   "line_items": [
    {
    "taxable"
แสดงเป็น true หรือ false ซึ่งจะบ่งชี้ว่าสินค้าหรือตัวเลือกสินค้าได้รับการตั้งค่าให้เรียกเก็บภาษีอย่างไร ณ เวลาที่ทำการสั่งซื้อ
"order": {
   "line_items": [
    {
    "variant_inventory_management"
แสดงเป็น shopify, amazon_marketplace_web, null หรือค่าของภายนอก ขึ้นอยู่กับว่าบริการจัดการคำสั่งซื้อใดได้รับการตั้งค่าให้ติดตามสินค้าคงคลังของสินค้า ค่า null หมายความว่าไม่มีการติดตามสินค้าในขณะที่ทำการสั่งซื้อ
"order": {
   "line_items": [
    {
    "fulfillable_quantity"
แสดงจำนวนสินค้าคงคลังที่ระบบยังคงสำรองไว้เพื่อจัดการคำสั่งซื้อให้เสร็จสมบูรณ์ ซึ่งไม่เท่ากับสินค้าคงคลังของตัวเลือกสินค้าในปัจจุบัน
"order": {
   "line_items": [
    {
    "quantity"
จำนวนสินค้าหรือตัวเลือกสินค้าที่ซื้อ
"order": {
   "line_items": [
    {
    "tax_lines"
ในสหรัฐอเมริกา จะแสดงค่าระดับรัฐ เคาน์ตี และเทศบาล หากไม่แสดงรายการภาษี แต่มีการเรียกเก็บภาษีในคำสั่งซื้อ หมายความว่ามีการเรียกเก็บภาษีจากค่าจัดส่ง
ลูกค้า
"customer": {
  "created_at"
เวลาและวันที่สร้างลูกค้าขึ้นครั้งแรก
"customer": {
  "updated_at"
เวลาและวันที่ล่าสุดที่มีการอัปเดตโปรไฟล์ลูกค้า

เมตาฟิลด์ใน JSON

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

คุณสามารถเพิ่ม /metafields.json ไปยังส่วนท้ายของ URL หน้าแหล่งข้อมูลที่รองรับเพื่อแสดงเมตาฟิลด์ที่เชื่อมโยงกับแหล่งข้อมูลนั้น โปรดดูตารางต่อไปนี้สำหรับตัวอย่างแหล่งข้อมูลและรูปแบบ URL ที่จะใช้เพื่อแสดงข้อมูลเมตาฟิลด์โดยใช้ JSON

แสดงรายการแหล่งข้อมูลตัวอย่างบางส่วนในส่วนผู้ดูแล พร้อมด้วย URL ไฟล์เมตาฟิลด์ JSON ตัวอย่าง
ประเภทแหล่งข้อมูลตัวอย่างURL ตัวอย่าง
คอลเลกชันอัจฉริยะhttps://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json
ลูกค้าhttps://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json
คำสั่งซื้อhttps://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json
หน้าhttps://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json
สินค้าhttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json
ตัวเลือกสินค้าhttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json
รูปภาพสินค้าhttps://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image

หมายเหตุ: เมตาฟิลด์รูปภาพสินค้าสามารถเพิ่มได้ผ่าน API เท่านั้น โปรดแทนที่ {id} และตัวยึดตำแหน่งอื่นๆ ใน URL ด้วยค่าจริงจากคำค้นหา API ของคุณ


ร้านค้าhttps://admin.shopify.com/store/{your-store-name}/metafields.json

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

กิจกรรมใน JSON

กิจกรรมจะถูกสร้างขึ้นโดยแหล่งข้อมูลบางอย่างของ Shopify เมื่อดำเนินการบางอย่างเสร็จสิ้น เช่น การสร้างบล็อกโพสต์ การจัดการคำสั่งซื้อ หรือการเพิ่มสินค้า

คุณสามารถเพิ่ม /events.json ไปยังส่วนท้ายของ URL หน้าแหล่งข้อมูลที่รองรับเพื่อแสดงกิจกรรมที่เชื่อมโยงกับแหล่งข้อมูลนั้น โปรดดูตารางต่อไปนี้สำหรับตัวอย่างแหล่งข้อมูลและรูปแบบ URL ที่จะใช้เพื่อแสดงข้อมูลกิจกรรมโดยใช้ JSON

แสดงรายการแหล่งข้อมูลตัวอย่างบางส่วนในส่วนผู้ดูแล พร้อมด้วย URL ไฟล์กิจกรรม JSON ตัวอย่าง
ประเภทแหล่งข้อมูลตัวอย่างURL ตัวอย่าง
คำสั่งซื้อhttps://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json

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


สินค้าhttps://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json

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


ร้านค้าhttps://admin.shopify.com/store/{your-store-name}/events.json?limit=250

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


สำหรับรายการรีซอร์สทั้งหมดที่สามารถสร้างเหตุการณ์ได้ และเหตุการณ์เฉพาะที่สร้างขึ้นสำหรับรีซอร์สแต่ละประเภท โปรดอ้างอิงรีซอร์ส JSON ของเหตุการณ์ในเอกสารสำหรับนักพัฒนาของ Shopify