JSON, קיצור של JavaScript Object Notation (פורמט אובייקטים של JavaScript), הוא פורמט לאחסון והעברת נתונים. ברוב עמודי המשאבים ב-Shopify admin, כמו OrdersOrders / הזמנותOrders (הזמנות) הוא המסך המרכזי ב-Shopify Admin של Shopify (שופיפיי) שבו רואים, מנהלים ומעבדים את כל הזמנות החנות — מרגע שנוצרו ועד שנשלחו וסגורות.פתיחה במילון, Products ו-Customers, אפשר לגשת לנתונים מפורטים יותר באמצעות JSON.
לא חייבים להיות מפתחים כדי להיעזר ב-JSON. לפעמים אפשר להשתמש בו כדי לאתר Variant ID (מזהה וריאנט) למעבר נתונים או התאמות Theme codeTheme code / קוד תבניתTheme code (קוד תבנית) הוא עריכה ישירה של קובצי ה-Liquid, CSS וה-JavaScript שמרכיבים תבנית ב-Shopify (שופיפיי) — בניגוד לשינויים ויזואליים דרך עורך התבנית הגרפי.פתיחה במילון, או לבדוק 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 / הזמנותOrders (הזמנות) הוא המסך המרכזי ב-Shopify Admin של 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 / כתובת קישורURL (כתובת קישור) היא הכתובת הייחודית של כל עמוד, מוצר, קולקציה או משאב בחנות Shopify (שופיפיי) — מה שמופיע בשורת הדפדפן ומשמש לניווט, שיתוף, ו-SEO.פתיחה במילון של רשימת Products, למשלhttps://admin.shopify.com/store/{example-shop-name}/products/count.json. - Transactions (עסקאות): מוסיפים
/transactions.jsonלסוף URLURL / כתובת קישורURL (כתובת קישור) היא הכתובת הייחודית של כל עמוד, מוצר, קולקציה או משאב בחנות Shopify (שופיפיי) — מה שמופיע בשורת הדפדפן ומשמש לניווט, שיתוף, ו-SEO.פתיחה במילון של הזמנה כדי להציג מידע עסקאות. - Fulfillments (טיפולים בהזמנה): מוסיפים
/fulfillments.jsonלסוף URLURL / כתובת קישורURL (כתובת קישור) היא הכתובת הייחודית של כל עמוד, מוצר, קולקציה או משאב בחנות Shopify (שופיפיי) — מה שמופיע בשורת הדפדפן ומשמש לניווט, שיתוף, ו-SEO.פתיחה במילון של הזמנה. - Abandoned checkouts (קופות נטושות): מוסיפים
.jsonלסוף URLURL / כתובת קישורURL (כתובת קישור) היא הכתובת הייחודית של כל עמוד, מוצר, קולקציה או משאב בחנות Shopify (שופיפיי) — מה שמופיע בשורת הדפדפן ומשמש לניווט, שיתוף, ו-SEO.פתיחה במילון של Abandoned checkoutCheckout / קופהCheckout (קופה) הוא תהליך התשלום בחנות Shopify (שופיפיי) — שלושת המסכים שמובילים את הלקוח מהעגלה דרך פרטי משלוח ותשלום ועד לעמוד אישור ההזמנה.פתיחה במילון.
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" | מתי פרופיל הלקוח נוצר או עודכן |
Metafields ו-Events ב-JSON
Metafields (שדות מטא) מאפשרים לשמור מידע מותאם למשאבי Shopify (שופיפיי), כמו מפרטים, טבלאות מידות, קבצים להורדה, תאריכי השקה, תמונות או מספרי חלקים.
אפשר להוסיף /metafields.json לסוף URLURL / כתובת קישורURL (כתובת קישור) היא הכתובת הייחודית של כל עמוד, מוצר, קולקציה או משאב בחנות Shopify (שופיפיי) — מה שמופיע בשורת הדפדפן ומשמש לניווט, שיתוף, ו-SEO.פתיחה במילון של משאב נתמך כדי לראות MetafieldsMetafields / שדות מטאMetafields (שדות מטא) הוא הסעיף בחיפוש ובאדמין של Shopify (שופיפיי) שמרכז את ניהול כל הגדרות המטא-שדות של החנות — הגדרת שדות חדשים, עריכת ערכים קיימים, ומעקב אחרי namespace ו-key.פתיחה במילון. לדוגמה: Customer, Order, Page, Product, Variant, Store ו-Smart collectionCollection / קולקציהCollection (קולקציה) היא קבוצת מוצרים מאורגנת בחנות Shopify (שופיפיי) — יכולה להיות ידנית (בחירה פרטנית) או אוטומטית (לפי תנאים כמו תג, מחיר או ספק).פתיחה במילון. Product image metafieldsMetafields / שדות מטאMetafields (שדות מטא) הוא הסעיף בחיפוש ובאדמין של Shopify (שופיפיי) שמרכז את ניהול כל הגדרות המטא-שדות של החנות — הגדרת שדות חדשים, עריכת ערכים קיימים, ומעקב אחרי namespace ו-key.פתיחה במילון אפשר להוסיף רק דרך APIAPI / ממשק תכנות יישומיםAPI (Application Programming Interface) הוא ממשק שמאפשר לאפליקציות ולמערכות חיצוניות לתקשר עם 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 (ציר זמן) או ביומני הפעילות כאשר רלוונטי.