Sayfa verilerini al

Sayfa verileri gerektiren iş akışlarında, mağazanızdan sayfa bilgilerini almak için Sayfa verilerini al eylemini kullanabilirsiniz. Sayfalar, online mağazanızda bulunan ve Hakkımızda sayfası veya İletişim sayfası gibi nadiren değişen bilgileri içeren web sayfalarıdır.

Not

Bu, bir tür Veri al eylemidir. Bu eylem türünün Planlanan zaman tetikleyicisi ve Her biri için döngüleriyle nasıl kullanılacağını öğrenmek için Shopify Flow'da programlar, veri alma ve döngüsel iş akışları bölümüne bakın.

Yapılandırma

Alanlar

Sayfa 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ğı parametrelerdir.
Maksimum sonuç sayısı	Gerekli. Seçtiğiniz arama sorgusu tarafından döndürülebilecek maksimum sonuç miktarıdır. 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

Yayınlanan sayfaları almak için örnek bir sorgu aşağıda verilmiştir:

published_status:published

published_status değişkeni, Sayfalar sorgusunda kullanılabilen bir filtredir ve birden çok kez kullanılabilir veya diğer değişkenlerle birleştirilebilir.

Verileri sorgularken şunları bilmenizde yarar vardır:

• Kullanılabilir sayfa filtrelerinin listesi

• Sorgular belirli bir söz dizimini izlemelidir

• Sorgu alanı değerleri her zaman belgelenmez. Bazı durumlarda 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ş 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 sorguyu çalıştırabilir veya test edebilirsiniz.

• Sorgunuz başarısız olduğunda ne olacağına dikkat edin. Genellikle API (hiçbir sonuç döndürmemek yerine) tüm sonuçları döndürür.

Döndürülen veriler

Tüm Veri al eylemleri 0 ile 100 arasında kaynağın yer aldığı bir liste döndürür. Kullanım durumunuza bağlı olarak bu verileri çeşitli şekillerde kullanmak isteyebilirsiniz:

• Her birine etiket eklemek gibi liste öğelerini tek tek işlemeniz gerekirse Her biri için eylemini kullanabilirsiniz.
• Kaç sonucun döndürüldüğünü saymak gibi verileri bir araya getirmeniz gerekirse Say veya Topla eylemlerini kullanabilirsiniz.
• Tüm ürünlerin yer aldığı bir e-posta göndermek gibi işlemler için listeyi çıktı olarak vermeniz gerekirse 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 sayfalar listesi olan Sayfa verilerini al adlı değişkeni kullanın. Bu değişkeni hem koşullarda hem de eylemlerde kullanabilirsiniz. Örneğin, sayfaların listesini şuna benzer bir Dahili e-posta gönder eyleminde gönderebilirsiniz:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Not

Tek bir iş akışında Veri al eylemi 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 verilerin ilk değişkeni getOrderData ve ikinci değişken getOrderData1 olur. Bu ad özelleştirilemez.

Tetikleyiciler

Bu eylemi, Planlanan zaman tetikleyicisi de dahil olmak üzere dilediğiniz iş akışında kullanabilirsiniz. Planlanan zaman tetikleyicisini kullanan bir iş akışı, bir olayın sonucu olarak değil, belirttiğiniz bir zamanda başlar. Mağazanızda veya bir uygulamada iş akışını başlatan belirli bir olay olmadığı için veriler otomatik olarak dahil edilmez.

API referansı

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