Konum verilerini al

Konum verileri gerektiren iş akışlarında, Shopify mağazanızdan konum bilgilerini almak için Konum verilerini al eylemini kullanabilirsiniz. Konumlar, envanter depoladığınız, ürün sattığınız veya sipariş gönderdiğiniz herhangi bir yerdir.

Not

Bu, bir Veri al eylemi türüdür. Bu eylem türünün Zamanlanmış zaman tetikleyicisi ve Her biri için döngüleriyle nasıl kullanılacağını anlamak için Shopify Flow'da planlar, veri alma ve döngüsel iş akışları belgesine bakın.

Yapılandırma

Alanlar

Konum verilerini al eylemi aşağıdaki alanları içerir.

Veri al eylemlerinde kullanılan alanlar.

Alan	Açı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ı. Tek seferde 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, mağazadan teslim alma seçeneğinin etkinleştirildiği konumları almak için kullanılan örnek bir sorgudur:

pickup_in_store:enabled

pickup_in_store değişkeni, Konumlar sorgusunda kullanılabilen bir filtredir. Bu filtre, birden çok kez kullanılabilir veya diğer değişkenlerle birleştirilebilir.

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

• Kullanılabilir konum filtrelerinin listesi

• Sorguların belirli bir söz dizimine uyması gerekir

• Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda 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ş sorgusu 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ç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 örneğinize bağlı olarak bu verileri çeşitli şekillerde kullanmak isteyebilirsiniz:

• Her bir liste öğesini ayrı ayrı işlemeniz gerekiyorsa (örneğin, her birine bir etiket eklemek için) Her biri için eylemini kullanabilirsiniz.
• Verileri toplamanız gerekiyorsa (örneğin, döndürülen sonuç sayısını saymak için) Say veya Topla eylemlerini kullanabilirsiniz.
• Listeyi çıktı olarak almanız gerekiyorsa (örneğin, tüm ürünleri içeren bir e-posta göndermek için) 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 konumlar listesi olan Konum verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de eylemlerde kullanabilirsiniz. Örneğin, konum listesini Dahili e-posta gönder eyleminde şu şekilde gönderebilirsiniz:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Not

Bir Veri al eylemi tek bir iş akışında birden çok kez kullanılırsa değişken adına bir sayı eklenir. Örneğin, Sipariş verilerini al eylemini iki kez kullanan bir iş akışında, döndürülen veriler için ilk değişken getOrderData, ikinci değişken ise getOrderData1 olur. Bu ad özelleştirilemez.

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 etkinliğin sonucu olarak değil, belirttiğiniz bir zamanda başlar. Mağazanızda veya bir uygulamada iş akışını başlatan belirli bir etkinlik olmadığından, otomatik olarak dahil edilen hiçbir veri yoktur.

API Referansı

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