קבלת נתוני קבוצת תוכניות מכירה
בזרימות עבודה שדורשות נתונים של קבוצת תוכניות מכירה, אפשר להשתמש בפעולה קבלת נתוני קבוצת תוכניות מכירה כדי לאחזר מידע על הזמנות מהחנות שלך.
תצורה
שדות
הפעולה קבלת נתוני קבוצת תוכניות מכירה מכילה את השדות הבאים, שמשמשים לבניית השאילתה:
| שדה | תיאור |
|---|---|
| מיון נתונים לפי | חובה. הפרמטרים שלפיהם ממוינים הנתונים שמוחזרים על ידי שאילתת החיפוש. |
| מספר התוצאות המרבי | חובה. המספר המרבי של תוצאות שיכולות להיות מוחזרות משאילתת החיפוש שבחרת. אפשר להחזיר עד 100 בכל פעם. |
| שאילתה | חובה. אפשר לבחור מתוך שאילתות נפוצות או לבחור באפשרות מתקדם כדי ליצור שאילתה משלך. |
מחרוזת שאילתה
זוהי שאילתה לדוגמה לקבלת קבוצות תוכניות מכירה שעודכנו ביום האחרון:
name='Subscribe & Save'המשתנה category הוא מסנן שזמין בשאילתת קבוצת תוכניות מכירה ואפשר להשתמש בו כדי לבחור קטגוריות ספציפיות של קבוצות תוכניות מכירה.
בעת יצירת שאילתה לנתונים, כדאי לדעת:
- רשימה של מסננים זמינים עבור קבוצת תוכניות מכירה
- שאילתות חייבות להיות בהתאם לתחביר מסוים
- ערכי שדות של שאילתות אינם תמיד מתועדים. במקרים מסוימים, ניתן למצוא את הערכים על ידי עיון במסמכי ה-API. לחלופין, לעתים קרובות אפשר למצוא את ערכי השדות בכתובות ה-URL במנהל בזמן ביצוע סינון. לדוגמה, כדי למצוא ערכי שאילתה מסוימים של הזמנות, יש לסנן את דף ההזמנות במנהל, ולאחר מכן לבדוק את כתובת ה-URL.
- תוכל להפעיל או לבדוק שאילתה בחנות שלך באמצעות אפליקציית Shopify GraphiQL.
- כדאי לשים לב למה שקורה אם השאילתה נכשלת. לעתים קרובות ה-API יחזיר את כל התוצאות (במקום אף תוצאה).
נתונים שהוחזרו
כל הפעולות מסוג קבלת נתונים מחזירות רשימה שכוללת בין 0 ל-100 משאבים. בהתאם למקרה השימוש, ייתכן שתרצה להשתמש בנתונים אלה בדרכים שונות:
- אם עליך לטפל בכל פריט ברשימה בנפרד, למשל כדי להוסיף תג לכל אחד מהם, תוכל להשתמש בפעולה עבור כל.
- אם עליך לצבור נתונים, למשל כדי לספור כמה תוצאות הוחזרו, תוכל להשתמש בפעולות ספירה או סכום.
- אם עליך להפיק פלט של הרשימה, למשל כדי לשלוח דוא"ל עם כל הפריטים, תוכל להשתמש בנתונים שהוחזרו ישירות בפעולות הבאות.
כדי לגשת לנתונים שהוחזרו בשלבים שמגיעים לאחר פעולה זו, יש להשתמש במשתנה קבלת נתונים של קבוצת תוכניות מכירה, שהוא רשימה של קבוצות תוכניות מכירה. ניתן להשתמש במשתנה זה הן בתנאים והן בפעולות. לדוגמה, אפשר לשלוח את הרשימה של קבוצות תוכניות המכירה בפעולה שליחת דוא"ל פנימי באופן הבא:
{% for getSellingPlanGroupData_item in getSellingPlanGroupData %}
{{getSellingPlanGroupData_item.name}}
{% endfor %}דוגמה
לדוגמה, מתוזמנת זרימת עבודה לפעול בכל יום ראשון בשעה 9:00. נעשה שימוש בפעולה קבלת נתונים של קבוצת תוכניות מכירה לאיסוף נתונים עבור קבוצות תוכניות מכירה שנוצרו בשבוע האחרון. אם המוצרים שמשויכים לקבוצות תוכניות המכירה הם המוצרים הנמכרים ביותר שלך, ה-position של קבוצת תוכניות המכירה עשוי לעלות.