קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
ה-API המשני Products מאפשר לכם לנהל באופן פרוגרמטי את מלאי המוצרים שלכם ב-Google Merchant Center. אתם יכולים ליצור, לאחזר, לעדכן ולמחוק מוצרים, וכך לשלב את המערכות שלכם ישירות עם Google.
מושג מרכזי ב-Merchant API הוא ההבחנה בין הנתונים שאתם שולחים לבין המוצר הסופי שבו Google משתמשת. ההפרדה הזו מספקת מודל ברור יותר של מחזור החיים של נתוני המוצרים, ומאפשרת לכם שליטה מדויקת יותר בפרטי המוצרים. ממשק ה-API משקף את זה באמצעות שני משאבים עיקריים:
ProductInput:
הנתונים האלה מייצגים את נתוני המוצרים הגולמיים שאתם שולחים למקור נתונים ספציפי.
אפשר לחשוב על זה כעל השורה שמעלים בקובץ פיד או כעל הנתונים ששולחים באמצעות קריאה ל-API לפני שמתבצע עיבוד ב-Merchant Center. משתמשים במשאב הזה לכל פעולות הכתיבה (insert, patch, delete).
Product:
זהו מקור מידע לקריאה בלבד שמייצג את המוצר הסופי שעבר עיבוד, כפי שהוא מופיע ב-Merchant Center ובפלטפורמות של Google. הוא נוצר מProductInput משאב ראשי אחד ומאפס משאבים משלימים או יותר ProductInput אחרי שכל כללי הפיד והעיבוד הוחלו. במקור המידע הזה מופיעים הסטטוס הסופי של המוצר ובעיות באיכות הנתונים.
משתמשים במשאב הזה לכל פעולות הקריאה (get, list).
הפורמט והדרישות של כל מאפייני המוצרים שנשלחים באמצעות משאב ProductInput מוגדרים במפרט נתוני המוצרים.
מה אפשר לעשות עם ה-API המשני Products
באמצעות ה-API המשני Products, אפשר לבצע את המשימות העיקריות הבאות. במדריכים אפשר למצוא הוראות מפורטות ודוגמאות קוד לכל תרחיש לדוגמה.
הוספה וניהול של מוצרים: כאן מוסבר איך להוסיף מוצרים חדשים לחשבון, לספק נתונים משלימים למוצרים קיימים ולמחוק מוצרים שכבר לא נמכרים.
עדכונים תכופים של המוצרים: כאן מוסבר איך לבצע עדכונים חלקיים ויעילים של מאפייני מוצרים שמשתנים לעיתים קרובות, כמו מחיר וזמינות.
רשימת נתוני המוצרים ובעיות במוצרים: כאן אפשר לראות איך לאחזר את המוצרים שעברו עיבוד, לבדוק את סטטוס האישור שלהם ביעדים שונים ולזהות בעיות באיכות הנתונים שעלולות להשפיע על החשיפה שלהם.
לפני שמתחילים
לפני שמשתמשים ב-Products sub-API, צריך ליצור לפחות מקור נתונים אחד של API בחשבון Merchant Center. אפשר להשתמש ב-Products sub-API רק כדי להוסיף או לעדכן מוצרים במקורות נתונים מסוג API. הוראות מפורטות מופיעות במדריך בנושא ניהול מקורות נתונים של API להעלאות מוצרים.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-22 (שעון UTC)."],[[["\u003cp\u003eThe Merchant Products API allows you to programmatically manage your product data, including inserting, updating, retrieving, and deleting products.\u003c/p\u003e\n"],["\u003cp\u003eProducts are managed through two key resources: \u003ccode\u003eproductInputs\u003c/code\u003e (representing input data) and \u003ccode\u003eproducts\u003c/code\u003e (representing processed products in the Shopping database).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eproductInputs\u003c/code\u003e can be primary or supplementary and are used to construct the final \u003ccode\u003eproduct\u003c/code\u003e that appears in your online or local store catalogs.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers advantages over file-based uploads, such as faster response times and real-time updates.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, ensure you have a data source set up and are familiar with Shopping Ads and free listings policies.\u003c/p\u003e\n"]]],["The Merchant Products API allows programmatic product data management via `productInputs` and `products` resources. Actions include inserting `productInput` data with required fields like `channel`, `offerId`, `contentLanguage`, and `feedLabel` using `accounts.productInputs.insert`. Processed products can be retrieved using `accounts.products.get` and listed with `accounts.products.list`. Product inputs are deleted using `accounts.productInputs.delete`, specifying the data source. Products are built from primary and supplemental data sources, enabling real-time catalog management. You can use Batch mode to manage many products.\n"],null,[]]