סקירה כללית על CSS API
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אתם יכולים להשתמש ב-CSS API כדי לנהל את שירות ה-CSS ולשלוט בתיק המוצרים של שירות ה-CSS.
CSS API הוא עיצוב מחדש של תכונות ה-CSS ב-Content API for Shopping.
CSS API לעומת Merchant API
כדי לנהל את המוצרים בצורה יעילה, חשוב להבין את ההבדל בין CSS API לבין Merchant API. לכל API יש מטרה שונה, והוא פועל על סוגים שונים של חשבונות ומרחבי מזהים:
CSS API (גרסה 1): אפשר להשתמש ב-API הזה לכל הפונקציות שקשורות לניהול חשבונות CSS ולמוצרי CSS משויכים. ה-API הזה משתמש בשם המארח css.googleapis.com ודורש מזהה דומיין CSS לפעולות שקשורות למוצרים.
- לדוגמה:
POST https://css.googleapis.com/v1/accounts/{cssDomainId}/cssProductInputs:insert
Merchant API
(v1): משתמשים ב-API הזה לכל הפונקציות שקשורות לחשבונות Merchant Center רגילים ולמוצרים שלהם. ה-API הזה משתמש בשם המארח merchantapi.googleapis.com ודורש מזהה Merchant Center רגיל.
- לדוגמה:
POST https://merchantapi.googleapis.com/v1/accounts/{merchantId}/productInputs:insert
הנקודה העיקרית: אל תשתמשו במזהה דומיין של שירות CSS עם נקודות קצה של מוצרים ב-Merchant API, ואל תשתמשו במזהה של חשבון Merchant Center עם נקודות קצה של מוצרים ב-CSS API. שימוש במזהה שגוי עם API שגוי יוביל לשגיאות.
השילוב של CSS API ו-Merchant API מחליף את Content API for Shopping (גרסה 2.1) הישן, שכבר לא מומלץ להשתמש בו.
ריכזנו כאן כמה סיבות לשדרוג ל-CSS API:
מידע נוסף זמין במאמר תחילת העבודה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-13 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-13 (שעון UTC)."],[[["\u003cp\u003eThe CSS API enables managing CSS and controlling your CSS Products portfolio.\u003c/p\u003e\n"],["\u003cp\u003eThe CSS API offers new features, improved alignment with Google's API improvement proposals, and updated documentation and samples.\u003c/p\u003e\n"],["\u003cp\u003eUpgrading from the Content API for Shopping to the CSS API is recommended.\u003c/p\u003e\n"]]],[],null,["# CSS API overview\n\nYou can use the CSS API to manage your CSS and control your CSS Products\nportfolio.\n\nThe CSS API is a redesign of the CSS features in [Content API for\nShopping](/shopping-content).\n\nCSS API versus Merchant API\n---------------------------\n\nUnderstanding the distinction between the CSS API and the Merchant API is key\nto effectively managing your products. Each API serves a different purpose and\noperates on different account types and ID spaces:\n\n- **CSS API (v1):** Use this API for all functionalities related to managing\n CSS accounts and their associated CSS products. This API uses the\n `css.googleapis.com` hostname and requires a **CSS Domain ID** for product\n operations.\n\n - Example: `POST https://css.googleapis.com/v1/accounts/{cssDomainId}/cssProductInputs:insert`\n- **[Merchant API](https://developers.google.com/merchant/api/overview)\n (v1):** Use this API for all functionalities related to\n standard Merchant Center accounts and their products. This API uses the\n `merchantapi.googleapis.com` hostname and requires a standard **Merchant\n Center ID**.\n\n - Example: `POST https://merchantapi.googleapis.com/v1/accounts/{merchantId}/productInputs:insert`\n\n**Key takeaway:** Don't use a CSS Domain ID with the Merchant API for product\nendpoints, and don't use a Merchant Center ID with the CSS API product\nendpoints. Using the wrong ID with the wrong API will result in errors.\n\nThe CSS API and Merchant API together replace the older Content API for Shopping\n(v2.1), which should no longer be used.\n\nHere are some reasons to upgrade to the CSS API:\n\n- New features.\n- Improved alignment with Google's [API improvement proposals](//google.aip.dev/).\n- Updated documentation and [samples](/comparison-shopping-services/api/code-samples).\n\nSee [Get started](/comparison-shopping-services/api/guides/quickstart) for more\ninformation."]]
