Yardım
Oturum aç

Abonelik sözleşmesi verilerini al

Abonelik sözleşmesi verilerini kullanan iş akışlarında, mağazanızdan abonelik sözleşmesi bilgilerini almak için Abonelik sözleşmesi verilerini al işlemini kullanabilirsiniz.

Bu sayfada

Yapılandırma

Alanlar

Abonelik sözleşmesi verilerini al işlemi, sorguyu oluşturmak için kullanılan aşağıdaki alanları içerir:

Veri al işlemlerinde kullanılan alanlar.
AlanAçıklama
Verileri sıralama ölçütüGerekli. Arama sorgusuyla döndürülen verilerin sıralanacağı parametreler.
Maksimum sonuç sayısıGerekli. Seçtiğiniz arama sorgusuyla döndürülebilecek maksimum sonuç sayısı. Tek seferde en fazla 100 sonuç döndürebilirsiniz.
SorguGerekli. Yaygın sorgulardan birini seçin veya kendi sorgunuzu oluşturmak için Gelişmiş'i seçin.

Sorgu Dizesi

Bu, durumu ACTIVE olan abonelik sözleşmelerini almak için bir örnek sorgudur:

status: ACTIVE

status değişkeni, Abonelik sözleşmeleri sorgusunda kullanılabilen bir filtredir ve birden çok kez kullanılabilir.

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

  • Kullanılabilir filtrelerin 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 sözleşmelerinin bir listesi olan Abonelik iletişim kişisi verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de işlemlerde kullanabilirsiniz. Örneğin, sipariş listesini Dahili e-posta gönder işleminde şu şekilde gönderebilirsiniz:

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

Tetikleyiciler

Bu eylemi, Zamanlanmış zaman tetikleyicisi de dahil olmak üzere tüm iş akışlarında kullanabilirsiniz. Zamanlanmış zaman tetikleyicisini kullanan bir iş akışında iş akışı, bir etkinliğin sonucu olarak değil sizin belirttiğiniz bir zamanda başlar. İş akışını başlatan, mağazanızdaki veya bir uygulamadaki belirli bir etkinlik olmadığından, otomatik olarak hiçbir veri dahil edilmez.

API Referansı