Truy cập dữ liệu chi tiết trong bảng điều khiển quản trị Shopify bằng JSON

JSON, viết tắt của JavaScript Object Notation, là một định dạng dùng để lưu trữ và truyền dữ liệu, thường được dùng khi gửi dữ liệu từ máy chủ đến các trang web. Trên hầu hết trang tài nguyên trong bảng điều khiển quản trị Shopify, chẳng hạn như trang Đơn hàng, Sản phẩm hoặc Khách hàng, bạn có thể truy cập dữ liệu chi tiết hơn bằng JSON.

Mặc dù bạn không bắt buộc phải thực hiện các tác vụ phát triển nâng cao bằng JSON, việc có thể truy cập tệp JSON cho một tài nguyên cụ thể trong bảng điều khiển quản trị Shopify sẽ giúp bạn thu thập thêm thông tin chi tiết hoặc tự khắc phục sự cố hay điều tra nguyên nhân. Ví dụ: bạn có thể xem xét tệp JSON của một sản phẩm để tìm ID mẫu mã, thao tác có thể cần thiết đối với một số tác vụ di chuyển dữ liệu hoặc tùy chỉnh mã chủ đề. Ví dụ khác, bạn có thể tham khảo tệp JSON của đơn hàng để xác nhận biến dữ liệu muốn dùng khi xây dựng dòng công việc tự động hóa trong Shopify Flow.

JSON thường được các nhà phát triển sử dụng, nhưng cả người dùng có ít kiến thức về lập trình cũng có thể học cách tìm và diễn giải một số thông tin JSON phổ biến trong bảng điều khiển quản trị Shopify của mình.

Trên trang này

Định dạng lại tệp JSON

Dữ liệu JSON thô hiển thị dưới dạng một chuỗi dài các biến lồng nhau và dấu ngoặc, khiến người dùng khó đọc.

Để giúp định dạng JSON dễ đọc hơn, hãy cân nhắc một trong các tùy chọn sau:

Cài đặt tiện ích mở rộng trình xem JSON trên trình duyệt.
Sử dụng tính năng "pretty-print" có sẵn mặc định trên hầu hết các trình duyệt web hiện đại:

Ảnh chụp màn hình tệp JSON sản phẩm hiển thị thông tin sản phẩm ví dụ. Cài đặt hộp kiểm 'pretty-print' đang hoạt động, được tô sáng ở phía trên cùng bên trái trang.

Truy cập tệp JSON trong bảng điều khiển quản trị Shopify

Bảng điều khiển quản trị Shopify là trung tâm để quản lý mọi khía cạnh của doanh nghiệp, được thiết kế để theo mặc định chỉ hiển thị những thông tin hữu ích và phù hợp nhất. Thông tin bổ sung được thu thập mỗi khi thực hiện thao tác trong bảng điều khiển quản trị được lưu trong tệp .json của các trang tài nguyên khác nhau. Theo mặc định, các chi tiết bổ sung này không hiển thị vì lượng thông tin lớn như vậy sẽ gây quá tải và vô ích, đồng thời khiến bảng điều khiển quản trị khó sử dụng.

Đối với hầu hết các tác vụ kinh doanh, bạn có thể sử dụng những công cụ hiện có của Shopify để truy cập và diễn giải thông tin cửa hàng. Tuy nhiên, đôi khi việc xem lại thông tin của một số tài nguyên cụ thể (như sản phẩm hoặc đơn hàng) sẽ rất hữu ích khi cần khắc phục sự cố để tìm hiểu nguyên nhân hoặc thời điểm xảy ra sự việc.

Ví dụ: Truy cập tệp JSON của một đơn hàng

Trong ví dụ này, bạn sẽ truy cập tệp JSON của một đơn hàng trong bảng điều khiển quản trị Shopify.

Các bước:

Từ bảng điều khiển quản trị Shopify, đi tới Đơn hàng.
Nhấp vào đơn hàng bất kỳ trong danh sách Đơn hàng.
Trên thanh địa chỉ trình duyệt, hãy thêm .json vào cuối địa chỉ URL. Kết quả sẽ tương tự như ví dụ sau:

https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json

Nhấn Enter để tải lại trang bằng định dạng JSON.
Tùy chọn: Nếu bạn chưa cài đặt tiện ích mở rộng trình xem JSON trên trình duyệt, hãy kích hoạt cài đặt Pretty-print trên trình duyệt để tệp JSON thân thiện hơn với người dùng. Tìm hiểu thêm về định dạng lại tệp JSON.

Bạn sẽ nhận thấy có nhiều thông tin dự kiến về đơn hàng hiển thị (như "currency" và "line_items" liên kết với đơn hàng), nhưng cũng có nhiều thông tin chi tiết khác được bao gồm (như "client_details" từ phiên truy cập trình duyệt của khách hàng khi họ đặt hàng). Loại thông tin này hữu ích để theo dõi phiên tổng thể và phân tích nền tảng tiếp thị, nhưng không cần thiết để bạn xử lý và thực hiện đơn hàng.

