Envanter ürünü verilerini al

Envanter ürünü verisi gerektiren iş akışlarında, mağazanızdan envanter ürünü bilgilerini almak için Envanter ürünü verilerini al eylemini kullanabilirsiniz. Envanter ürünleri, ürün varyasyonları için takip edilen gerçek stok birimlerini temsil eder.

Bu sayfada

Yapılandırma

Alanlar

Envanter ürünü verilerini al eylemi aşağıdaki alanları içerir:

Veri al eylemlerinde kullanılan alanlar.
Alan	Açıklama
Verileri şuna göre sırala:	Zorunludur. Arama sorgusu tarafından döndürülen verilerin sıralandığı parametreler.
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

Takip edilen envanter ürünlerini almak için örnek bir sorgu şudur:

tracked:true

tracked değişkeni, Envanter ürünleri 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 envanter ürünü 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 ürünlerin yer aldığı bir e-posta göndermek gibi işlemler için listeyi çıktı olarak vermeniz gerekirse döndürülen verileri doğrudan sonraki eylemlerde kullanabilirsiniz.

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

{% for single_inventory_item in getInventoryItemData %}
  * SKU: {{ single_inventory_item.sku }} - Cost: {{ single_inventory_item.unitCost.amount }}
{% endfor %}

Tetikleyiciler

Bu eylemi, Planlanan zaman tetikleyicisi de dahil olmak üzere dilediğiniz iş akışında kullanabilirsiniz. Planlanan zaman tetikleyicisini kullanan bir iş akışı, bir olayın sonucu olarak değil, belirttiğiniz bir zamanda başlar. Mağazanızda veya bir uygulamada iş akışını başlatan belirli bir olay olmadığı için veriler otomatik olarak dahil edilmez.

API referansı

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