Yardım
Oturum aç

Abonelik faturalandırma girişimi verilerini al

Abonelik faturalandırma girişimi verileri gerektiren iş akışlarında, mağazanızdan sipariş bilgilerini almak için Abonelik faturalandırma girişimi verilerini al eylemini kullanabilirsiniz.

Bu sayfada

Yapılandırma

Alanlar

Abonelik faturalandırma girişimi verilerini al eylemi, sorguyu oluşturmak için kullanılan aşağıdaki alanları içerir:

Veri al eylemlerinde kullanılan alanlar.
AlanAçıklama
Verileri sıralama ölçütü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. Tek seferde en fazla 100 sonuç döndürebilirsiniz.
SorguGerekli. 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 üç gün içinde oluşturulan abonelik faturalandırma girişimlerini alan örnek bir sorgu verilmiştir:

created_at:>'{{ createdAt | date_minus: "3 day" }}'

created_at değişkeni, abonelik faturalandırma girişimi sorgusunda kullanılabilen bir filtredir ve abonelik faturalandırma girişimleri için belirli hata mesajlarını seçmek üzere kullanılabilir.

Verileri sorgularken aşağıdakileri bilmeniz faydalı olacaktır:

  • Mevcut abonelik faturalandırma girişimi filtrelerinin listesi
  • Sorguların belirli bir söz dizimine uyması gerekir.
  • Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda bu değerler, API belgelerine bakılarak bulunabilir. Alternatif olarak, filtreleme yaptığınızda alan değerlerini genellikle yönetici panelindeki 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 sorguyu test edebilirsiniz.
  • Sorgunuzun başarısız olması durumunda ne olacağına dikkat edin. API, genellikle hiç sonuç döndürmek yerine tüm sonuçları döndürür.

Döndürülen veriler

Tüm Veri al işlemleri, 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 birine etiket eklemek gibi, her liste öğesini ayrı ayrı işlemeniz gerekiyorsa Her biri için işlemini kullanabilirsiniz.
  • Döndürülen sonuçların sayısını bulmak gibi, verileri toplamanız gerekiyorsa Sayı veya Toplam işlemlerini kullanabilirsiniz.
  • Tüm ürünleri içeren bir e-posta göndermek gibi, listeyi çıktı olarak vermeniz gerekiyorsa sonraki işlemlerde döndürülen verileri doğrudan kullanabilirsiniz.

Bu işlemi izleyen adımlarda döndürülen verilere erişmek için abonelik faturalandırma girişimlerinin bir listesi olan Abonelik 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, abonelik faturalandırma girişimleri listesini Dahili e-posta gönder işleminde şu şekilde gönderebilirsiniz:

{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
  {{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}

Örnek

Örneğin, bir iş akışı her pazar saat 09:00'da çalışacak şekilde planlanmıştır. Abonelik faturalandırma girişimi verilerini al işlemi, geçen hafta oluşturulan abonelik faturalandırma girişimlerine ilişkin verileri toplamak için kullanılır. Bir hata mesajı varsa bu faturalandırma girişimleri e-postayla gönderilir.

API Referansı