Hiển thị các trường cụ thể trong tệp JSON

Bạn có thể buộc tệp JSON chỉ hiển thị các trường cụ thể, thao tác này giúp diễn giải thông tin dễ dàng hơn khi bạn biết rõ những thuộc tính cần bao gồm. Ở cuối bất kỳ URL tệp JSON nào trên thanh địa chỉ trình duyệt, hãy thêm ?fields=, sau đó điền tên thuộc tính mà bạn muốn hiển thị theo thứ tự bất kỳ, được phân tách bằng dấu phẩy.

Ví dụ: để hiển thị ID đơn hàng, thông tin khách hàng, tổng giá và thẻ, hãy thêm ?fields=id,customer,total_price,tags vào cuối URL tệp JSON, như trong ví dụ sau:

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

Sử dụng các tài nguyên JSON khác

Bạn có thể sử dụng các tài nguyên JSON sau để hiển thị thông tin cụ thể trong bảng điều khiển quản trị Shopify:

Số lượng sản phẩm: Thêm /count.json vào cuối URL của danh sách Sản phẩm để hiển thị tổng số sản phẩm. URL đầy đủ sẽ là:

https://admin.shopify.com/store/{example-shop-name}/products/count.json

Giao dịch: Thêm /transactions.json vào cuối URL trang đơn hàng để chỉ hiển thị thông tin giao dịch của đơn hàng. Tìm hiểu thêm về Tài nguyên giao dịch.
Hoàn tất đơn hàng: Thêm /fulfillments.json vào cuối URL trang đơn hàng để chỉ hiển thị thông tin hoàn tất đơn hàng. Tìm hiểu thêm về Tài nguyên hoàn tất đơn hàng.
Giao dịch thanh toán bỏ dở: Thêm .json vào cuối URL của giao dịch thanh toán bỏ dở để hiển thị thông tin chi tiết về giao dịch thanh toán bỏ dở đó. Tìm hiểu thêm về Tài nguyên giao dịch thanh toán bỏ dở.

Các thuộc tính JSON phổ biến để khắc phục sự cố

Bảng sau liệt kê các thuộc tính JSON có thể tham khảo để hỗ trợ khắc phục sự cố với nhiều loại tài nguyên. Ví dụ: để xác nhận thời điểm phát hành một sản phẩm cụ thể, hãy kiểm tra tệp JSON của sản phẩm để tìm thuộc tính published_at, trong đó hiển thị ngày và giờ theo định dạng ISO 8601.

Bảng này không bao gồm mọi tài nguyên hoặc thuộc tính JSON có thể được lưu trữ trong bảng điều khiển quản trị Shopify. Do đó, vui lòng tham khảo Tài liệu cho nhà phát triển của Shopify để biết định nghĩa về bất kỳ tài nguyên hoặc thuộc tính nào không có ở đây.

Liệt kê một số ví dụ về tài nguyên quản trị và các thuộc tính phổ biến liên quan, bao gồm định nghĩa về chức năng của chúng khi khắc phục sự cố.
Tài nguyên	Thuộc tính JSON	Định nghĩa
Sản phẩm	`"product": { "created_at"`	Ngày và giờ tạo sản phẩm ban đầu.
	`"product": { "published_at"`	Ngày và giờ chuyển trạng thái sản phẩm sang Đang hoạt động.
	`"product": { "updated_at"`	Ngày và giờ cập nhật sản phẩm gần nhất. Điều này có thể bao gồm các thay đổi về mô tả sản phẩm, tiêu đề hoặc thông tin SEO, cũng như các cập nhật tự động như thay đổi hàng tồn kho khi mua sản phẩm.
Mẫu mã	`"product": { "variants": [ { "created_at"`	Ngày và giờ tạo mẫu mã ban đầu. Thời điểm này có thể khác với ngày và giờ tạo sản phẩm tổng thể.
	`"product": { "variants": [ { "updated_at"`	Ngày và giờ cập nhật mẫu mã gần nhất. Thời điểm này có thể khác với ngày và giờ cập nhật sản phẩm tổng thể gần nhất.
	`"product": { "variants": [ { "inventory_quantity"`	Giá trị cơ sở dữ liệu hiện tại và những gì khách hàng có thể mua được. Giá trị này có thể là số âm nếu hàng tồn kho của mẫu mã không được theo dõi hoặc nếu được thiết lập để bán vượt quá số lượng.
	`"product": { "variants": [ { "old_inventory_quantity"`	Giá trị cơ sở dữ liệu trước ngày `updated_at` gần nhất của mẫu mã.
