Mengakses data terperinci dalam pentadbir Shopify anda menggunakan JSON

JSON, singkatan bagi JavaScript Object Notation, ialah format untuk menyimpan dan memindahkan data, yang sering digunakan apabila data dihantar dari pelayan ke laman web. Dalam kebanyakan halaman sumber dalam pentadbir Shopify, seperti halaman Pesanan, Produk, atau Pelanggan, anda boleh mengakses data yang lebih terperinci menggunakan JSON.

Walaupun anda tidak diwajibkan untuk melaksanakan tugas pembangunan lanjutan menggunakan JSON, kemampuan mengakses fail JSON untuk sumber tertentu dalam pentadbir Shopify anda boleh membantu anda mengumpulkan maklumat yang lebih terperinci, atau menyelesaikan masalah atau menyiasat isu sendiri. Sebagai contoh, anda boleh menyemak fail JSON untuk sesuatu produk bagi mencari ID variannya, yang mungkin diperlukan untuk tugas migrasi data tertentu atau penyesuaian kod tema. Contoh lain, anda boleh merujuk kepada fail JSON pesanan untuk mengesahkan pemboleh ubah data yang anda mahu gunakan apabila membina aliran kerja automatik dalam Shopify Flow.

JSON paling kerap digunakan oleh pembangun, tetapi pengguna dengan pengetahuan pengekodan yang terhad juga boleh mendapat manfaat daripada mempelajari cara untuk mencari dan mentafsirkan beberapa maklumat JSON yang lazim dalam pentadbir Shopify mereka.

Pada halaman ini

Memformat semula fail JSON

Data JSON mentah dipaparkan sebagai jujukan panjang pemboleh ubah bersarang dan kurungan, yang mencabar untuk dibaca oleh pengguna manusia.

Untuk menjadikan pemformatan JSON lebih mudah dibaca, pertimbangkan mana-mana pilihan yang berikut:

Pasang sambungan pemapar JSON dalam pelayar anda.
Gunakan keupayaan pretty-print yang tersedia secara lalai pada kebanyakan pelayar web moden:

Tangkapan skrin fail produk JSON dengan contoh maklumat produk dipaparkan. Tetapan

Mengakses fail JSON dalam pentadbir Shopify anda

Pentadbir Shopify ialah hab pusat untuk mengurus semua aspek perniagaan anda, dan direka bentuk untuk hanya memaparkan maklumat yang paling berguna dan berkaitan secara lalai. Maklumat tambahan yang dikumpulkan apabila tindakan dilaksanakan dalam pentadbir anda disimpan dalam fail .json pelbagai halaman sumber. Butiran tambahan ini tidak dipaparkan kepada anda secara lalai kerana sejumlah besar maklumat tersebut adalah terlalu sarat dan tidak membantu, dan akan menyukarkan penggunaan pentadbir anda.

Bagi kebanyakan tugas perniagaan, anda boleh menggunakan alat sedia ada Shopify untuk mengakses dan mentafsirkan maklumat kedai anda. Walau bagaimanapun, ia kadangkala membantu untuk menyemak maklumat spesifik mengenai sumber tertentu, seperti produk atau pesanan, apabila menyelesaikan masalah berkenaan sebab atau masa sesuatu itu berlaku.

Contoh: Akses fail JSON pesanan

Dalam contoh ini, anda akan mengakses fail JSON pesanan dalam pentadbir Shopify anda.

Langkah-langkah:

Dari pentadbir Shopify anda, pergi ke Pesanan.
Klik mana-mana pesanan dalam senarai Pesanan.
Dalam bar alamat pelayar, tambahkan .json pada hujung alamat URL. Ini akan kelihatan seperti contoh ini:

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

Tekan Enter untuk memuatkan semula halaman dalam pemformatan JSON.
Pilihan: Jika anda tidak mempunyai sambungan pemapar JSON yang dipasang pada pelayar anda, aktifkan tetapan Pretty-print dalam pelayar anda untuk menjadikan fail JSON lebih mesra pengguna. Ketahui lebih lanjut tentang memformat semula fail JSON.

Anda akan mendapati bahawa banyak maklumat yang dijangkakan tentang pesanan akan dipaparkan, seperti "currency" dan "line_items" yang dikaitkan dengan pesanan itu, namun banyak maklumat terperinci lain juga disertakan, seperti "client_details" daripada sesi pelayar pelanggan semasa mereka membuat pesanan. Maklumat sebegini amat berguna untuk penjejakan sesi keseluruhan dan analisis platform pemasaran, tetapi tidak diperlukan untuk anda memproses dan memenuhi pesanan.

Memaparkan medan khusus dalam fail JSON

