קבלת נתוני הנחה
בזרימות עבודה שדורשות נתוני הנחה, תוכל להשתמש בפעולה קבלת נתוני הנחה כדי לאחזר מידע על הנחות מהחנות שלך.
תצורה
שדות
הפעולה קבלת נתוני הנחה מכילה את השדות הבאים, שמשמשים לבניית השאילתה:
| שדה | תיאור |
|---|---|
| מיון נתונים לפי | חובה. הפרמטרים שלפיהם ממוינים הנתונים שמוחזרים על ידי שאילתת החיפוש. |
| מספר תוצאות מרבי | חובה. הכמות המרבית של תוצאות שיכולות להיות מוחזרות על ידי שאילתת החיפוש שתבחר. באפשרותך לקבל בחזרה עד 100 תוצאות בכל פעם. |
| שאילתה | חובה. בחר מתוך שאילתות נפוצות או בחר מתקדם כדי ליצור שאילתה משלך. |
מחרוזת שאילתה
זוהי שאילתה לדוגמה לקבלת הנחות פעילות שמשתמשות בקוד:
method:code AND status:activeהמשתנים method ו-status הם מסננים שזמינים ב-שאילתת צומת הנחה וניתן להשתמש בהם מספר פעמים או לשלב אותם עם משתנים אחרים.
בעת ביצוע שאילתות לנתונים, כדאי לדעת:
- רשימה של מסנני הנחה זמינים.
- השאילתות חייבות להיות בהתאם ל-תחביר מסוים
- ערכי שדות שאילתה לא תמיד מתועדים. במקרים מסוימים, ניתן למצוא את הערכים על ידי עיון ב-תיעוד ה-API. לחלופין, לרוב תוכל למצוא את ערכי השדות בכתובות ה-URL במנהל כאשר אתה מסנן. לדוגמה, כדי למצוא ערכי שאילתת הזמנה כלשהם, סנן את הדף 'הזמנות' במנהל, ואז בדוק את כתובת ה-URL.
- באפשרותך להריץ או לבדוק שאילתה בחנות שלך באמצעות היישום Shopify GraphiQL.
- שים לב למה שקורה אם השאילתה שלך נכשלת. לעתים קרובות ה-API יחזיר את כל התוצאות (במקום אף תוצאה).
נתונים שהוחזרו
כל פעולות קבלת נתונים מחזירות רשימה של בין 0 ל-100 משאבים. בהתאם לתרחיש השימוש שלך, ייתכן שתרצה להשתמש בנתונים אלה בדרכים שונות:
- אם עליך לטפל בכל פריט ברשימה בנפרד, לדוגמה כדי להוסיף תג לכל פריט, תוכל להשתמש בפעולה For each.
- אם עליך לצבור נתונים, לדוגמה לספור כמה תוצאות הוחזרו, תוכל להשתמש בפעולות Count או Sum.
- אם עליך להפיק פלט של הרשימה, לדוגמה לשלוח דוא"ל עם כל הפריטים, תוכל להשתמש בנתונים שהוחזרו ישירות בפעולות הבאות.
כדי לגשת לנתונים שהוחזרו בשלבים שלאחר פעולה זו, השתמש במשתנה בשם קבלת נתוני הנחה, שהוא רשימה של הנחות. תוכל להשתמש במשתנה זה גם בתנאים וגם בפעולות. לדוגמה, תוכל לשלוח את רשימת הנחות היישום האוטומטיות בפעולה שלח דוא"ל פנימי כך:
{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
* {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}טריגרים
ניתן להשתמש בפעולה זו בכל זרימת עבודה, כולל הטריגר שעה מתוזמנת. בזרימת עבודה שמשתמשת בטריגר שעה מתוזמנת, זרימת העבודה מתחילה בשעה שציינת, ולא כתוצאה מאירוע. מאחר שאין אירוע ספציפי בחנות שלך או מיישום שמתחיל את זרימת העבודה, אין נתונים שנכללים באופן אוטומטי.
פרטי API
תבניות
שליחת סיכום שבועי בדוא"ל של הנחות פעילות שמשתמשות בקוד
שליחת סיכום בדוא"ל של הנחות פעילות שמשתמשות בקוד. זרימת העבודה פועלת לפי לוח זמנים בכל יום שני בשעה 9:00. ניתן להתאים אישית את זרימת העבודה כדי לשנות את התזמון, את האופן שבו מקבלים את הסיכום, את סוג ההנחות שברצונך לכלול ואת המצב. צפייה בתבנית