Hediye kartı verilerini al
Hediye kartı verileri gerektiren iş akışlarında, mağazanızdan hediye kartı bilgilerini almak için Hediye kartı verilerini al eylemini kullanabilirsiniz.
Önemli bir nokta olarak mağazanızda hem hediye kartı oluşturmak için kullanılan hediye kartı ürünleri hem de müşterilerin satın alım yapmak için kullanabileceği gerçek hediye kartları bulunur. Hediye kartı verilerini al eylemi, hediye kartlarının kendileri hakkında bilgi alır. Hediye kartı ürünleri hakkında bilgi almak için Ürün verilerini al veya Ürün varyasyonu verilerini al eylemlerini kullanın.
Yapılandırma
Alanlar
Hediye kartı verilerini al eylemi, sorguyu oluşturmak için kullanılan aşağıdaki alanları içerir:
| Alan | Açıklama |
|---|---|
| Verileri şuna göre sırala | Gerekli. Arama sorgusu tarafından 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ıdır. Her seferinde 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
Bu, son günde güncellenen hediye kartlarını almak için örnek bir sorgudur:
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'created_at değişkeni, hediye kartları 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ış zaman tetikleyicisini kullanan iş akışlarında kullanılabilir. date_minus Liquid etiketi, bir tarihten zaman çıkarmanıza olanak tanıyan özel bir Flow etiketidir.
Verileri sorgularken aşağıdakileri bilmek yararlı olacaktır:
Sorgular, belirli bir söz dizimine uymalıdır
Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda bu 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.
Mağazanızda bir sorguyu Shopify GraphiQL uygulamasını kullanarak çalıştırabilir veya test edebilirsiniz.
Sorgunuzun başarısız olması durumunda ne olacağını göz önünde bulundurun. API, genellikle (hiçbir sonuç döndürmek yerine) tüm sonuçları döndürür.
Döndürülen veriler
Tüm Veri al eylemleri, 0 ila 100 arasında kaynak içeren bir liste döndürür. Kullanım senaryonuza bağlı olarak, bu verileri çeşitli şekillerde kullanmak isteyebilirsiniz:
- Her bir liste öğesini (örneğin her birine bir etiket eklemek için) ayrı ayrı işlemeniz gerekiyorsa Her biri için eylemini kullanabilirsiniz.
- Döndürülen sonuç sayısı gibi verileri toplamanız gerekiyorsa Sayı veya Toplam eylemlerini kullanabilirsiniz.
- Tüm öğeleri içeren bir e-posta göndermek gibi, listenin çıktısını almanız gerekiyorsa döndürülen verileri sonraki eylemlerde doğrudan kullanabilirsiniz.
Bu eylemi izleyen adımlarda döndürülen verilere erişmek için Hediye kartı verilerini al adlı değişkeni kullanın. Bu değişken, hediye kartlarından oluşan bir listedir. Bu değişkeni hem koşullarda hem de eylemlerde kullanabilirsiniz. Örneğin, Dahili e-posta gönder eyleminde hediye kartları listesini şu şekilde gönderebilirsiniz:
{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}Tetikleyiciler
Bu eylemi, Zamanlanmış zaman tetikleyicisi de dahil olmak üzere herhangi bir iş akışında kullanabilirsiniz. Zamanlanmış zaman tetikleyicisini kullanan bir iş akışında, iş akışı bir olayın sonucu olarak değil, sizin belirttiğiniz bir zamanda başlar. Mağazanızda veya bir uygulamada, iş akışını başlatan belirli bir olay olmadığından otomatik olarak dahil edilen hiçbir veri olmaz.