Shopify Flow dan GraphQL Admin API

Flow menggunakan GraphQL Admin API Shopify untuk membangun otomatisasi dan integrasi yang memperluas dan menyempurnakan admin Shopify. Flow menggunakan API versi 2026-01 untuk mengevaluasi kondisi dan variabel dalam alur kerja serta melakukan tindakan di toko Shopify Anda. Karena Flow mengakses data toko dengan memanggil API, Anda memiliki akses ke hampir semua kolom yang tersedia di API dari Flow.

Karena Shopify merilis versi API baru setiap 3 bulan, beberapa alur kerja mungkin perlu diperbarui saat kolom diubah atau tidak digunakan lagi.

Menggunakan GraphQL Admin API dalam alur kerja

Sebagian besar tindakan di Flow menggunakan GraphQL Admin API untuk membuat perubahan pada toko Shopify Anda. Misalnya, tindakan Tambahkan tag pesanan menggunakan mutasi tagsAdd. Tindakan Kirim permintaan Admin API dapat menggunakan sebagian besar mutasi, termasuk yang belum tersedia sebagai tindakan di Flow.

Saat membuat alur kerja, Anda akan sering menemukan nama kolom dan deskripsi berdasarkan sintaksis GraphQL Admin API. Misalnya, untuk menentukan total kuantitas varian yang layak jual dalam alur kerja, Anda akan menggunakan variabel variants_item.inventoryQuantity. Sebagai contoh lain, untuk menentukan lokasi tempat pelanggan berlangganan buletin email Anda, Anda akan menggunakan variabel emailSubscriptionMethod.

Anda tidak perlu mahir dengan API untuk membuat alur kerja dengan aplikasi Flow, tetapi memahami sedikit tentang nama variabel dan definisinya dapat membantu Anda membangun logika alur kerja spesifik yang Anda inginkan. Misalnya, mengetahui perbedaan antara displayName dan firstName pelanggan dapat membantu alur kerja Anda mengakses data yang benar, tergantung tujuan Anda menggunakannya. Definisi disertakan dengan setiap variabel saat Anda membangun alur kerja, dan Anda dapat mengeklik untuk mempelajari selengkapnya tentang variabel atau definisi apa pun.

Data toko dan GraphQL Admin API

Alur kerja menggunakan data dari toko Anda dalam kondisi dan tindakan. Flow mengakses data toko menggunakan GraphQL Admin API, yang berarti Anda memiliki akses ke hampir semua kolom di API. Jika suatu tindakan tidak memiliki data yang diperlukan yang disediakan oleh pemicu atau tindakan Dapatkan data, alur kerja tidak akan dieksekusi dan pesan error akan ditampilkan.

Misalnya, alur kerja dimulai dengan pemicu Pelanggan dibuat dan mengimpor data pelanggan ke dalam alur kerja. Jika pemicu tersebut diikuti dengan tindakan Tambahkan tag pesanan, yang memerlukan data pesanan dan bukan data pelanggan, alur kerja akan menghasilkan error data tidak ada.

Anda mungkin perlu mempratinjau data atau meninjau dokumentasi API untuk memahami apa yang dihasilkan oleh API dan digunakan di Flow, serta untuk memastikan bahwa alur kerja Anda menghasilkan data yang Anda harapkan.

Argumen bidang dan GraphQL Admin API

Beberapa bidang GraphQL Admin API memerlukan argumen, parameter tambahan yang mempersempit data yang dikembalikan. Misalnya, bidang product.inCollection memerlukan argumen id koleksi untuk mengetahui koleksi mana yang harus diperiksa. Tanpanya, bidang tidak dapat mengembalikan hasil.

Di Flow, Anda dapat membuat variabel dari bidang ini dengan memberikan nilai argumen yang diperlukan, yang selanjutnya dapat digunakan dalam alur kerja. Anda juga dapat menetapkan nama khusus pada variabel agar lebih mudah dirujuk pada langkah berikutnya, misalnya, menamai product.inCollection(id: "gid://shopify/Collection/123456") sebagai product.inSummerBestsellers.

Pelajari selengkapnya tentang membuat variabel dari bidang dengan argumen.

Membuat variabel dari bidang meta memerlukan informasi tambahan di Flow karena Anda mendefinisikan ruang nama dan kunci bidang meta sendiri, sehingga argumennya selalu unik untuk toko Anda. Pelajari selengkapnya tentang bidang meta di Flow.

Pemberian versi API

Shopify merilis versi API baru setiap 3 bulan dan Flow mengadopsi versi baru sesegera mungkin, tetapi mungkin tertinggal dari versi terbaru. Jika memungkinkan, perubahan antarversi diselesaikan secara otomatis, tetapi beberapa perubahan mungkin tidak langsung, termasuk salah satu situasi berikut:

• Saat kolom dihapus tetapi tidak ada pengganti yang disediakan, yang berpotensi memengaruhi cara kondisi atau Liquid dievaluasi.
• Saat kolom menjadi dapat di-nol-kan, yang berpotensi memengaruhi cara kondisi atau Liquid dievaluasi.
• Saat nilai enum berubah atau jenis gabungan atau antarmuka baru ditambahkan, yang berpotensi memengaruhi Liquid atau kode.
• Saat argumen mutasi berubah, yang berpotensi memengaruhi konfigurasi tindakan Kirim permintaan Admin API.

Beberapa alur kerja mungkin perlu diperbarui secara manual. Dalam kasus ini, alur kerja mungkin menampilkan eror Pembaruan diperlukan atau API tidak didukung dan memandu Anda ke dokumentasi API yang relevan untuk membuat perubahan yang diperlukan di editor alur kerja. Saat pembaruan ini selesai dan disimpan, alur kerja akan diperbarui secara otomatis untuk menggunakan versi API terbaru yang tersedia di Flow.

Anda dapat memilih untuk mengabaikan masalah untuk sementara waktu guna membuat perubahan mendesak pada alur kerja dengan error kompatibilitas versi API. Jika masalah ini tidak diatasi, alur kerja mungkin berhenti dieksekusi atau menyebabkan error saat versi API yang lebih lama tidak lagi didukung oleh Shopify.