Ürün verilerini al
Ürün verilerini kullanan iş akışlarında mağazanızdan ürün verilerini almak için Ürün verilerini al işlemini kullanabilirsiniz.
Yapılandırma
Alanlar
Ürün verilerini al işlemi, sorguyu oluşturmak için kullanılan aşağıdaki alanları içerir:
| Alan | Açıklama |
|---|---|
| Verileri sıralama ölçütü | Gereklidir. Arama sorgusu tarafından döndürülen verilerin sıralanmasında kullanılan parametreler. |
| Maksimum sonuç sayısı | Gereklidir. Seçtiğiniz arama sorgusu tarafından döndürülebilecek maksimum sonuç sayısı. Bir seferde 100 adede kadar sonuç döndürebilirsiniz. |
| Sorgu | Gereklidir. Yaygın sorgulardan birini seçin veya kendi sorgunuzu oluşturmak için Gelişmiş'i seçin. |
Sorgu Dizesi
Bu, son bir gün içinde güncellenen ürünleri almaya yönelik örnek bir sorgudur:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'updated_at değişkeni, Ürünler sorgusunda kullanılabilen bir filtredir ve bir defadan fazla kullanılabilir veya diğer değişkenlerle birleştirilebilir. scheduledAt Liquid değişkeni, Planlanan zaman tetikleyicisini kullanan iş akışlarında kullanılabilir. date_minus Liquid etiketi, bir tarihten zaman çıkarmanıza olanak sağlayan özel bir Flow etiketidir.
Veri sorgusu yaparken şunları bilmek faydalıdır:
- Kullanılabilecek ürün filtrelerinin listesi - Sorgular belirli bir sözdizimine sahip olmalıdır
- Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda değerler, API belgelerine bakarak bulunabilir. Alternatif olarak, filtreleme yaparken alan değerlerini genellikle Yöneticideki URL'lerde bulabilirsiniz. Örneğin, bazı Sipariş sorgusu değerlerini bulmak için Yöneticideki Siparişler sayfasını filtreleyin ve 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 etmeniz gerekir. Genellikle API tüm sonuçları (sıfır sonuç yerine) döndürür.
Döndürülen veriler
Tüm Veri al işlemleri, 0 ile 100 arasında kaynağın bir listesini döndürür. Kullandığınız duruma bağlı olarak, bu verileri çeşitli şekillerde kullanmak isteyebilirsiniz:
- Her liste öğesi için ayrı ayrı işlem yapmanız gerekiyorsa (her birine bir etiket eklemek gibi), For each eylemini kullanabilirsiniz.
- Verileri toplamanız gerekiyorsa (kaç sonuç döndürüldüğünü saymak gibi) Count veya Sum işlemlerini kullanabilirsiniz.
- Listenin çıktısını almanız gerekiyorsa (tüm öğeleri içeren bir e-posta göndermek gibi) döndürülen verileri sonraki işlemlerde doğrudan kullanabilirsiniz.
Bu işlemi takip eden adımlarda döndürülen verilere erişmek için, ürünlerin bir listesinden oluşan Ürün verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de işlemlerde kullanabilirsiniz. Örneğin, aşağıda gösterildiği gibi, ürünlerin bir listesini Dahili e-posta gönder işlemiyle gönderebilirsiniz:
{% for single_product in GetProductData %}
- {{ single_product.name }}
{% endfor %}Tetikleyiciler
Bu işlemi, Planlanan zaman tetikleyicisi de dahil olmak üzere herhangi bir iş akışında kullanabilirsiniz. Planlanan zaman tetikleyicisini kullanan bir iş akışı, etkinlik sonucunda değil, belirttiğiniz zamanda başlatılır. Mağazanızdan veya iş akışını başlatan bir uygulamadan gelen belirli bir etkinlik olmadığından hiçbir veri otomatik olarak dahil edilmez.
API ayrıntıları
Şablonlar
Bir etikete sahip ürünleri gelecekte bir koleksiyona ekleme
Gelecekteki bir tarihte, belirli bir etikete sahip tüm ürünleri alın ve bir koleksiyona ekleyin. Şablonu görüntüleyin
Etkin olmayan ürünleri silme
Bir yıl içinde güncellenmemiş ve envanteri olmayan ürünleri silin. Şablonu görüntüleyin
Belirli bir etikete sahip ürünleri ileri bir tarihte yayınlama
İlerideki bir tarihte, belirli bir etikete sahip ürünleri alın ve yayınlayın. Planlanan zaman tetikleyicisini ve Ürün verilerini al işlemini kullanın. Şablonu görüntüleyin
Ürünün oluşturulmasından 90 gün sonra yeni ürün etiketini kaldır
Her gün, 90 günden daha uzun bir süre önce oluşturulmuş ve hâlâ "yeni" etiketini taşıyan en fazla 100 ürünün bilgilerini alır. Ardından iş akışı, her bir üründen bu etiketi kaldırır. Şablonu görüntüleyin
Ürünleri belirtilen bir tarih ve saatte Online Mağazadan kaldırılacak şekilde planlama
Gelecekteki bir tarihte etikete, kimliğe veya SKU'ya göre ürünleri online mağazadan kaldırın. Planlanan zaman tetikleyicisi, Ürün verilerini al işlemi ve For Each döngüsünden yararlanın. Şablonu görüntüleyin
Stokta olmayan ürünlerin günlük özetini e-posta ile gönderme
Her gün envanteri 0 olan tüm ürünlerin bilgilerini alır ve e-postayla bir özet gönderir. Ürün verilerini al işlemini ve Planlanan zaman tetikleyicisini kullanır. Şablonu görüntüleyin
Yinelenen SKU ile varyasyon eklendiğinde e-posta bildirimi gönder
Yeni bir varyasyon eklendiğinde aynı SKU'yu kullanan başka bir varyasyon olup olmadığına bakılır. Böyle bir durumda etkilenen ürünlere ve varyasyonlara bağlantı içeren dahili bir e-posta gönderilir. Şablonu görüntüleyin
Ürün meta alanı kullanarak indirimdeki ürün varyasyonlarını takip et
En az bir varyasyonu indirimde olan ürünlere meta alan ekler. Bu, belirli bir anda hangi ürünlerin indirimde olduğunu takip etmek için faydalı olabilir. Şablonu görüntüleyin