Aboneliği faturalandırma girişimi verilerini al
Abonelik Aboneliği faturalandırma girişimi verilerini kullanan iş akışlarında, mağazadan sipariş bilgilerini almak için Aboneliği faturalandırma girişimi verilerini al eylemini kullanabilirsiniz.
Bu sayfada
Yapılandırma
Alanlar
Aboneliği faturalandırma girişimi 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ı | Gerekli. 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 | Gerekli. Yaygın sorgulardan birini seçin veya kendi sorgunuzu oluşturmak için Gelişmiş'i seçin. |
Sorgu Dizesi
Bu, son üç gün içinde oluşturulan abonelik faturalandırma girişimlerini almaya yönelik örnek bir sorgudur:
created_at:>'{{ createdAt | date_minus: "3 day" }}'created_at değişkeni, aboneliği faturalandırma girişimi sorgusunda kullanılabilen bir filtredir ve aboneliği faturalandırma girişimlerine yönelik belirli bir hata mesajını seçmek için kullanılabilir.
Veri sorgusu yaparken şunları bilmek faydalıdır:
- Kullanılabilecek aboneliği faturalandırma girişimi filtrelerinin listesi - Sorgular belirli bir sözdizimine sahip olmalıdır
- Tüm sorgular için sorgu alanı adları, QueryRoot nesnesi ile ilgili geliştirici belgelerinde bulunabilir.
- 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, aboneliği faturalandırma girişimlerinin bir listesinden oluşan Aboneliği faturalandırma girişimi 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, aboneliği faturalandırma girişimlerinin bir listesini Dahili e-posta gönder işlemiyle gönderebilirsiniz:
{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
{{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}Örnek
Örneğin, bir iş akışının her Pazar günü saat 09:00'da başlayacak şekilde planlandığını varsayalım. Aboneliği faturalandırma girişimi verilerini al işlemi, son bir hafta içinde oluşturulan, aboneliği faturalandırma girişimlerinin verilerini toplamak için kullanılır. Bir hata mesajı varsa faturalandırma girişimlerini e-posta ile gönderin.