Konum verilerini al

Konum verileri gerektiren iş akışlarında, Shopify mağazanızdan konum bilgilerini almak için Konum verilerini al işlemini kullanabilirsiniz. Konumlar, envanteri depoladığınız, ürün sattığınız ya da siparişleri kargoladığınız veya gönderdiğiniz yerler olabilir.

Bu sayfada

Yapılandırma

Alanlar

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

Veri al işlemlerinde kullanılan alanlar.
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ı	Gereklidir. 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	Gereklidir. Yaygın sorgulardan birini seçin veya kendi sorgunuzu oluşturmak için Gelişmiş'i seçin.

Sorgu dizesi

Mağazadan teslim alım özelliğinin etkinleştirildiği konumları almak için örnek sorgu:

pickup_in_store:enabled

pickup_in_store değişkeni, Konum sorgusu üzerinde bulunan bir filtredir ve bir defadan fazla kullanılabilir veya diğer değişkenlerle birleştirilebilir.

Veri sorgusu yaparken şunları bilmek faydalıdır:

Mevcut konum filtrelerinin listesi
Sorgular belirli bir sözdizimine sahip olmalıdır
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 konumların bir listesini içeren Konum verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de işlemlerde kullanabilirsiniz. Örneğin, konumların listesini aşağıda gösterildiği gibi Dahili e-posta gönder işlemiyle gönderebilirsiniz:

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

Tetikleyiciler

Bu işlemi, Planlanan zaman tetikleyicisi de dahil olmak üzere herhangi bir iş akışında kullanabilirsiniz. Planlanan zaman tetikleyicisini kullanan bir iş akışı, etkinlik sonucunda değil, belirttiğiniz zamanda başlatılır. Mağazanızdan veya iş akışını başlatan bir uygulamadan gelen belirli bir etkinlik olmadığından hiçbir veri otomatik olarak dahil edilmez.

API Referansı

Bu işlemde kullanılan API hakkında daha fazla bilgi için Konumlar sorgusuna bakın.