Anda boleh memaksa fail JSON untuk hanya memaparkan medan khusus, yang dapat menjadikan maklumat lebih mudah untuk ditafsirkan apabila anda mengetahui sifat tertentu yang ingin anda sertakan. Pada hujung mana-mana URL fail JSON dalam bar alamat pelayar, tambahkan ?fields= dan kemudian sertakan nama sifat yang ingin dipaparkan, dalam sebarang tertib, yang dipisahkan dengan koma.

Sebagai contoh, untuk memaparkan ID pesanan, maklumat pelanggan, jumlah harga, dan tag, tambahkan ?fields=id,customer,total_price,tags pada hujung URL fail JSON, seperti dalam contoh yang berikut:

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

Menggunakan sumber JSON lain

Anda boleh menggunakan sumber JSON yang berikut untuk memaparkan maklumat khusus dalam pentadbir Shopify anda:

Kiraan produk: Tambahkan /count.json pada hujung URL senarai Produk untuk memaparkan jumlah bilangan produk. URL penuh seharusnya:

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

Transaksi: Tambahkan /transactions.json pada hujung URL halaman pesanan untuk memaparkan maklumat transaksi pesanan sahaja. Ketahui lebih lanjut tentang sumber Transaksi.
Pemenuhan: Tambahkan /fulfillments.json pada hujung URL halaman pesanan untuk memaparkan maklumat pemenuhan pesanan sahaja. Ketahui lebih lanjut tentang sumber Pemenuhan.
Pembayaran yang ditinggalkan: Tambahkan .json pada hujung URL pembayaran yang ditinggalkan untuk memaparkan maklumat terperinci tentang pembayaran yang ditinggalkan tersebut. Ketahui lebih lanjut tentang sumber Pembayaran yang ditinggalkan.

Sifat JSON yang lazim untuk penyelesaian masalah

Jadual berikut menyenaraikan sifat JSON yang mungkin ingin anda rujuk bagi mendapatkan bantuan penyelesaian masalah dengan jenis sumber berbeza. Contohnya, jika anda ingin mengesahkan masa produk tertentu diterbitkan, anda boleh menyemak fail JSON produk untuk mendapatkan sifat published_at yang memaparkan tarikh dan masa dalam format ISO 8601.

Jadual ini tidak merangkumi setiap kemungkinan sumber atau sifat JSON yang disimpan dalam pentadbir Shopify, oleh itu, rujuk dokumentasi pembangun Shopify untuk mendapatkan takrifan sebarang sumber atau sifat yang tidak disertakan di sini.

Menyenaraikan beberapa contoh sumber pentadbir dan sifat lazim yang dikaitkan dengannya, termasuk takrifan untuk kegunaan sumber tersebut apabila melakukan penyelesaian masalah.
Sumber	Sifat JSON	Takrifan
Produk	`"product": { "created_at"`	Masa dan tarikh produk itu pada mulanya dicipta.
	`"product": { "published_at"`	Masa dan tarikh status produk ditetapkan kepada Aktif.
	`"product": { "updated_at"`	Masa dan tarikh terkini apabila produk dikemas kini. Ini boleh merangkumi perubahan kepada perihalan produk, tajuk atau maklumat SEO, serta kemas kini automatik seperti perubahan kepada inventori apabila produk dibeli.
Varian	`"product": { "variants": [ { "created_at"`	Masa dan tarikh varian itu pada mulanya dicipta. Masa ini boleh berbeza dengan tarikh dan masa produk keseluruhan dicipta.
	`"product": { "variants": [ { "updated_at"`	Masa dan tarikh terkini apabila varian dikemas kini. Tarikh ini boleh berbeza dengan tarikh dan masa produk keseluruhan terakhir dikemas kini.
	`"product": { "variants": [ { "inventory_quantity"`	Nilai pangkalan data semasa dan item yang boleh diakses untuk dibeli oleh pelanggan. Nilai ini boleh menjadi negatif sekiranya inventori varian tidak dijejak atau jika ia ditetapkan untuk dijual melebihi stok.
	`"product": { "variants": [ { "old_inventory_quantity"`	Nilai pangkalan data sebelum tarikh `updated_at` varian terakhir.
Pesanan	`"order": { "line_items": [ { "requires_shipping"`	Dipaparkan sebagai `true` atau `false`. Ini menunjukkan tetapan penghantaran produk atau varian semasa pesanan dibuat.
	`"order": { "line_items": [ { "taxable"`	Dipaparkan sebagai `true` atau `false`. Ini menunjukkan cara produk atau varian ditetapkan untuk mengecaj cukai semasa pesanan dibuat.
	`"order": { "line_items": [ { "variant_inventory_management"`	Dipaparkan sebagai `shopify`, `amazon_marketplace_web`, `null`, atau nilai pihak ketiga bergantung pada perkhidmatan pemenuhan yang ditetapkan untuk menjejak inventori produk. Nilai `null` bermakna produk tidak dijejak semasa pesanan tersebut.
	`"order": { "line_items": [ { "fulfillable_quantity"`	Memaparkan jumlah inventori yang masih dikhaskan oleh sistem demi melengkapkan pesanan. Jumlah ini tidak menyamai inventori varian semasa.
	`"order": { "line_items": [ { "quantity"`	Bilangan produk atau varian yang dibeli.
	`"order": { "line_items": [ { "tax_lines"`	Di Amerika Syarikat, baris ini memaparkan nilai negeri, daerah dan perbandaran. Jika tiada baris cukai dipaparkan, tetapi cukai dicaj pada pesanan tersebut, maka ini bermakna cukai telah dicaj pada kos penghantaran.
