Katalog verilerini al

Katalog verileri gerektiren iş akışlarında, mağazanızdaki B2B kataloğu bilgilerini almak için Katalog verilerini al işlemini kullanabilirsiniz. Kataloglar, belirli B2B müşterileri veya şirket konumları için özelleştirilmiş fiyatlandırmaya sahip ürün gruplarıdır.

Not

Bu, bir tür Veri al işlemidir. Bu işlem türünün Planlanan zaman tetikleyicisi ve Her biri için döngüleriyle nasıl kullanılacağını anlamak için Shopify Flow'da planlamalar, veri alma ve döngü iş akışları bölümüne bakın.

Yapılandırma

Alanlar

Katalog verilerini al işlemi aşağıdaki alanları içerir:

Veri al işlemlerinde kullanılan alanlar.

Alan	Açıklama
Verileri şuna göre sırala	Gereklidir. Arama sorgusu tarafından döndürülen verilerin sıralandığı parametrelerdir.
Maksimum sonuç sayısı	Zorunludur. Seçtiğiniz arama sorgusu tarafından döndürülebilecek maksimum sonuç sayısı. Tek seferde en fazla 100 sonuç döndürebilirsiniz.
Sorgu	Zorunludur. Yaygın sorgulardan birini seçin veya kendi sorgunuzu oluşturmak için Gelişmiş'i seçin.

Sorgu dizesi

Tüm etkin katalogları almak için örnek bir sorgu şudur:

status:ACTIVE

status değişkeni, Kataloglar sorgusunda kullanılabilen bir filtredir ve birden çok kez kullanılabilir veya diğer değişkenlerle birleştirilebilir.

Verileri sorgularken şunları bilmek faydalıdır:

• Kullanılabilir katalog filtreleri listesi

• Sorgular belirli bir söz dizimini izlemelidir

• Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda değerler, API belgelerine bakılarak bulunabilir. Alternatif olarak alan değerlerini, filtreleme yaparken genellikle yönetici panelindeki URL'lerde bulabilirsiniz. Örneğin, bazı Sipariş sorgusu değerlerini bulmak için yönetici panelinde Siparişler sayfasını filtreleyin ve ardından URL'yi kontrol edin.

• Shopify GraphiQL uygulamasını kullanarak mağazanızda bir sorguyu çalıştırabilir veya test edebilirsiniz.

• Sorgunuz başarısız olursa ne olacağına dikkat edin. Genellikle API (hiçbir sonuç yerine) tüm sonuçları döndürür.

Döndürülen veriler

Tüm Veri al eylemleri, 0 ile 100 arasında kaynaktan oluşan bir liste döndürür. Kullanım durumunuza bağlı olarak, bu verileri çeşitli şekillerde kullanmak isteyebilirsiniz:

• Her biri için bir etiket eklemek gibi liste öğelerini ayrı ayrı ele almanız gerekiyorsa Her biri için eylemini kullanabilirsiniz.
• Kaç sonuç döndürüldüğünü saymak gibi verileri birleştirmeniz gerekiyorsa Sayım veya Toplam eylemlerini kullanabilirsiniz.
• Tüm öğelerin bulunduğu bir e-posta göndermek gibi bir liste çıktısı almanız gerekiyorsa döndürülen verileri doğrudan sonraki eylemlerde kullanabilirsiniz.

Bu eylemi takip eden adımlarda döndürülen verilere erişmek için katalogların bir listesi olan Katalog verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de eylemlerde kullanabilirsiniz. Örneğin, katalogların listesini şuna benzer bir Dahili e-posta gönder eyleminde gönderebilirsiniz:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.title }}
{% endfor %}

Not

Tek bir iş akışında Veri al eylemi birden çok kez kullanılırsa değişken adına bir sayı eklenir. Örneğin, Sipariş verilerini al eylemini iki kez kullanan bir iş akışında, döndürülen veriler için ilk değişken getOrderData, ikinci değişken ise getOrderData1 olur. Bu ad özelleştirilemez.

Tetikleyiciler

Bu eylemi, Planlanmış zaman tetikleyicisi de dahil olmak üzere tüm iş akışlarında kullanabilirsiniz. Planlanmış zaman tetikleyicisini kullanan bir iş akışında, iş akışı bir olayın sonucu olarak değil, sizin belirttiğiniz bir zamanda başlatılır. Mağazanızda veya bir uygulamada iş akışını başlatan belirli bir olay olmadığı için otomatik olarak eklenen herhangi bir veri bulunmaz.

API Referansı

Bu eylemde kullanılan API hakkında daha fazla bilgi için Kataloglar sorgusu bölümüne bakın.