Preluare date card cadou

În fluxurile de lucru care necesită date despre carduri cadou, puteți utiliza acțiunea Preluare date card cadou pentru a recupera informațiile despre cardurile cadou din magazinul dumneavoastră.

Este important de reținut că magazinul dumneavoastră are atât produse de tip card cadou, care sunt utilizate pentru a genera carduri cadou, cât și cardurile cadou propriu-zise, care sunt cardurile cadou pe care clienții le pot utiliza pentru a face achiziții. Acțiunea Preluare date card cadou recuperează informații despre cardurile cadou propriu-zise. Pentru a obține informații despre produsele de tip card cadou, utilizați acțiunile Preluare date produs sau Preluare date variantă de produs.

Configurare

Câmpuri

Acțiunea Preluare date card cadou conține următoarele câmpuri, care sunt utilizate pentru a construi interogarea:

Șir de interogare

Acesta este un exemplu de interogare pentru obținerea cardurilor cadou care au fost actualizate în ultima zi:

created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Variabila created_at este un filtru disponibil în interogarea pentru carduri cadou și poate fi utilizată de mai multe ori sau combinată cu alte variabile. Variabila Liquid scheduledAt este disponibilă în fluxurile de lucru care au utilizat declanșatorul Oră programată. Eticheta Liquid date_minus este o etichetă specială Flow, care vă permite să scădeți timp dintr-o dată.

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

• Listă de filtre disponibile pentru cardurile cadou

• 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 deseori valorile câmpurilor în URL-urile din panoul de administrare atunci când filtrați. De exemplu, pentru a găsi unele valori pentru interogarea comenzilor, filtrați pagina Comenzi în panoul de administrare și apoi verificați URL-ul.

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

• Fiți atenți la ce se întâmplă dacă interogarea dvs. eșuează. Deseori, API-ul va returna toate rezultatele (în loc de niciunul).

Date returnate

Toate acțiunile de obținere a datelor returnează o listă de la 0 la 100 de resurse. În funcție de cazul dvs. de utilizare, poate doriți să utilizați aceste date în diverse moduri:

• Dacă trebuie să gestionați fiecare articol din listă în mod individual, cum ar fi să adăugați o etichetă pentru fiecare, atunci puteți utiliza acțiunea Pentru fiecare.
• Dacă trebuie să cumulați date, cum ar fi să numărați câte rezultate au fost returnate, atunci puteți utiliza acțiunile Numărare sau Sumă.
• Dacă trebuie să extrageți lista, cum ar fi să trimiteți un e-mail cu toate articolele, atunci 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ținere date card cadou, care este o listă de carduri cadou. Puteți utiliza această variabilă atât în condiții, cât și în acțiuni. De exemplu, puteți trimite lista de carduri cadou într-o acțiune Trimitere e-mail intern, astfel:

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.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 pornește la o oră specificată de dvs., mai degrabă decât ca rezultat al unui eveniment. Deoarece nu există niciun eveniment specific în magazinul dvs. sau dintr-o aplicație care să pornească fluxul de lucru, nu sunt incluse automat date.

Detalii API

• Resursă card cadou
• Filtre de interogare pentru cardurile cadou