Obține date despre piață

În fluxurile de lucru care necesită date despre piețe, puteți utiliza acțiunea Obține date despre piață pentru a recupera informații despre piață din magazinul dvs. Shopify. Piețele sunt grupuri de regiuni sau locații pe care le vizați pentru vânzări.

Configurare

Câmpuri

Acțiunea Obține date despre piață conține următoarele câmpuri:

Câmpuri utilizate în acțiunile de obținere a datelor.
CâmpDescriere
Sortează datele dupăObligatoriu. Parametrii după care sunt sortate datele returnate de interogarea de căutare.
Numărul maxim de rezultateObligatoriu. Numărul maxim de rezultate care poate fi returnat de interogarea de căutare pe care o selectați. Puteți returna până la 100 de rezultate simultan.
InterogareObligatoriu. Alegeți dintre interogările obișnuite sau selectați Avansat pentru a crea una proprie.

Șir de interogare

Acesta este un exemplu de interogare pentru obținerea tuturor piețelor active:

status:ACTIVE

Variabila status este un filtru disponibil în interogarea piețelor și poate fi utilizată de mai multe ori sau combinată cu alte variabile.

Când interogați date, este util să știți următoarele:

  • Lista filtrelor de piață disponibile

  • Interogările trebuie să respecte o anumită sintaxă

  • Valorile câmpurilor de interogare nu sunt întotdeauna documentate. În unele cazuri, valorile pot fi găsite consultând documentația API. Alternativ, puteți găsi adesea valorile câmpurilor în adresele URL din panoul de administrare atunci când aplicați filtre. De exemplu, pentru a găsi anumite valori pentru interogarea comenzilor, filtrați pagina Comenzi din panoul de administrare, apoi verificați adresa URL.

  • Puteți rula sau testa o interogare în magazinul dumneavoastră utilizând aplicația Shopify GraphiQL.

  • Țineți cont de ceea ce se întâmplă dacă interogarea dumneavoastră eșuează. Adesea, API-ul va returna toate rezultatele (în loc de niciunul).

Date returnate

Toate acțiunile de Obținere date returnează o listă cuprinsă între 0 și 100 de resurse. În funcție de cazul dumneavoastră de utilizare, este posibil să doriți să utilizați aceste date în diferite moduri:

  • Dacă trebuie să gestionați individual fiecare articol din listă, de exemplu, pentru a adăuga o etichetă pentru fiecare, atunci puteți utiliza acțiunea Pentru fiecare.
  • Dacă trebuie să agregați date, cum ar fi să numărați câte rezultate au fost returnate, puteți utiliza acțiunile Numără sau Sumează.
  • Dacă trebuie să redați lista, de exemplu, să trimiteți un e-mail cu toate articolele, puteți utiliza datele returnate direct în acțiunile ulterioare.

Pentru a accesa datele returnate în pașii care urmează acestei acțiuni, utilizați variabila denumită Obține date despre piață, care este o listă de piețe. Puteți utiliza această variabilă atât în condiții, cât și în acțiuni. De exemplu, puteți trimite lista de piețe într-o acțiune Trimite un e-mail intern similară cu aceasta:

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

Declanșatoare

Puteți utiliza această acțiune în orice flux de lucru, inclusiv cu declanșatorul Oră programată. Într-un flux de lucru care utilizează declanșatorul Oră programată, fluxul de lucru începe la o oră specificată de dumneavoastră, mai degrabă decât ca rezultat al unui eveniment. Deoarece nu există niciun eveniment specific în magazinul dumneavoastră sau de la o aplicație care să pornească fluxul de lucru, nu sunt incluse automat date.

Referință API

Pentru mai multe informații despre API-ul utilizat în această acțiune, consultați interogarea piețelor.