Ürün verilerini al

Ürün verilerini kullanan iş akışlarında, mağazanızdan ürün bilgilerini almak için Ürün verilerini al eylemini kullanabilirsiniz.

Not

Bu bir tür Veri al eylemidir. Bu eylem türünü Zamanlanmış tetikleyici ve Her bir döngü için eylemleriyle nasıl kullanacağınızı anlamak üzere Shopify Flow'da zaman planlamaları, veri alma ve döngülü iş akışları belgesine bakın.

Yapılandırma

Alanlar

Ürün verilerini al eylemi, sorguyu oluşturmak için kullanılan aşağıdaki alanları içerir:

Veri al eylemlerinde kullanılan alanlar.

Alan	Açıklama
Verileri sıralama ölçütü	Gerekli. Arama sorgusuyla döndürülen verilerin sıralanacağı parametreler.
Maksimum sonuç sayısı	Gerekli. 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	Gerekli. Yaygın sorgular arasından seçim yapın veya kendi sorgunuzu oluşturmak için Gelişmiş'i seçin.

Sorgu Dizesi

Aşağıda, son bir günde güncellenen ürünleri almak için kullanılan bir örnek sorgu verilmiştir:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

updated_at değişkeni, Ürünler sorgusunda kullanılabilen bir filtredir ve birden çok kez kullanılabilir veya diğer değişkenlerle birleştirilebilir. scheduledAt Liquid değişkeni, Zamanlanmış tetikleyiciyi kullanan iş akışlarında kullanılabilir. date_minus Liquid etiketi, bir tarihten zaman çıkarmanıza olanak tanıyan özel bir Flow etiketidir.

Veri sorgularken aşağıdakileri bilmek faydalı olacaktır:

• Kullanılabilir ürün filtrelerinin listesi
• Sorguların belirli bir söz dizimine uyması gerekir.
• Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda değerler, API belgelerine bakılarak bulunabilir. Alternatif olarak, yönetici panelinde filtreleme yaptığınızda alan değerlerini genellikle URL'lerde bulabilirsiniz. Örneğin, bazı Sipariş sorgu değerlerini bulmak için yönetici panelindeki Siparişler sayfasını filtreleyin ve ardından URL'yi kontrol edin.
• Shopify GraphiQL uygulamasını kullanarak mağazanızda bir sorgu çalıştırabilir veya test edebilirsiniz.
• Sorgunuz başarısız olursa ne olacağına dikkat edin. API, genellikle hiç sonuç döndürmek yerine tüm sonuçları döndürür.

Alınan veriler

Tüm Veri al eylemleri, 0 ila 100 arasında kaynak içeren bir liste döndürür. Kullanım örneğinize bağlı olarak bu verileri çeşitli şekillerde kullanmak isteyebilirsiniz:

• Her bir liste öğesini ayrı ayrı işlemeniz gerekiyorsa (örneğin her birine etiket eklemek gibi), Her bir döngü için eylemini kullanabilirsiniz.
• Verileri toplamanız gerekiyorsa (örneğin kaç sonucun döndürüldüğünü saymak gibi), Say veya Topla eylemlerini kullanabilirsiniz.
• Listeyi çıktı olarak vermeniz gerekiyorsa (örneğin tüm ürünleri içeren bir e-posta göndermek gibi), sonraki eylemlerde alınan verileri doğrudan kullanabilirsiniz.

Bu eylemi izleyen adımlarda alınan verilere erişmek için, bir ürün listesi olan Ürün verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de eylemlerde kullanabilirsiniz. Örneğin, ürün listesini bir Dahili e-posta gönder eyleminde şu şekilde gönderebilirsiniz:

{% for single_product in GetProductData %}
* {{ single_product.name }}
{% endfor %}

Not

Bir Veri al eylemi tek bir iş akışında 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, alınan verilere yönelik ilk değişken getOrderData ve ikinci değişken getOrderData1 olur. Bu ad özelleştirilemez.

Tetikleyiciler

Bu eylemi, Zamanlanmış tetikleyici dahil olmak üzere herhangi bir iş akışında kullanabilirsiniz. Zamanlanmış tetikleyiciyi kullanan bir iş akışında, iş akışı bir etkinliğin sonucu olarak değil, belirttiğiniz bir zamanda başlar. İş akışını başlatan, mağazanızda veya bir uygulamada gerçekleşen belirli bir etkinlik olmadığından, otomatik olarak dahil edilen hiçbir veri olmaz.

API ayrıntıları

• Ürün kaynağı
• Ürün sorgusu filtreleri

Şablonlar

Belirli bir etikete sahip ürünleri gelecekte bir koleksiyona ekleme

Gelecekteki bir tarihte, belirli bir etikete sahip tüm ürünleri alın ve ardından bunları bir koleksiyona ekleyin. Şablonu görüntüle

Etkin olmayan ürünleri silme

Envanteri olmayan ve bir yıldır güncellenmemiş ürünleri silin. Şablonu görüntüle

Belirli bir etikete sahip ürünleri gelecekte yayınlama

Gelecekteki bir tarihte, belirli bir etikete sahip ürünleri alın ve yayınlayın. Zamanlanmış tetikleyici ve Ürün verilerini al eylemi kullanılır. Şablonu görüntüle

Ürün oluşturulduktan 90 gün sonra yeni ürün etiketini kaldırma

Her gün, 90 günden daha uzun bir süre önce oluşturulan ve hâlâ "yeni" etiketine sahip olan en fazla 100 ürünü alır. Ardından iş akışı, her bir ürün için bu etiketleri kaldırır. Şablonu görüntüle

Belirtilen tarih ve saatte ürünlerin Online Mağaza'dan kaldırılmasını zamanlama

Gelecekteki tek bir tarihte, ürünleri etikete, kimliğe veya SKU'ya göre online mağazadan kaldırın. Zamanlanmış tetikleyici, Ürün Verilerini Al eylemi ve For each döngüsü kullanılır. Şablonu görüntüle

Stokta olmayan ürünlerin yer aldığı günlük e-posta özeti gönderme

Her gün, envanteri 0 olan tüm ürünleri alır ve bir e-posta özeti gönderir. Ürün verilerini al ve Zamanlanmış tetikleyici eylemlerini kullanır. Şablonu görüntüle

Aynı SKU'ya sahip bir varyasyon eklendiğinde e-posta bildirimi gönderme

Yeni bir varyasyon eklendiğinde, başka varyasyonların aynı SKU'yu kullanıp kullanmadığını kontrol eder. Kullanıyorsa etkilenen ürünlere ve varyasyonlara yönlendiren bağlantılar içeren bir dahili e-posta gönderir. Şablonu görüntüle

Bir ürün meta alanı kullanarak indirimdeki ürün varyasyonlarını takip etme

Varyasyonlarından en az biri indirimdeyse ürüne bir meta alan ayarlar. Bu, o anda hangi ürünlerin indirimde olduğunu takip etmek için yararlı olabilir. Şablonu görüntüle