Pelanggan	`"customer": { "created_at"`	Masa dan tarikh pelanggan itu pada mulanya dicipta.
Pelanggan	`"customer": { "updated_at"`	Masa dan tarikh terkini apabila profil pelanggan dikemas kini.

Medan meta dalam JSON

Medan meta adalah cara fleksibel untuk melampirkan maklumat tersuai tambahan pada sumber Shopify, seperti produk atau koleksi. Sesetengah contoh data yang disimpan menggunakan medan meta termasuklah spesifikasi produk, carta saiz, dokumen boleh dimuat turun, tarikh keluaran, imej atau nombor bahagian. Ketahui lebih lanjut tentang penggunaan medan meta.

Anda boleh menambahkan /metafields.json pada hujung URL halaman sumber yang disokong untuk memaparkan medan meta yang dikaitkan dengan sumber tersebut. Rujuk jadual berikut untuk mendapatkan beberapa contoh sumber dan format URL yang akan digunakan bagi memaparkan maklumat medan meta menggunakan JSON.

Senaraikan beberapa sumber pentadbir contoh bersama-sama dengan URL fail medan meta JSON contoh.
Jenis sumber contoh	URL contoh
Koleksi pintar	`https://admin.shopify.com/store/{your-store-name}/collections/{collection-id}/metafields.json`
Pelanggan	`https://admin.shopify.com/store/{your-store-name}/customers/{customer-id}/metafields.json`
Pesanan	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/metafields.json`
Halaman	`https://admin.shopify.com/store/{your-store-name}/pages/{page-id}/metafields.json`
Produk	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/metafields.json`
Varian	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/variants/{variant-id}/metafields.json`
Imej produk	`https://admin.shopify.com/store/{your-store-name}/metafields.json?metafield[owner_id]={id}&metafield[owner_resource]=product_image` Nota: Medan meta imej produk hanya boleh ditambahkan melalui API. Gantikan `{id}` dan ruang letak lain dalam URL tersebut dengan nilai sebenar daripada pertanyaan API anda.
Kedai	`https://admin.shopify.com/store/{your-store-name}/metafields.json`

Untuk mendapatkan senarai penuh sumber yang boleh mengandungi medan meta dan jenis sifat khusus yang disimpan untuk setiap jenis sumber, rujuk sumber JSON Medan meta dalam dokumentasi pembangun Shopify.

Acara dalam JSON

Acara dijanakan oleh sesetengah sumber Shopify apabila tindakan tertentu dilengkapkan, contohnya seperti mencipta siaran blog, pemenuhan pesanan atau penambahan produk.

Anda boleh menambahkan /events.json pada hujung URL halaman sumber yang disokong untuk memaparkan acara yang dikaitkan dengan sumber tersebut. Rujuk jadual berikut bagi mendapatkan beberapa contoh sumber dan format URL yang akan digunakan untuk memaparkan maklumat acara menggunakan JSON.

Senaraikan beberapa contoh sumber pentadbir berserta URL fail acara JSON contoh.
Jenis sumber contoh	URL contoh
Pesanan	`https://admin.shopify.com/store/{your-store-name}/orders/{order-id}/events.json` Fail ini menyenaraikan `author` acara, memaklumkan kepada anda pengguna yang menyelesaikan tindakan tertentu, seperti siapa atau apa yang menerbitkan produk.
Produk	`https://admin.shopify.com/store/{your-store-name}/products/{product-id}/events.json` Fail ini menyenaraikan `author` acara, memaklumkan kepada anda pengguna yang menyelesaikan tindakan tertentu, seperti siapa atau apa yang menandakan pembayaran sebagai dibayar.
Kedai	`https://admin.shopify.com/store/{your-store-name}/events.json?limit=250` Format URL ini memaparkan 250 acara paling baharu yang berlaku di kedai anda. Acara boleh termasuk tetapi tidak terhad kepada penciptaan atau kemas kini produk, pemadaman halaman dan kemas kini varian.

Untuk mendapatkan senarai lengkap sumber yang boleh mencipta acara dan acara khusus yang dicipta untuk setiap jenis sumber, rujuk Sumber JSON Acara dalam Dokumentasi Pembangun Shopify.