Đơn hàng	`"order": { "line_items": [ { "requires_shipping"`	Hiển thị là `true` hoặc `false`. Thuộc tính này cho biết cài đặt vận chuyển của sản phẩm hoặc mẫu mã tại thời điểm đặt hàng.
	`"order": { "line_items": [ { "taxable"`	Hiển thị là `true` hoặc `false`. Thuộc tính này cho biết cách sản phẩm hoặc mẫu mã được thiết lập để tính thuế tại thời điểm đặt hàng.
	`"order": { "line_items": [ { "variant_inventory_management"`	Hiển thị là `shopify`, `amazon_marketplace_web`, `null` hoặc một giá trị của bên thứ ba, tùy thuộc vào dịch vụ hoàn tất đơn hàng nào được thiết lập để theo dõi hàng tồn kho của sản phẩm. Giá trị `null` có nghĩa là sản phẩm không được theo dõi tại thời điểm đặt hàng.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Hiển thị lượng hàng tồn kho vẫn được hệ thống dự trữ để hoàn tất đơn hàng. Con số này không bằng hàng tồn kho hiện tại của mẫu mã.
	`"order": { "line_items": [ { "quantity"`	Số lượng sản phẩm hoặc mẫu mã đã mua.
	`"order": { "line_items": [ { "tax_lines"`	Tại Hoa Kỳ, thuộc tính này hiển thị các giá trị tiểu bang, quận và thành phố. Nếu không có dòng thuế nào hiển thị nhưng đơn hàng vẫn bị tính thuế, điều đó có nghĩa là thuế đã được tính vào chi phí vận chuyển.
Khách hàng	`"customer": { "created_at"`	Ngày và giờ tạo khách hàng ban đầu.
Khách hàng	`"customer": { "updated_at"`	Ngày và giờ cập nhật hồ sơ khách hàng gần nhất.

Trường siêu dữ liệu trong JSON

Trường siêu dữ liệu là cách linh hoạt để đính kèm thông tin tùy chỉnh bổ sung vào tài nguyên Shopify, chẳng hạn như sản phẩm hoặc bộ sưu tập. Một số ví dụ về dữ liệu được lưu trữ bằng trường siêu dữ liệu bao gồm thông số kỹ thuật của sản phẩm, bảng kích thước, tài liệu có thể tải xuống, ngày phát hành, hình ảnh hoặc mã phụ tùng. Tìm hiểu thêm về cách sử dụng trường siêu dữ liệu.

Có thể thêm /metafields.json vào cuối URL trang tài nguyên được hỗ trợ để hiển thị các trường siêu dữ liệu liên kết với tài nguyên đó. Tham khảo bảng sau để biết một số ví dụ về tài nguyên và định dạng URL cần sử dụng để hiển thị thông tin trường siêu dữ liệu bằng JSON.

Liệt kê một số ví dụ về tài nguyên quản trị cùng với URL tệp trường siêu dữ liệu JSON mẫu.
Loại tài nguyên mẫu	URL mẫu
Bộ sưu tập thông minh	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Khách hàng	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Đơn hàng	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Trang	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Sản phẩm	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Mẫu mã	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Hình ảnh sản phẩm	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Lưu ý: Chỉ có thể thêm trường siêu dữ liệu hình ảnh sản phẩm thông qua API. Thay thế `{id}` và các phần giữ chỗ khác trong URL bằng giá trị thực tế từ truy vấn API.
Cửa hàng	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Để xem danh sách đầy đủ các tài nguyên có thể có trường siêu dữ liệu và các loại thuộc tính cụ thể được lưu trữ cho từng loại tài nguyên, hãy tham khảo Tài nguyên JSON của trường siêu dữ liệu trong Tài liệu cho nhà phát triển của Shopify.

Sự kiện trong JSON

Một số tài nguyên Shopify sẽ tạo ra sự kiện khi hoàn thành một số hành động nhất định, chẳng hạn như tạo bài đăng trên blog, hoàn tất đơn hàng hoặc thêm sản phẩm.

Có thể thêm /events.json vào cuối URL trang tài nguyên được hỗ trợ để hiển thị các sự kiện liên kết với tài nguyên đó. Tham khảo bảng sau để biết một số ví dụ về tài nguyên và định dạng URL cần sử dụng để hiển thị thông tin sự kiện bằng JSON.

Liệt kê một số ví dụ về tài nguyên quản trị cùng với ví dụ về URL của tệp sự kiện JSON.
Loại tài nguyên mẫu	URL mẫu
Đơn hàng	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Tệp này liệt kê `author` của các sự kiện, cho biết người dùng nào đã hoàn tất thao tác nhất định, chẳng hạn như ai hoặc hệ thống nào đã xuất bản sản phẩm.
Sản phẩm	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Tệp này liệt kê `author` của các sự kiện, cho biết người dùng nào đã hoàn tất thao tác nhất định, chẳng hạn như ai hoặc hệ thống nào đã đánh dấu khoản thanh toán là đã thanh toán.
Cửa hàng	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Định dạng URL này hiển thị 250 sự kiện gần nhất diễn ra trên cửa hàng. Sự kiện có thể bao gồm nhưng không giới hạn ở việc tạo hoặc cập nhật sản phẩm, xóa trang và cập nhật mẫu mã.

Để có danh sách đầy đủ các tài nguyên có thể tạo sự kiện, cũng như các sự kiện cụ thể được tạo cho từng loại tài nguyên, hãy tham khảo Event JSON resource trong tài liệu cho nhà phát triển của Shopify.