Shopify Flow dan GraphQL Admin API

Flow menggunakan GraphQL Admin API Shopify untuk membina automasi dan integrasi yang meluaskan serta mempertingkatkan pentadbir Shopify. Flow menggunakan versi 2026-01 bagi API tersebut untuk menilai syarat dan pemboleh ubah dalam aliran kerja serta mengambil tindakan dalam kedai Shopify anda. Oleh sebab Flow mengakses data kedai dengan memanggil API tersebut, anda mempunyai akses kepada hampir semua medan yang tersedia dalam API daripada Flow.

Oleh sebab Shopify melancarkan versi API baharu setiap 3 bulan, sesetengah aliran kerja mungkin perlu dikemas kini apabila medan ditukar atau ditamatkan penawarannya.

Menggunakan GraphQL Admin API dalam aliran kerja

Kebanyakan tindakan dalam Flow menggunakan GraphQL Admin API untuk membuat perubahan pada kedai Shopify anda. Contohnya, tindakan Tambah tag pesanan menggunakan mutasi tagsAdd. Tindakan Hantar permintaan Admin API boleh menggunakan kebanyakan mutasi, termasuk yang belum tersedia sebagai tindakan dalam Flow.

Semasa anda mencipta aliran kerja, anda akan kerap menemukan nama medan dan huraian berdasarkan sintaks GraphQL Admin API. Contohnya, untuk menentukan jumlah kuantiti boleh dijual bagi sesuatu varian dalam aliran kerja, anda akan menggunakan pemboleh ubah variants_item.inventoryQuantity. Sebagai contoh lain, untuk menentukan lokasi pelanggan melanggan surat berita e-mel anda, anda akan menggunakan pemboleh ubah emailSubscriptionMethod.

Anda tidak perlu mahir dengan API untuk mencipta aliran kerja menggunakan aplikasi Flow, tetapi pemahaman yang sedikit tentang nama pemboleh ubah serta takrifannya boleh membantu anda membina logik aliran kerja khusus yang anda mahukan. Contohnya, jika anda mengetahui perbezaan antara displayName dengan firstName pelanggan, ini boleh membantu aliran kerja anda mengakses data yang betul, bergantung pada tujuan penggunaannya. Takrifan disertakan dengan setiap pemboleh ubah semasa anda membina aliran kerja anda, dan anda boleh mengklik untuk mengetahui lebih lanjut tentang mana-mana pemboleh ubah atau takrifan.

Data kedai dan GraphQL Admin API

Aliran kerja menggunakan data daripada kedai anda dalam syarat dan tindakan. Flow mengakses data kedai menggunakan GraphQL Admin API, yang bermakna anda mempunyai akses kepada hampir semua medan dalam API tersebut. Jika tindakan tidak mempunyai data yang diperlukan dan disediakan oleh pencetus atau tindakan Dapatkan data, maka aliran kerja tidak akan dijalankan dan mesej ralat akan dipaparkan.

Contohnya, satu aliran kerja bermula dengan pencetus Pelanggan dicipta dan mengimport data pelanggan ke dalam aliran kerja. Jika pencetus itu diikuti dengan tindakan Tambah tag pesanan, yang memerlukan data pesanan dan bukannya data pelanggan, maka aliran kerja akan mengakibatkan ralat data tiada.

Anda mungkin perlu pratonton data atau menyemak dokumentasi API untuk memahami apa yang dioutputkan oleh API tersebut dan digunakan dalam Flow, serta memastikan aliran kerja anda mengoutputkan data yang anda jangkakan.

Argumen medan dan GraphQL Admin API

Sesetengah medan GraphQL Admin API memerlukan argumen, iaitu parameter tambahan yang mengecilkan skop data yang dikembalikan. Contohnya, medan product.inCollection memerlukan argumen id koleksi untuk mengetahui koleksi yang mahu disemak. Tanpanya, medan tersebut tidak dapat mengembalikan hasil.

Dalam Flow, anda boleh mencipta pemboleh ubah daripada medan ini dengan memberikan nilai hujah yang diperlukan, yang kemudiannya boleh digunakan dalam aliran kerja. Anda juga boleh menetapkan nama tersuai pada pemboleh ubah untuk menjadikannya lebih mudah dirujuk dalam langkah seterusnya, sebagai contoh, menamakan product.inCollection(id: "gid://shopify/Collection/123456") sebagai product.inSummerBestsellers.

Ketahui lebih lanjut tentang mencipta pemboleh ubah daripada medan dengan hujah.

Mencipta pemboleh ubah daripada medan meta memerlukan maklumat tambahan dalam Flow kerana anda mentakrifkan ruang nama dan kunci setiap medan meta sendiri, jadi hujah sentiasa unik untuk kedai anda. Ketahui lebih lanjut tentang medan meta dalam Flow.

Pemversian API

Shopify mengeluarkan versi API baharu setiap 3 bulan dan Flow menerima pakai versi baharu secepat mungkin, tetapi mungkin ketinggalan di belakang versi terkini. Jika boleh, perubahan antara versi akan diselesaikan secara automatik, tetapi sesetengah perubahan mungkin tidak mudah, termasuk mana-mana situasi yang berikut:

• Apabila medan dialih keluar tetapi tiada penggantian diberikan, yang berpotensi menjejaskan cara syarat atau Liquid dinilai.
• Apabila medan menjadi boleh nol, yang berpotensi menjejaskan cara syarat atau Liquid dinilai.
• Apabila nilai enum berubah atau kesatuan atau jenis antara muka baharu ditambahkan, yang berpotensi menjejaskan Liquid atau kod.
• Apabila hujah mutasi berubah, yang berpotensi menjejaskan konfigurasi tindakan permintaan Hantar Admin API.

Sesetengah aliran kerja mungkin perlu dikemaskinikan secara manual. Dalam kes ini, aliran kerja mungkin memaparkan ralat Kemas kini diperlukan atau API Tidak Disokong dan membimbing anda ke dokumentasi API yang berkaitan untuk membuat perubahan yang diperlukan dalam editor aliran kerja. Apabila kemas kini ini selesai dan disimpan, aliran kerja akan mengemas kini secara automatik untuk menggunakan versi API terkini yang tersedia dalam Flow.

Anda boleh memilih untuk mengabaikan isu buat sementara waktu bagi membuat perubahan mendesak pada aliran kerja dengan ralat keserasian versi API. Jika isu ini tidak ditangani, aliran kerja mungkin berhenti berjalan atau menyebabkan ralat apabila versi API yang lebih lama tidak lagi disokong oleh Shopify.