קבלת נתוני שוק

בזרימות עבודה שדורשות נתוני שוק, אפשר להשתמש בפעולה קבלת נתוני שוק כדי לאחזר מידע על שווקים מחנות ה-Shopify שלך. שווקים הם קבוצות של אזורים או מיקומים המהווים יעד למכירות.

תצורה

שדות

הפעולה קבלת נתוני שוק כוללת את השדות הבאים:

מחרוזת שאילתה

זוהי שאילתה לדוגמה לקבלת כל השווקים הפעילים:

status:ACTIVE

המשתנה status הוא מסנן שזמין בשאילתת שווקים וניתן להשתמש בו מספר פעמים או לשלב אותו עם משתנים אחרים.

בעת יצירת שאילתת נתונים, כדאי לדעת את הדברים הבאים:

• רשימה של מסנני שווקים זמינים

• שאילתות חייבות להיכתב בתחביר מסוים

• ערכי השדות בשאילתות אינם תמיד מתועדים. במקרים מסוימים, ניתן למצוא את הערכים דרך עיון בתיעוד ה-API. לחלופין, לרוב אפשר למצוא את ערכי השדות בכתובות ה-URL בלוח המנהל בעת סינון. לדוגמה, כדי למצוא ערכים מסוימים בשאילתות של הזמנות, ניתן לסנן את הדף 'הזמנות' בלוח המנהל, ולאחר מכן לבדוק את כתובת ה-URL.

• אפשר להפעיל או לבדוק שאילתה בחנות על ידי שימוש באפליקציית Shopify GraphiQL.

• שימו לב למה שקורה אם השאילתה נכשלת. לרוב, ה-API יחזיר את כל התוצאות (במקום אף תוצאה).

נתונים שהוחזרו

כל הפעולות מסוג קבלת נתונים מחזירות רשימה שכוללת בין 0 ל-100 משאבים. בהתאם למקרה השימוש הספציפי, ייתכן שתרצו להשתמש בנתונים אלו בדרכים שונות:

• אם יש צורך לטפל בכל פריט ברשימה בנפרד, לדוגמה כדי להוסיף תג לכל אחד מהם, ניתן להשתמש בפעולה עבור כל.
• אם יש צורך לצבור נתונים, למשל כדי לספור כמה תוצאות הוחזרו, ניתן להשתמש בפעולות ספירה או סכום.
• אם יש צורך בפלט של הרשימה, למשל כדי לשלוח דוא"ל עם כל הפריטים, ניתן להשתמש בנתונים שהוחזרו ישירות בפעולות הבאות.

כדי לגשת לנתונים שהוחזרו בשלבים הבאים אחרי פעולה זו, יש להשתמש במשתנה שנקרא קבלת נתוני שוק, שהוא רשימת השווקים. ניתן להשתמש במשתנה זה גם בתנאים וגם בפעולות. לדוגמה, אפשר לשלוח את רשימת השווקים באמצעות הפעולה שליחת דוא"ל פנימי בצורה כזו:

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

טריגרים

אפשר להשתמש בפעולה זו בכל זרימת עבודה, כולל באמצעות הטריגר מועד מתוזמן. בזרימת עבודה שמשתמשת בטריגר מועד מתוזמן, זרימת העבודה מתחילה במועד שהוגדר, ולא כתוצאה מאירוע. מכיוון שאין אירוע מסוים בחנות או מתוך אפליקציה שמתחיל את זרימת העבודה, לא נכללים נתונים באופן אוטומטי.

סימוכין ל-API

לקבלת מידע נוסף על ה-API שבו נעשה שימוש בפעולה זו, ראו שאילתת שווקים.