JSON, קיצור של JavaScript Object Notation (פורמט אובייקטים של JavaScript), הוא פורמט לאחסון והעברת נתונים. ברוב עמודי המשאבים ב-Shopify admin, כמו OrdersOrders / הזמנותהזמנות בחנות Shopify, כולל פרטי לקוח, מוצרים, תשלום, משלוח וסטטוס טיפול.פתיחה במילון, Products ו-Customers, אפשר לגשת לנתונים מפורטים יותר באמצעות JSON.
לא חייבים להיות מפתחים כדי להיעזר ב-JSON. לפעמים אפשר להשתמש בו כדי לאתר Variant ID (מזהה וריאנט) למעבר נתונים או התאמות Theme codeTheme code / קוד תבניתקוד התבנית של Shopify, לרוב Liquid, שמשפיע על תצוגת החנות.פתיחה במילון, או לבדוק Data variable (משתנה נתונים) לבניית Workflow (תהליך אוטומטי) ב-Shopify Flow.
במדריך הזה
- עיצוב JSON לקריאה
- גישה לקבצי JSON באדמין
- הצגת שדות ספציפיים
- משאבי JSON נוספים
- Properties נפוצים לפתרון בעיות
- Metafields ו-Events ב-JSON
עיצוב JSON לקריאה
Raw JSON (JSON גולמי) יכול להופיע כרצף ארוך של משתנים, סוגריים וקינון, ולכן קשה לקרוא אותו. כדי להפוך אותו לקריא יותר, אפשר להתקין JSON viewer extension (תוסף צפייה ב-JSON) בדפדפן, או להשתמש ב-Pretty-print (הדפסה יפה) שמובנה בדפדפנים מודרניים רבים.
גישה לקבצי JSON באדמין
Shopify admin מציג בדרך כלל את המידע השימושי ביותר בלבד, אבל נתונים נוספים נשמרים בקבצי .json של משאבים שונים. בדרך כלל אין צורך במידע הזה למשימות יומיומיות, אבל הוא יכול לעזור בבדיקה או פתרון בעיות.
דוגמה להזמנה:
- ב-Shopify admin עברו אל OrdersOrders / הזמנותהזמנות בחנות Shopify, כולל פרטי לקוח, מוצרים, תשלום, משלוח וסטטוס טיפול.פתיחה במילון.
- פתחו הזמנה כלשהי.
- בשורת הכתובת של הדפדפן הוסיפו
.jsonלסוף ה-URL, למשל:
https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json
- לחצו
Enterכדי לטעון את העמוד בפורמט JSON. - אופציונלי: הפעילו Pretty-print אם אין תוסף JSON viewer.
ב-JSON של הזמנה תראו מידע צפוי כמו "currency" ו-"line_items", לצד מידע מפורט יותר כמו "client_details" מסשן הדפדפן שבו הלקוח ביצע הזמנה.
הצגת שדות ספציפיים
אפשר להציג רק Properties (מאפיינים) מסוימים באמצעות ?fields= בסוף כתובת ה-JSON, ואז שמות המאפיינים מופרדים בפסיקים. לדוגמה, להצגת מזהה הזמנה, לקוח, מחיר ותגיות:
https://admin.shopify.com/store/{example-shop-name}/orders/12345678901234.json?fields=id,customer,total_price,tags
משאבי JSON נוספים
- Product count (ספירת מוצרים): מוסיפים
/count.jsonלסוף URLURL / כתובת קישורכתובת קישור תקינה שנשמרת כשדה מובנה או כמטא-שדה.פתיחה במילון של רשימת Products, למשלhttps://admin.shopify.com/store/{example-shop-name}/products/count.json. - Transactions (עסקאות): מוסיפים
/transactions.jsonלסוף URLURL / כתובת קישורכתובת קישור תקינה שנשמרת כשדה מובנה או כמטא-שדה.פתיחה במילון של הזמנה כדי להציג מידע עסקאות. - Fulfillments (טיפולים בהזמנה): מוסיפים
/fulfillments.jsonלסוף URLURL / כתובת קישורכתובת קישור תקינה שנשמרת כשדה מובנה או כמטא-שדה.פתיחה במילון של הזמנה. - Abandoned checkouts (קופות נטושות): מוסיפים
.jsonלסוף URLURL / כתובת קישורכתובת קישור תקינה שנשמרת כשדה מובנה או כמטא-שדה.פתיחה במילון של Abandoned checkoutCheckout / תהליך תשלוםשלב התשלום שבו לקוח מזין פרטים, בוחר משלוח ומשלים רכישה.פתיחה במילון.
Properties נפוצים לפתרון בעיות
| משאב | Property | שימוש אפשרי |
|---|---|---|
| Product | "created_at" | מתי המוצר נוצר לראשונה |
| Product | "published_at" | מתי סטטוס המוצר הוגדר Active |
| Product | "updated_at" | מתי המוצר עודכן לאחרונה, כולל תיאור, כותרת, SEO או עדכוני מלאי |
| Variant | "created_at" / "updated_at" | מתי הווריאנט נוצר או עודכן |
| Variant | "inventory_quantity" | ערך מלאי נוכחי שיכול להיות שלילי אם אין מעקב או מותר oversell |
| Variant | "old_inventory_quantity" | ערך מלאי לפני עדכון אחרון |
| Order line item | "requires_shipping" | האם הפריט דרש משלוח בזמן ביצוע ההזמנה |
| Order line item | "taxable" | האם הפריט הוגדר כחייב במס בזמן ההזמנה |
| Order line item | "variant_inventory_management" | מי ניהל את המלאי, למשל shopify, ערך צד שלישי או null |
| Order line item | "fulfillable_quantity" | כמה מלאי עדיין שמור להשלמת ההזמנה |
| Order line item | "tax_lines" | פירוט מסים; בארה״ב יכול לכלול state, county ו-municipal |
| Customer | "created_at" / "updated_at" | מתי פרופיל הלקוח נוצר או עודכן |
MetafieldsMetafields / שדות מטאשדות מותאמים שמרחיבים את מודל הנתונים של Shopify מעבר לשדות המובנים.פתיחה במילון ו-Events ב-JSON
Metafields (שדות מטא) מאפשרים לשמור מידע מותאם למשאבי Shopify, כמו מפרטים, טבלאות מידות, קבצים להורדה, תאריכי השקה, תמונות או מספרי חלקים.
אפשר להוסיף /metafields.json לסוף URLURL / כתובת קישורכתובת קישור תקינה שנשמרת כשדה מובנה או כמטא-שדה.פתיחה במילון של משאב נתמך כדי לראות MetafieldsMetafields / שדות מטאשדות מותאמים שמרחיבים את מודל הנתונים של Shopify מעבר לשדות המובנים.פתיחה במילון. לדוגמה: Customer, Order, Page, Product, Variant, Store ו-Smart collectionCollection / קולקציהמונח Shopify שמשמעותו בעברית: קולקציה. ההקשר המדויק תלוי בעמוד או בתהליך שבו המונח מופיע.פתיחה במילון. Product image metafieldsMetafields / שדות מטאשדות מותאמים שמרחיבים את מודל הנתונים של Shopify מעבר לשדות המובנים.פתיחה במילון אפשר להוסיף רק דרך APIAPI / ממשק תכנות יישומיםממשק שמאפשר לאפליקציות ולמערכות חיצוניות לקרוא ולעדכן נתונים ב-Shopify.פתיחה במילון (ממשק תכנות יישומים).
Events (אירועים) נוצרים כאשר פעולות מתבצעות במשאבים, כמו יצירת פוסט, טיפול בהזמנה או הוספת מוצר. הם לא נרשמים בזמן אמת ויכולים לקחת כמה דקות להופיע.
אפשר להוסיף /events.json ל-Order או Product כדי לראות Events, או להשתמש ב-https://admin.shopify.com/store/{your-store-name}/events.json?limit=250 כדי לראות את 250 האירועים האחרונים בחנות.
שאלות נפוצות
האם כל פעולה זמינה גם במובייל וגם בדסקטופ?
לא. Shopify מציינת שבחלק מהעמודים קיימים הבדלים בין Desktop (מחשב) ל-Mobile (מובייל), ובחלק מהפעולות נדרש דפדפן או Shopify admin מלא.
מה לבדוק לפני שמבצעים פעולה מרובה או שינוי באדמין?
בדקו הרשאות, מסננים, בחירה של הפריטים הנכונים, השפעה על לקוחות ומלאי, ושמרו תיעוד מתאים ב-Timeline (ציר זמן) או ביומני הפעילות כאשר רלוונטי.