Shopify Flow ve GraphQL Admin API

Flow, Shopify yöneticisini genişleten ve geliştiren otomasyonlar ile entegrasyonlar oluşturmak için Shopify GraphQL Admin API'sini kullanır. Flow, Shopify mağazanızda işlemler gerçekleştirmenin yanı sıra iş akışlarındaki durumları ve değişkenleri değerlendirmek için API'nin 2026-01 sürümünü kullanır. Flow, mağaza verilerine API'yi çağırarak eriştiği için API'de mevcut olan neredeyse tüm alanlara Flow üzerinden erişebilirsiniz.

Shopify her 3 ayda bir yeni API sürümleri yayınladığından, alanlar değiştirildiğinde veya kullanımdan kaldırıldığında bazı iş akışlarının güncellenmesi gerekebilir.

İş akışlarında GraphQL Admin API'sini kullanma

Flow'daki çoğu işlem, Shopify mağazanızda değişiklik yapmak için GraphQL Admin API'sini kullanır. Örneğin, Sipariş etiketleri ekle işlemi tagsAdd mutasyonunu kullanır. Admin API talebi gönder işlemi, Flow'da henüz işlem olarak mevcut olmayanlar da dahil olmak üzere çoğu mutasyonu kullanabilir.

İş akışları oluştururken genellikle GraphQL Admin API söz dizimine dayalı alan adları ve açıklamalarıyla karşılaşırsınız. Örneğin, bir iş akışında bir varyasyonun toplam satılabilir miktarını belirlemek için variants_item.inventoryQuantity değişkenini kullanırsınız. Başka bir örnek olarak, bir müşterinin e-posta bülteninize abone olduğu konumu belirlemek için emailSubscriptionMethod değişkenini kullanırsınız.

Flow uygulamasıyla iş akışları oluşturmak için API'ye hakim olmanız gerekmez ancak değişken adları ve tanımları hakkında biraz bilgi sahibi olmak, istediğiniz özel iş akışı mantığını oluşturmanıza yardımcı olabilir. Örneğin, bir müşterinin displayName'i ile firstName'i arasındaki farkı bilmek, verileri ne için kullanmak istediğinize bağlı olarak iş akışınızın doğru verilere erişmesine yardımcı olabilir. İş akışınızı oluştururken her değişkenin tanımı da bulunur. Herhangi bir değişken veya tanım hakkında daha fazla bilgi edinmek için simgesine tıklayabilirsiniz.

Mağaza verileri ve GraphQL Admin API

İş akışları, durumlarda ve işlemlerde mağazanızdaki verileri kullanır. Flow, mağaza verilerine GraphQL Admin API'sini kullanarak erişir. Bu da API'deki neredeyse tüm alanlara erişiminiz olduğu anlamına gelir. Bir işlem, tetikleyici veya Veri al işlemi tarafından sağlanan gerekli verilere sahip değilse iş akışı çalışmaz ve bir hata mesajı görüntülenir.

Örneğin, bir iş akışı Müşteri oluşturuldu tetikleyicisiyle başlar ve müşteri verilerini iş akışına aktarır. Bu tetikleyicinin ardından müşteri verilerini değil, sipariş verilerini gerektiren Sipariş etiketleri ekle işlemi gelirse iş akışı, eksik veri hatasıyla sonuçlanır.

API tarafından neyin çıktısının verildiğini ve Flow'da neyin kullanıldığını anlamak ve iş akışınızın beklediğiniz verileri çıkardığından emin olmak için verileri önizlemeniz veya API belgelerini incelemeniz gerekebilir.

Alan bağımsız değişkenleri ve GraphQL Admin API

Bazı GraphQL Admin API alanları, döndürülen verileri daraltan ek parametreler olan bağımsız değişkenler gerektirir. Örneğin product.inCollection alanının, hangi koleksiyonun kontrol edileceğini bilmesi için bir koleksiyon id bağımsız değişkenine ihtiyacı vardır. Bu olmadan alan sonuç döndüremez.

Flow'da, gerekli bağımsız değişken değerini sağlayarak bu alanlardan iş akışında kullanılabilecek değişkenler oluşturabilirsiniz. Ayrıca, sonraki adımlarda başvurmayı kolaylaştırmak için değişkene özel bir ad da atayabilirsiniz; örneğin, product.inCollection(id: "gid://shopify/Collection/123456") alanını product.inSummerBestsellers olarak adlandırmak gibi.

Bağımsız değişkeni olan alanlardan değişken oluşturma hakkında daha fazla bilgi edinin.

Her meta alanın ad alanını ve anahtarını kendiniz tanımladığınız ve bu nedenle bağımsız değişkenler mağazanıza her zaman benzersiz olduğu için meta alanlardan değişken oluşturmak Flow'da ek bilgi gerektirir. Flow'daki meta alanlar hakkında daha fazla bilgi edinin.

API sürümleme

Shopify her 3 ayda bir yeni API sürümleri yayınlar ve Flow, yeni sürümleri mümkün olan en kısa sürede benimser ancak en son sürümün gerisinde kalabilir. Mümkün olduğunda, sürümler arasındaki değişiklikler otomatik olarak çözülür ancak aşağıdaki durumlar da dahil olmak üzere bazı değişiklikler karmaşık olabilir:

• Alanlar kaldırıldığında ve yerlerine yenisi sağlanmadığında, koşulların veya Liquid'in değerlendirilme şeklinin potansiyel olarak etkilenmesi.
• Alanlar boş değer alabilir hâle geldiğinde, koşulların veya Liquid'in değerlendirilme şeklinin potansiyel olarak etkilenmesi.
• Enum değerleri değiştiğinde ya da yeni birleşim veya arabirim türleri eklendiğinde, Liquid'in veya kodun potansiyel olarak etkilenmesi.
• Mutasyon bağımsız değişkenleri değiştiğinde, Admin API talebi gönder işlemlerinin yapılandırmasının potansiyel olarak etkilenmesi.

Bazı iş akışlarının manuel olarak güncellenmesi gerekebilir. Bu durumlarda iş akışları, Güncelleme gerekli veya Desteklenmeyen API hatası görüntüleyebilir ve iş akışı düzenleyicisinde gerekli değişiklikleri yapmanız için sizi ilgili API belgelerine yönlendirebilir. Bu güncellemeler tamamlanıp kaydedildiğinde, iş akışı otomatik olarak Flow'da mevcut olan en son API sürümünü kullanacak şekilde güncellenir.

API sürümü uyumluluk hataları olan bir iş akışında acil değişiklikler yapmak için sorunları geçici olarak yoksaymayı seçebilirsiniz. Bu sorunlar giderilmezse iş akışı, eski API sürümü Shopify tarafından artık desteklenmediğinde çalışmayı durdurabilir veya hatalara neden olabilir.