Dapatkan data kontrak langganan

Dalam aliran kerja yang menggunakan data kontrak langganan, anda boleh menggunakan tindakan Dapatkan data kontrak langganan untuk mengambil maklumat kontrak langganan daripada kedai anda.

Pada halaman ini

Konfigurasi

Medan

Tindakan Dapatkan data kontrak langganan mengandungi medan yang berikut, yang digunakan untuk membina pertanyaan:

Medan yang digunakan dalam tindakan Dapatkan data.
Medan	Penerangan
Isih data mengikut	Diperlukan. Parameter yang digunakan untuk mengisih data yang dikembalikan oleh pertanyaan carian.
Bilangan maksimum hasil	Diperlukan. Jumlah maksimum hasil yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan sehingga 100 pada satu masa.
Pertanyaan	Diperlukan. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk mencipta pertanyaan anda sendiri.

Rentetan Pertanyaan

Ini ialah contoh pertanyaan untuk mendapatkan kontrak langganan yang berstatus ACTIVE:

status: ACTIVE

Pemboleh ubah status ialah penapis yang tersedia pada Pertanyaan kontrak langganan dan boleh digunakan beberapa kali.

Apabila membuat pertanyaan data, perkara berikut berguna untuk diketahui:

Senarai penapis yang tersedia
Pertanyaan mesti mengikut sintaks tertentu
Nilai medan pertanyaan tidak semestinya didokumentasikan. Dalam sesetengah kes, nilai tersebut boleh didapati dengan melihat dokumen API. Sebagai alternatif, anda juga selalunya boleh mencari nilai medan dalam URL pada panel pentadbir apabila anda membuat penapisan. Contohnya, untuk mencari beberapa nilai pertanyaan Pesanan, tapis halaman Pesanan dalam panel pentadbir, dan kemudian semak URL.
Anda boleh menjalankan atau menguji pertanyaan di kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
Berhati-hati dengan perkara yang berlaku jika pertanyaan anda gagal. API selalunya akan mengembalikan semua hasil (bukan tiada hasil).

Data dikembalikan

Semua tindakan Dapatkan data mengembalikan senarai dengan mana-mana antara 0 dan 100 sumber. Bergantung pada kes penggunaan anda, anda mungkin ingin menggunakan data ini dalam pelbagai cara:

Jika anda perlu mengendalikan setiap item senarai secara berasingan, seperti untuk menambah tag bagi setiap item, maka anda boleh menggunakan tindakan Untuk setiap.
Jika anda perlu mengagregat data, seperti mengira bilangan hasil yang dikembalikan, maka anda boleh menggunakan tindakan Kira atau Jumlah.
Jika anda perlu mengeluarkan senarai tersebut, seperti menghantar e-mel yang mengandungi semua item, maka anda boleh menggunakan data yang dikembalikan secara terus dalam tindakan yang seterusnya.

Untuk mengakses data yang dikembalikan dalam langkah yang mengikuti tindakan ini, gunakan pemboleh ubah bernama Dapatkan data kontrak langganan, iaitu senarai kontrak langganan. Anda boleh menggunakan pemboleh ubah ini dalam keadaan dan tindakan. Contohnya, anda boleh menghantar senarai pesanan dalam tindakan Hantar e-mel dalaman seperti ini:

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

Pencetus

Anda boleh menggunakan tindakan ini dalam mana-mana aliran kerja, termasuk pencetus Masa dijadualkan. Dalam aliran kerja yang menggunakan pencetus Masa dijadualkan, aliran kerja bermula pada masa yang telah anda tetapkan, dan bukannya hasil daripada peristiwa. Oleh sebab tiada peristiwa khusus dalam kedai anda atau daripada aplikasi yang memulakan aliran kerja tersebut, tiada data yang disertakan secara automatik.